Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Paquetes e imágenes para piscinas WorkSpaces
Un *WorkSpace paquete* es una combinación de un sistema operativo y recursos de almacenamiento, cómputo y software. Al lanzar un paquete WorkSpace, selecciona el paquete que mejor se adapte a sus necesidades. Los paquetes predeterminados para los que están disponibles WorkSpaces se denominan *paquetes públicos*. Para obtener más información sobre los distintos paquetes públicos disponibles WorkSpaces, consulta [Amazon WorkSpaces Bundles](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles).
Si has lanzado un Windows WorkSpace y lo has personalizado, puedes crear una imagen personalizada a partir de él WorkSpace para usarla con WorkSpaces Pool. WorkSpaces Pool no admite Linux.
Una *imagen personalizada* contiene solo el sistema operativo, el software y la configuración del WorkSpace. Un *paquete personalizado* es una combinación de esa imagen personalizada y del hardware desde el que se WorkSpace puede lanzar una.
Tras crear una imagen personalizada, puede crear un paquete personalizado que combine la WorkSpace imagen personalizada y la configuración de almacenamiento e informática subyacente que seleccione. A continuación, puede especificar este paquete personalizado al crear nuevos WorkSpaces grupos para asegurarse de que los nuevos WorkSpaces del grupo tengan la misma configuración coherente (hardware y software).
Si necesita realizar actualizaciones de software o instalar software adicional en el suyo WorkSpaces, puede actualizar su paquete personalizado y usarlo para reconstruirlo WorkSpaces.
WorkSpaces Pools admite varios sistemas operativos (OS), protocolos de transmisión y paquetes diferentes. En la siguiente tabla se proporciona información sobre las licencias, los protocolos de transmisión y los paquetes compatibles con cada sistema operativo.
| Sistema operativo | Licencias | Protocolos de transmisión | Paquetes compatibles | Política del ciclo de vida o fecha de retirada |
| --- | --- | --- | --- | --- |
| Windows Server 2019 | Incluido | DCV | Valor, estándar, rendimiento, potencia, PowerPro | [9 de enero de 2029](https://learn.microsoft.com/en-us/lifecycle/products/windows-server-2019) |
| Windows Server 2022 | Incluido | DCV | Estándar, rendimiento, potencia, gráficos. PowerPro G4dn, .G4dn GraphicsPro | [14 de octubre de 2031](https://learn.microsoft.com/en-us/lifecycle/products/windows-server-2022) |
**nota**
No se garantiza que las versiones del sistema operativo que el vendedor ya no admite funcionen ni cuentan con soporte técnico. AWS
**Topics**
+ [Opciones de paquetes en WorkSpaces Pools](pools-custom-images-bundles.md)
+ [Cree una imagen y un paquete personalizados para WorkSpaces piscinas](pools-images-custom-image.md)
+ [Administra imágenes y paquetes personalizados para piscinas WorkSpaces](pools-images-managing.md)
+ [Uso de scripts de sesión para administrar la experiencia de transmisión de los usuarios](pools-images-session-scripts.md)
# Opciones de paquetes en WorkSpaces Pools
Antes de seleccionar un paquete para utilizar con WorkSpaces Pools, asegúrese de que dicho paquete sea compatible con el protocolo, el sistema operativo, la red y el tipo de computación de los escritorios de WorkSpaces. Recomendamos probar el rendimiento de los paquetes que desee elegir en un entorno de prueba mediante la ejecución y el uso de aplicaciones que repliquen las tareas diarias de los usuarios. Para obtener más información sobre protocolos, consulte [Protocolos para WorkSpaces uso personal](amazon-workspaces-networking.md#amazon-workspaces-protocols). Para obtener más información sobre las redes, consulte [Requisitos de red de clientes de WorkSpaces Personal](workspaces-network-requirements.md).
Los siguientes paquetes públicos se pueden usar con WorkSpaces Pools. Para obtener más información sobre los paquetes disponibles en WorkSpaces, consulte [Paquetes de Amazon WorkSpaces](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles). Value, Standard, Performance, Power, PowerPro
## Paquete de valor
Este paquete está especialmente indicado para lo siguiente:
+ Edición básica de texto y entrada de datos
+ Navegación web con poco uso
+ Mensajería instantánea
Este paquete no se recomienda para el procesamiento de textos, las conferencias de audio y vídeo, el uso compartido de pantalla, las herramientas de desarrollo de software, las aplicaciones de inteligencia empresarial y las aplicaciones gráficas.
## Paquete estándar
Este paquete está especialmente indicado para lo siguiente:
+ Edición básica de texto y entrada de datos
+ Navegación web
+ Mensajería instantánea
+ Correo electrónico
Este paquete no se recomienda para las conferencias de audio y vídeo, el uso compartido de pantalla, el procesamiento de textos, las herramientas de desarrollo de software, las aplicaciones de inteligencia empresarial y las aplicaciones gráficas.
## Paquete de rendimiento
Este paquete está especialmente indicado para lo siguiente:
+ Navegación web
+ Procesamiento de textos
+ Mensajería instantánea
+ Correo electrónico
+ Hojas de cálculo
+ Procesamiento de audio
+ Material didáctico
Este paquete no se recomienda para las conferencias de vídeo, el uso compartido de pantalla, las herramientas de desarrollo de software, las aplicaciones de inteligencia empresarial y las aplicaciones gráficas.
## Paquete de energía
Este paquete está especialmente indicado para lo siguiente:
+ Navegación web
+ Procesamiento de textos
+ Correo electrónico
+ Mensajería instantánea
+ Hojas de cálculo
+ Procesamiento de audio
+ Desarrollo de software (entorno de desarrollo integrado (IDE)
+ Introducción al procesamiento de datos de nivel medio
+ Conferencias de audio y vídeo
Este paquete no se recomienda para el uso compartido de pantalla, las herramientas de desarrollo de software, las aplicaciones de inteligencia empresarial y las aplicaciones gráficas.
## Paquete PowerPro
Este paquete está especialmente indicado para lo siguiente:
+ Navegación web
+ Procesamiento de textos
+ Correo electrónico
+ Mensajería instantánea
+ Hojas de cálculo
+ Procesamiento de audio
+ Desarrollo de software (entorno de desarrollo integrado (IDE)
+ Almacenes de datos
+ Aplicaciones de inteligencia empresarial
+ Conferencias de audio y vídeo
Este paquete no se recomienda para el machine learning, el entrenamiento de modelos y las aplicaciones gráficas.
## Paquete Graphics.G4DN
Este paquete ofrece un nivel alto de rendimiento gráfico y un nivel moderado de rendimiento de CPU y memoria para sus WorkSpaces. Está especialmente indicado para lo siguiente:
+ Navegación web
+ Procesamiento de textos
+ Correo electrónico
+ Hojas de cálculo
+ Mensajería instantánea
+ Conferencias de audio
+ Desarrollo de software (entorno de desarrollo integrado (IDE)
+ Introducción al procesamiento de datos de nivel medio
+ Almacenes de datos
+ Aplicaciones de inteligencia empresarial
+ Diseño gráfico
+ CAD/CAM (diseño asistido por ordenador/fabricación asistida por ordenador)
Este paquete no se recomienda para las conferencias de audio y vídeo, la renderización 3D, el diseño fotorrealista y el entrenamiento de modelos de machine learning.
## Paquete GraphicsPro.g4dn
Este paquete ofrece un nivel alto de rendimiento gráfico, rendimiento de CPU y memoria para sus WorkSpaces. Está especialmente indicado para lo siguiente:
+ Navegación web
+ Procesamiento de textos
+ Correo electrónico
+ Hojas de cálculo
+ Mensajería instantánea
+ Conferencias de audio
+ Desarrollo de software (entorno de desarrollo integrado (IDE)
+ Introducción al procesamiento de datos de nivel medio
+ Almacenes de datos
+ Aplicaciones de inteligencia empresarial
+ Diseño gráfico
+ CAD/CAM (diseño asistido por ordenador/fabricación asistida por ordenador)
+ Transcodificación de video
+ Renderización 3D
+ Diseño fotorrealista
+ Streaming de videojuegos
+ Entrenamiento con modelos de machine learning e inferencia de machine learning
Este paquete no se recomienda para las conferencias de audio y vídeo.
# Cree una imagen y un paquete personalizados para WorkSpaces piscinas
WorkSpaces Pool solo admite imágenes y paquetes de Windows. Si ha lanzado un Windows o WorkSpace lo ha personalizado, puede crear una imagen personalizada y paquetes personalizados a partir de ella. WorkSpace
Una *imagen personalizada* contiene solo el sistema operativo, el software y la configuración del WorkSpace. Un *paquete personalizado* es una combinación de esa imagen personalizada y del hardware desde el que se WorkSpace puede lanzar una.
Después de crear una imagen personalizada, puede crear un paquete personalizado que combine la imagen personalizada y la configuración de computación y almacenamiento subyacente que seleccione. A continuación, puede especificar este paquete personalizado al lanzar un nuevo paquete WorkSpaces para garantizar que el nuevo WorkSpaces tenga la misma configuración uniforme (hardware y software).
Puede utilizar la misma imagen personalizada para crear varios grupos personalizados seleccionando diferentes opciones de computación y almacenamiento para cada grupo.
**importante**
Los volúmenes de almacenamiento de paquetes personalizados no pueden ser más pequeños que los volúmenes de almacenamiento de imágenes.
Los paquetes personalizados cuestan igual que los paquetes públicos desde los que se crean. Para obtener más información sobre los precios, consulta [Amazon WorkSpaces Pricing](https://aws.amazon.com/workspaces/pricing/).
**Topics**
+ [Requisitos para crear imágenes personalizadas de Windows](#pools-windows_custom_image_requirements)
+ [Prácticas recomendadas](#pools-custom_image_best_practices)
+ [Paso 1: Ejecutar el comprobador de imágenes](#pools-run_image_checker)
+ [Paso 2: Crea una imagen personalizada y un paquete personalizado](#pools-create_custom_image_bundle)
+ [¿Qué se incluye con las imágenes WorkSpaces personalizadas de Windows](#pools-image_creation_windows)
## Requisitos para crear imágenes personalizadas de Windows
**nota**
Actualmente, Windows define 1 GB como 1.073.741.824 bytes. Debe asegurarse de que tengan más de 12.884.901.888 bytes (o 12 GiB) libres en la unidad C y que el perfil de usuario sea inferior a 10.737.418.240 bytes (o 10 GiB) para crear una imagen de un. WorkSpace
+ ****El estado de debe estar disponible y su estado de modificación debe ser Ninguno. WorkSpace ****
+ Todas las aplicaciones y los perfiles de usuario de WorkSpaces las imágenes deben ser compatibles con Microsoft Sysprep.
+ Todas las aplicaciones que se van a incluir en la imagen deben estar instaladas en la unidad `C`.
+ Todos los servicios de aplicaciones que se ejecuten en el WorkSpace deben usar una cuenta de sistema local en lugar de las credenciales de usuario del dominio. Por ejemplo, no puede haber una instalación de Microsoft SQL Server Express en ejecución con las credenciales de un usuario del dominio.
+ No WorkSpace deben estar cifrados. Actualmente, no WorkSpace se admite la creación de imágenes a partir de un archivo cifrado.
+ Los siguientes componentes son necesarios en una imagen. Sin estos componentes, lo WorkSpaces que inicie desde la imagen no funcionará correctamente. Para obtener más información, consulte [Componentes de configuración y servicio necesarios para WorkSpaces Personal](required-service-components.md).
+ Windows PowerShell versión 3.0 o posterior
+ Servicios de Escritorio remoto
+ AWS Controladores PV
+ Administración remota de Windows (WinRM)
+ Agentes y controladores de PCo propiedad intelectual de Teradici
+ Agentes y controladores de STXHD
+ AWS y certificados WorkSpaces
+ Agente de Skylight
+ WorkSpaces Los grupos solo admiten un tamaño máximo de volumen raíz de paquete o imagen de 200 GB. Al crear una imagen personalizada de Windows, asegúrese de que esté por debajo del tamaño del volumen raíz de 200 GB.
## Prácticas recomendadas
Antes de crear una imagen a partir de un WorkSpace, haga lo siguiente:
+ Utilice una VPC independiente que no esté conectada al entorno de producción.
+ Implemente el WorkSpace en una subred privada y utilice una instancia de NAT para el tráfico saliente.
+ Utilice un directorio Simple AD pequeño.
+ Utilice el tamaño de volumen más pequeño para la fuente y WorkSpace, a continuación, ajústelo según sea necesario al crear el paquete personalizado.
+ Instale todas las actualizaciones del sistema operativo (excepto las actualizaciones de las características y versiones de Windows) y todas las actualizaciones de las aplicaciones en el. WorkSpace
+ Elimine los datos en caché de los WorkSpace que no deberían incluirse en el paquete (por ejemplo, el historial del navegador, los archivos en caché y las cookies del navegador).
+ Elimine los ajustes de configuración WorkSpace que no deberían incluirse en el paquete (por ejemplo, los perfiles de correo electrónico).
+ Cambie a la configuración de direcciones IP dinámicas que utiliza DHCP.
+ Asegúrate de no haber superado el límite de WorkSpace imágenes permitido en una región. De forma predeterminada, se permiten 40 WorkSpace imágenes por región. Si ha alcanzado esta cuota, los nuevos intentos de crear una imagen producirán un error. Para solicitar un aumento de la cuota, utilice el [formulario de límites de WorkSpaces ](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=workspaces).
+ Asegúrate de no intentar crear una imagen a partir de una imagen cifrada WorkSpace. Actualmente, no WorkSpace se admite la creación de imágenes a partir de un archivo cifrado.
+ Si tienes instalado algún software antivirus en el WorkSpace, desactívalo mientras intentas crear una imagen.
+ Si tienes un firewall activado WorkSpace, asegúrate de que no bloquee ningún puerto necesario. Para obtener más información, consulte [Requisitos de dirección IP y puerto para WorkSpaces Personal](workspaces-port-requirements.md).
+ En el caso de Windows WorkSpaces, no configure ningún objeto de política de grupo (GPOs) antes de crear la imagen.
+ WorkSpacesEn Windows, no personalice el perfil de usuario predeterminado (`C:\Users\Default`) antes de crear una imagen. Se recomienda realizar cualquier personalización en el perfil de usuario y aplicarla después de la creación de la imagen. GPOs GPOs se pueden modificar o revertir fácilmente y, por lo tanto, son menos propensas a errores que las personalizaciones realizadas en el perfil de usuario predeterminado.
+ Asegúrese de actualizar los controladores de dependencia de la red, como los controladores ENA y PV NVMe, en su WorkSpaces ordenador. Debe hacerlo al menos una vez cada seis meses. Para obtener más información, consulte [Install or upgrade Elastic Network Adapter (ENA) driver ](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/enhanced-networking-ena.html#ena-adapter-driver-install-upgrade-win), [Controladores NVMe de AWS for Windows instances](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/aws-nvme-drivers.html) y [Upgrade PV drivers on Windows instances](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Upgrading_PV_drivers.html).
+ Asegúrese de actualizar periódicamente los agentes EC2 Config, EC2 EC2 Launch y Launch V2 a las versiones más recientes. Debe hacerlo al menos una vez cada seis meses. Para obtener más información, consulta [Update EC2 Config and EC2 Launch](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/migrating-latest-types.html#upgdate-ec2config-ec2launch).
## Paso 1: Ejecutar el comprobador de imágenes
Para confirmar que su Windows WorkSpace cumple los requisitos para la creación de imágenes, le recomendamos que ejecute la aplicación Image Checker. El comprobador de imágenes realiza una serie de pruebas en la imagen WorkSpace que desee utilizar para crear la imagen y proporciona instrucciones sobre cómo resolver cualquier problema que encuentre. El verificador de imágenes solo está disponible para Windows. WorkSpaces
**importante**
WorkSpace Debe superar todas las pruebas realizadas por el verificador de imágenes antes de poder utilizarlo para la creación de imágenes.
Antes de ejecutar el comprobador de imágenes, compruebe que las últimas actualizaciones acumulativas y de seguridad de Windows estén instaladas en su dispositivo. WorkSpace
Para obtener el comprobador de imágenes, realice una de las siguientes acciones:
+ [Reinicie su. WorkSpace](reboot-workspaces.md) El comprobador de imágenes se descarga automáticamente durante el reinicio y se instala en `C:\Program Files\Amazon\ImageChecker.exe`.
+ Descarga Amazon WorkSpaces Image Checker desde [https://tools.amazonworkspaces.com/ImageChecker.zip ](https://tools.amazonworkspaces.com/ImageChecker.zip) y extrae el archivo. `ImageChecker.exe` Copie este archivo en `C:\Program Files\Amazon\`.
**Para ejecutar el comprobador de imágenes**
1. Abra el archivo `C:\Program Files\Amazon\ImageChecker.exe`.
1. En el cuadro de diálogo **Amazon WorkSpaces Image Checker**, seleccione **Ejecutar**.
1. Tras completarse cada prueba, puede ver el estado de la prueba.
Para cualquier prueba con el estado **FAILED (Error)**, elija **Info (Información)** para mostrar información sobre cómo resolver el problema que provocó el error. Para obtener más información acerca de cómo resolver estos problemas, consulte [Sugerencias para resolver problemas detectados por el comprobador de imágenes](#pools-image_checker_tips).
Si alguna prueba muestra el estado **WARNING (Advertencia)**, elija el botón **Fix all Warnings (Solucionar todos los mensajes de advertencia)**.
La herramienta genera un archivo de registro de salida en el mismo directorio donde está ubicado el comprobador de imágenes. De forma predeterminada, este archivo se encuentra en `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log`. No elimine este archivo de registro. Si se produce un problema, este archivo de registro puede ser útil para solucionar problemas.
1. Si procede, resuelva cualquier problema que provoque errores y advertencias en las pruebas y repita el proceso de ejecutar el Image Checker hasta que supere todas las pruebas. WorkSpace Todos los errores y advertencias deben resolverse antes de poder crear una imagen.
1. Una vez WorkSpace superadas todas las pruebas, aparecerá el mensaje **de validación correcta**. Ahora está listo para crear un paquete personalizado.
### Sugerencias para resolver problemas detectados por el comprobador de imágenes
Además de consultar las siguientes sugerencias para resolver los problemas detectados por el comprobador de imágenes, asegúrese de revisar el archivo de registro del comprobador de imágenes en `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log`.
#### PowerShell debe estar instalada la versión 3.0 o posterior
Instale la versión más reciente de [Microsoft Windows PowerShell](https://docs.microsoft.com/powershell).
**importante**
La política de PowerShell ejecución de a WorkSpace debe estar configurada para permitir los **RemoteSigned**scripts. Para comprobar la política de ejecución, ejecute el ExecutionPolicy PowerShell comando **Get-**. Si la política de ejecución no está establecida en **Sin restricciones **RemoteSigned****, ejecute el ExecutionPolicy RemoteSigned comando **Set- ExecutionPolicy —** para cambiar el valor de la política de ejecución. La **RemoteSigned**configuración permite la ejecución de scripts en Amazon WorkSpaces, lo cual es necesario para crear una imagen.
#### Solo las unidades C y D pueden estar presentes
Solo las `D` unidades `C` and pueden estar presentes en una unidad WorkSpace que se utilice para la generación de imágenes. Elimine todas las demás unidades, incluidas las unidades virtuales.
#### No se puede detectar ningún reinicio pendiente debido a las actualizaciones de Windows
+ El proceso Crear imagen no se puede ejecutar hasta que se haya reiniciado Windows para finalizar la instalación de actualizaciones acumulativas o de seguridad. Reinicie Windows para aplicar estas actualizaciones y asegúrese de que no sea necesario instalar otras actualizaciones acumulativas o de seguridad de Windows pendientes.
+ La creación de imágenes no es compatible con los sistemas Windows 10 que se han actualizado de una versión de Windows 10 a una versión más reciente de Windows 10 (una feature/version actualización de Windows). Sin embargo, el proceso de WorkSpaces creación de imágenes admite las actualizaciones acumulativas o de seguridad de Windows.
#### El archivo Sysprep debe existir y no puede estar en blanco
Si hay problemas con su archivo Sysprep, póngase en contacto con el [AWS Support Centro para reparar](https://console.aws.amazon.com/support/home#/) su EC2 Config o EC2 Launch.
#### El tamaño del perfil de usuario debe ser inferior a 10 GB
Para Windows 7 WorkSpaces, el perfil de usuario (`D:\Users\username`) debe tener menos de 10 GB en total. Elimine los archivos según sea necesario para reducir el tamaño del perfil de usuario.
#### La unidad C debe tener suficiente espacio libre
Para Windows 7 WorkSpaces, debe tener al menos 12 GB de espacio libre en el disco`C`. Elimine los archivos según sea necesario para liberar espacio en la unidad `C`. En Windows 10 WorkSpaces, omítelo si recibe un `FAILED` mensaje y el espacio en disco es superior a 2 GB.
#### No se puede ejecutar ningún servicio en una cuenta de dominio
Para ejecutar el proceso de creación de imagen, ningún servicio de la misma WorkSpace puede ejecutarse en una cuenta de dominio. Todos los servicios deben ejecutarse en una cuenta local.
**Para ejecutar servicios en una cuenta local**
1. Abra `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log` y busque la lista de servicios que se ejecutan en una cuenta de dominio.
1. En el cuadro de búsqueda de Windows, escriba **services.msc** para abrir el Administrador de servicios de Windows.
1. En **Iniciar sesión como**, busque los servicios que se ejecutan en cuentas de dominio. (Los servicios que se ejecutan como **Sistema local**, **Servicio local** o **Servicio de red** no interfieren con la creación de imágenes).
1. Seleccione un servicio que se esté ejecutando en una cuenta de dominio y, a continuación, elija **Acción**, **Propiedades**.
1. Abra la pestaña **Iniciar sesión**. En **Iniciar sesión como**, elija **Cuenta de sistema local**.
1. Seleccione **Aceptar**.
#### WorkSpace Debe estar configurado para usar DHCP
Debe configurar todos los adaptadores de red del WorkSpace para que utilicen DHCP en lugar de direcciones IP estáticas.
**Para configurar todos los adaptadores de red para utilizar DHCP**
1. En el cuadro de búsqueda de Windows, escriba **control panel** para abrir el Panel de control.
1. Elija **Redes e Internet**.
1. Elija **Centro de redes y recursos compartidos**.
1. Elija **Cambiar configuración del adaptador** y seleccione un adaptador.
1. Elija **Cambiar la configuración de esta conexión**.
1. **En la pestaña **Redes**, seleccione el **Protocolo de Internet versión 4 (TCP/IPv4)** y, a continuación, elija Propiedades.**
1. En el cuadro de diálogo **Propiedades del Protocolo de Internet versión 4 (TCP/IPv4)**, seleccione **Obtener una dirección IP automáticamente**.
1. Seleccione **Aceptar**.
1. Repita este proceso para todos los adaptadores de red del. WorkSpace
#### Los servicios de Escritorio remoto deben estar habilitados
El proceso Crear imagen requiere que los servicios de Escritorio remoto estén habilitados.
**Para habilitar Servicios de Escritorio remoto**
1. En el cuadro de búsqueda de Windows, escriba **services.msc** para abrir el Administrador de servicios de Windows.
1. En la columna **Nombre**, busque **Servicios de Escritorio remoto**.
1. Seleccione **Servicios de Escritorio remoto** y, a continuación, elija **Acción**, **Propiedades**.
1. En la pestaña **General**, para **Tipo de inicio**, elija **Manual** o **Automático**.
1. Seleccione **Aceptar**.
#### Debe existir un perfil de usuario
El WorkSpace que utilices para crear imágenes debe tener un perfil de usuario (`D:\Users\username`). Si esta prueba produce un error, póngase en contacto con el [Centro de AWS Support](https://console.aws.amazon.com/support/home#/) para obtener ayuda.
#### La ruta de la variable de entorno debe estar configurada correctamente
Faltan entradas para System32 y Windows PowerShell en la ruta de la variable de entorno de la máquina local. Estas entradas son necesarias para que se ejecute Crear imagen.
**Para configurar la ruta de la variable de entorno**
1. En el cuadro de búsqueda de Windows, escriba **environment variables** y después elija **Editar las variables de entorno del sistema**.
1. En el cuadro de diálogo **Propiedades del sistema**, abra la pestaña **Avanzadas** y elija **Variables de entorno**.
1. En el cuadro de diálogo **Variables de entorno**, en **Variables de sistema**, seleccione la entrada **Ruta** y, a continuación, elija **Editar**.
1. Elija **Nueva** y agregue la siguiente ruta:
`C:\Windows\System32`
1. Vuelva a elegir **Nueva** y agregue la siguiente ruta:
`C:\Windows\System32\WindowsPowerShell\v1.0\`
1. Seleccione **Aceptar**.
1. Reinicie el WorkSpace.
**sugerencia**
El orden en que aparecen los elementos en la ruta de la variable de entorno es importante. Para determinar el orden correcto, puede que desee comparar la ruta de su variable de entorno WorkSpace con la de una instancia de Windows recién creada WorkSpace o nueva.
#### El instalador de módulos de Windows debe estar habilitado
El proceso Crear imagen requiere que el servicio Instalador de módulos de Windows esté habilitado.
**Para habilitar el servicio Instalador de módulos de Windows**
1. En el cuadro de búsqueda de Windows, escriba **services.msc** para abrir el Administrador de servicios de Windows.
1. En la columna **Nombre**, busque **Instalador de módulos de Windows**.
1. Seleccione **Instalador de módulos de Windows** y, a continuación, elija **Acción**, **Propiedades**.
1. En la pestaña **General**, para **Tipo de inicio**, elija **Manual** o **Automático**.
1. Seleccione **Aceptar**.
#### El agente de Amazon SSM debe estar deshabilitado
El proceso Crear imagen requiere que el servicio del agente de Amazon SSM esté deshabilitado.
**Para desactivar el servicio del agente de Amazon SSM**
1. En el cuadro de búsqueda de Windows, escriba **services.msc** para abrir el Administrador de servicios de Windows.
1. En la columna **Nombre**, busque **Agente de Amazon SSM**.
1. Seleccione **Agente de Amazon SSM** y, a continuación, elija **Acción**, **Propiedades**.
1. En la pestaña **General**, para **Tipo de inicio**, elija **Deshabilitado**.
1. Seleccione **Aceptar**.
#### SSL3 y la versión 1.2 de TLS debe estar habilitada
Para configurar SSL/TLS para Windows, consulte [Cómo habilitar TLS 1.2](https://docs.microsoft.com/configmgr/core/plan-design/security/enable-tls-1-2) en la documentación de Microsoft Windows.
#### Solo puede existir un perfil de usuario en WorkSpace
Solo puede haber un perfil WorkSpaces de usuario (`D:\Users\username`) en el WorkSpace que estás utilizando para crear las imágenes. Elimine cualquier perfil de usuario que no pertenezca al usuario previsto del WorkSpace.
Para que la creación de imágenes funcione, solo WorkSpace puede tener tres perfiles de usuario:
+ El perfil de usuario del usuario previsto de WorkSpace (`D:\Users\username`)
+ El perfil de usuario predeterminado (también conocido como perfil predeterminado)
+ El perfil de usuario administrador
Si hay perfiles de usuario adicionales, puede eliminarlos a través de las propiedades avanzadas del sistema en el Panel de control de Windows.
**Para eliminar un perfil de usuario**
1. Para acceder a las propiedades avanzadas del sistema, siga uno de estos procedimientos:
+ Pulse la **tecla de Windows\$1Pausa Inter** y, a continuación, elija **Configuración avanzada del sistema** en el panel izquierdo del cuadro de diálogo **Panel de control** > **Sistema y seguridad** > **Sistema**.
+ En el cuadro de búsqueda de Windows, escriba **control panel**. En el Panel de control, elija **Sistema y seguridad**, después elija Sistema y, a continuación, elija **Configuración avanzada del sistema** en el panel izquierdo del cuadro de diálogo **Panel de control** > **Sistema y seguridad** > **Sistema**.
1. En el cuadro de diálogo **Propiedades del sistema**, en la pestaña **Avanzadas**, elija **Configuración** en **Perfiles de usuario**.
1. Si aparece algún perfil distinto del perfil de administrador, el perfil predeterminado y el perfil del WorkSpaces usuario previsto, seleccione ese perfil adicional y pulse **Eliminar**.
1. Cuando se le pregunte si desea eliminar el perfil, elija **Sí**.
1. Si es necesario, repita los pasos 3 y 4 para eliminar cualquier otro perfil que no pertenezca al WorkSpace.
1. Elija **Aceptar** dos veces y cierre el Panel de control.
1. Reinicie el WorkSpace.
#### Ningún paquete de AppX puede estar en un estado por etapas
Uno o más paquetes de AppX están en un estado por etapas. Esto puede provocar un error de Sysprep durante la creación de la imagen.
**Para eliminar todos los paquetes de AppX por etapas**
1. En el cuadro de búsqueda de Windows, escriba **powershell**. Seleccione **Ejecutar como administrador**.
1. Cuando se le pregunte "¿Desea permitir que esta aplicación realice cambios en su dispositivo?", elija **Sí**.
1. En la PowerShell ventana de Windows, introduzca los siguientes comandos para obtener una lista de todos los paquetes de AppX preparados y pulse Entrar después de cada uno de ellos.
```
$workSpaceUserName = $env:username
```
```
$allAppxPackages = Get-AppxPackage -AllUsers
```
```
$packages = $allAppxPackages | Where-Object { `
(($_.PackageUserInformation -like "*S-1-5-18*" -and !($_.PackageUserInformation -like "*$workSpaceUserName*")) -and `
($_.PackageUserInformation -like "*Staged*" -or $_.PackageUserInformation -like "*Installed*")) -or `
((!($_.PackageUserInformation -like "*S-1-5-18*") -and $_.PackageUserInformation -like "*$workSpaceUserName*") -and `
$_.PackageUserInformation -like "*Staged*")
}
```
1. Ejecute el siguiente comando con privilegios de SISTEMA elevados para eliminar todas las entradas de aprovisionamiento de paquetes de AppX por etapas y pulse Entrar.
```
$packages | Remove-AppxPackage -ErrorAction SilentlyContinue
```
1. Vuelva a ejecutar el comprobador de imágenes. Si esta prueba sigue produciendo un error, escriba los siguientes comandos para eliminar todos los paquetes de AppX y pulse Intro después de cada uno.
```
Get-AppxProvisionedPackage -Online | Remove-AppxProvisionedPackage -Online -ErrorAction SilentlyContinue
```
```
Get-AppxPackage -AllUsers | Remove-AppxPackage -ErrorAction SilentlyContinue
```
#### Windows no se debe haber actualizado desde una versión anterior
La creación de imágenes no es compatible con los sistemas Windows que se han actualizado de una versión de Windows 10 a una versión más reciente de Windows 10 (una feature/version actualización de Windows).
Para crear imágenes, utilice una WorkSpace que no se haya actualizado a feature/version Windows.
#### El recuento de rearmados de Windows no debe ser 0
La característica "rearmar" le permite ampliar el periodo de activación de la versión de prueba de Windows. El proceso Crear imagen requiere que el recuento de rearmados sea un valor distinto de 0.
**Para comprobar el recuento de rearmados de Windows**
1. En el menú **Inicio** de Windows, elija **Sistema de Windows**, y, a continuación, elija **Símbolo del sistema**.
1. En la ventana del símbolo del sistema, escriba el siguiente comando y, a continuación, pulse Intro.
`cscript C:\Windows\System32\slmgr.vbs /dlv`
Para restablecer el recuento de rearmados en un valor distinto de 0, consulte [Ejecutar Sysprep (Generalize) en una instalación de Windows](https://docs.microsoft.com/windows-hardware/manufacture/desktop/sysprep--generalize--a-windows-installation) en la documentación de Microsoft Windows.
#### Sugerencias adicionales para la solución de problemas
Si WorkSpace superas todas las pruebas realizadas por el Image Checker, pero sigues sin poder crear una imagen a partir de él WorkSpace, comprueba los siguientes problemas:
+ Asegúrese de que WorkSpace no esté asignado a un usuario de un grupo de **invitados del dominio**. Para comprobar si hay cuentas de dominio, ejecuta el siguiente PowerShell comando.
```
Get-WmiObject -Class Win32_Service | Where-Object { $_.StartName -like "*$env:USERDOMAIN*" }
```
+ Algunos objetos de política de grupo (GPOs) restringen el acceso a la huella digital del certificado RDP cuando lo solicitan el servicio EC2 Config o los scripts de EC2 lanzamiento durante la configuración de la instancia de Windows. Antes de intentar crear una imagen, muévela WorkSpace a una nueva unidad organizativa (OU) cuya herencia esté bloqueada y no GPOs se haya aplicado.
+ Asegúrese de que el servicio Administración remota de Windows (WinRM) está configurado para iniciarse automáticamente. Haga lo siguiente:
1. En el cuadro de búsqueda de Windows, escriba `services.msc` para abrir el Administrador de servicios de Windows.
1. En la columna **Nombre**, busque **Administración remota de Windows (WS-Management)**.
1. Seleccione **Administración remota de Windows (WS-Management)** y, a continuación, elija **Acción** y **Propiedades**.
1. En la pestaña **General**, para **Tipo de inicio**, elija **Automático**.
1. Seleccione **Aceptar**.
## Paso 2: Crea una imagen personalizada y un paquete personalizado
Una vez validada la WorkSpace imagen, complete el siguiente procedimiento para crear la imagen y el paquete personalizados mediante la WorkSpaces consola. Para crear una imagen mediante programación, utilice la acción de la CreateWorkspaceImage API. Para obtener más información, consulta [ CreateWorkspaceImage](https://docs.aws.amazon.com/workspaces/latest/api/API_CreateWorkspaceImage.html)la *referencia de la WorkSpaces API de Amazon*. Para eliminar un paquete mediante programación, utilice la acción de la API **CreateWorkspaceBundle**. Para obtener más información, consulta [ CreateWorkspaceBundle](https://docs.aws.amazon.com/workspaces/latest/api/API_CreateWorkspaceBundle.html)la *referencia de la WorkSpaces API de Amazon*.
**Para crear una imagen personalizada y un paquete personalizado mediante la WorkSpaces consola**
1. Si todavía está conectado a WorkSpace, desconéctese seleccionando **Amazon WorkSpaces** y **Disconnect** en la aplicación WorkSpaces cliente.
1. Abre la WorkSpaces consola en la [https://console.aws.amazon.com/workspaces/versión 2/home](https://console.aws.amazon.com/workspaces/v2/home).
1. En el panel de navegación, elija **WorkSpaces**.
1. Seleccione WorkSpace para abrir su página de detalles y elija **Crear** imagen. Si el estado de WorkSpace es **Detenido**, debe iniciarlo primero (elija **Acciones**, **Iniciar WorkSpaces**) antes de poder elegir **Acciones**, **Crear imagen**.
1. Aparece un mensaje en el que se le pide que reinicie (reinicie) el suyo WorkSpace antes de continuar. Al reiniciar, se WorkSpace actualiza el WorkSpaces software de Amazon a la última versión.
Reinicie el suyo WorkSpace cerrando el mensaje y siguiendo los pasos que se indican. [Reinicio de un escritorio de WorkSpaces en WorkSpaces Personal](reboot-workspaces.md) Cuando haya terminado, repita el [Step 4](create-custom-bundle.md#step_create_image) de este procedimiento, pero esta vez elija **Siguiente** cuando aparezca el mensaje de reinicio. Para crear una imagen, el estado de la imagen WorkSpace debe estar **disponible** y su estado de modificación debe ser **Ninguno**.
1. Escriba un nombre y una descripción de la imagen que le ayuden a identificarla y, a continuación, elija **Create Image (Crear imagen)**. Mientras se crea la imagen, el estado de WorkSpace es **Suspendido** y no WorkSpace está disponible.
No utilice el carácter especial de guión (`-`) en la descripción. Se producirá un error.
1. En el panel de navegación, elija **Images**. La imagen estará completa cuando el estado de la imagen WorkSpace cambie a **Disponible** (esto puede tardar hasta 45 minutos).
1. Seleccione la imagen y elija **Acciones**, **Crear paquete**.
1. Introduzca un nombre y una descripción para el paquete y, a continuación, haga lo siguiente:
+ En el **tipo de hardware del paquete**, elija el hardware que se utilizará al iniciar el WorkSpaces juego desde este paquete personalizado.
+ Las combinaciones de tamaños disponibles por defecto para el volumen raíz son de 200 GB cada una WorkSpace.
1. Para confirmar que el paquete se ha creado, seleccione **Paquetes** y compruebe que el paquete aparezca en la lista.
## ¿Qué se incluye con las imágenes WorkSpaces personalizadas de Windows
Al crear una imagen desde un dispositivo Windows WorkSpace, se incluye todo el contenido de la `C` unidad.
+ Contactos
+ Descargas
+ Música
+ Imágenes
+ Juegos guardados
+ Videos
+ Podcasts
+ Máquinas virtuales
+ .virtualbox
+ Tracing
+ appdata\$1local\$1temp
+ appdata\$1roaming\$1apple computer\$1mobilesync\$1
+ appdata\$1roaming\$1apple computer\$1logs\$1
+ appdata\$1roaming\$1apple computer\$1itunes\$1iphone software updates\$1
+ appdata\$1roaming\$1macromedia\$1flash player\$1macromedia.com\$1support\$1flashplayer\$1sys\$1
+ appdata\$1roaming\$1macromedia\$1flash player\$1\$1sharedobjects\$1
+ appdata\$1roaming\$1adobe\$1flash player\$1assetcache\$1
+ appdata\$1roaming\$1microsoft\$1windows\$1recent\$1
+ appdata\$1roaming\$1microsoft\$1office\$1recent\$1
+ appdata\$1roaming\$1microsoft office\$1live meeting
+ appdata\$1roaming\$1microsoft shared\$1livemeeting shared\$1
+ appdata\$1roaming\$1mozilla\$1firefox\$1crash reports\$1
+ appdata\$1roaming\$1mcafee\$1common framework\$1
+ appdata\$1local\$1microsoft\$1feeds cache
+ appdata\$1local\$1microsoft\$1windows\$1temporary internet files\$1
+ appdata\$1local\$1microsoft\$1windows\$1history\$1
+ appdata\$1local\$1microsoft\$1internet explorer\$1domstore\$1
+ appdata\$1local\$1microsoft\$1internet explorer\$1imagestore\$1
+ appdata\$1locallow\$1microsoft\$1internet explorer\$1iconcache\$1
+ appdata\$1locallow\$1microsoft\$1internet explorer\$1domstore\$1
+ appdata\$1locallow\$1microsoft\$1internet explorer\$1imagestore\$1
+ appdata\$1local\$1microsoft\$1internet explorer\$1recovery\$1
+ appdata\$1local\$1mozilla\$1firefox\$1profiles\$1
# Administra imágenes y paquetes personalizados para piscinas WorkSpaces
El proceso de administración de imágenes y paquetes personalizados es el mismo entre WorkSpaces Personal y WorkSpaces Pool. Para obtener más información sobre cómo administrar las imágenes y los paquetes, consulte la siguiente documentación en la sección WorkSpaces Personal de esta guía:
**nota**
La principal diferencia entre los paquetes personalizados que puedes usar para WorkSpaces Personal y los que puedes usar para WorkSpaces Pool es el sistema operativo y el paquete público básico que se puede usar. Para ver los sistemas operativos y los paquetes compatibles con WorkSpaces Pool, consulte. [ WorkSpaces Paquetes de piscinasPaquetes Más información sobre los paquetes de WorkSpaces piscinas. Un *WorkSpace paquete* es una combinación de un sistema operativo y recursos de almacenamiento, cómputo y software. Al lanzar un paquete WorkSpace, selecciona el paquete que mejor se adapte a sus necesidades. Los paquetes predeterminados para los que están disponibles WorkSpaces se denominan *paquetes públicos*. Para obtener más información sobre los distintos paquetes públicos disponibles WorkSpaces, consulta [Amazon WorkSpaces Bundles](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles). En la siguiente tabla se proporciona información sobre las licencias, los protocolos de transmisión y los paquetes compatibles con cada sistema operativo.
| Sistema operativo | Licencias | Protocolos de transmisión | Paquetes compatibles |
| --- | --- | --- | --- |
| Windows Server 2019 | Incluido | DCV | Valor, estándar, rendimiento, potencia, PowerPro |
| Windows Server 2022 | Incluido | DCV | Estándar, rendimiento, potencia, gráficos. PowerPro G4dn, .G4dn GraphicsPro | No se garantiza que las versiones del sistema operativo que el vendedor ya no admite funcionen ni cuentan con soporte técnico. AWS ](instance-types.md#instance-types.title)
+ [Actualización de un paquete personalizado en WorkSpaces Personal](update-custom-bundle.md).
+ [Copiar una imagen personalizada en WorkSpaces Personal](copy-custom-image.md).
+ [Cómo compartir o dejar de compartir una imagen personalizada en WorkSpaces Personal](share-custom-image.md).
+ [Eliminación de un paquete o imagen personalizados en WorkSpaces Personal](delete_bundle.md).
# Uso de scripts de sesión para administrar la experiencia de transmisión de los usuarios
WorkSpaces Pool proporciona scripts de sesión en la instancia. Puede utilizar estas secuencias de comandos para ejecutar sus propias secuencias de comandos personalizados cuando se produzcan eventos específicos en las sesiones de transmisión. Por ejemplo, puede usar scripts personalizados para preparar el entorno de WorkSpaces Pools antes de que comiencen las sesiones de streaming de sus usuarios. También puede usar secuencias de comandos personalizados para limpiar las instancias de transmisión después de que los usuarios hayan finalizado las sesiones de transmisión.
Los scripts de sesión se especifican dentro de una WorkSpace imagen. Estos scripts se ejecutan en el contexto del usuario o del sistema. Si los scripts de sesión utilizan la salida estándar para escribir los mensajes de información, error o depuración, estos se pueden guardar, si lo desea, en un bucket de Amazon S3 de su cuenta de Amazon Web Services.
**Topics**
+ [Ejecución de scripts antes de que empiecen las sesiones de streaming](#run-scripts-before-streaming-sessions-begin)
+ [Ejecución de scripts después de finalizar las sesiones de streaming](#run-scripts-after-streaming-sessions-end)
+ [Creación y especificación de scripts de sesión](#create-specify-session-scripts)
+ [Archivo de configuración de scripts de sesión](#session-script-configuration-file)
+ [Uso de PowerShell archivos de Windows](#using-powershell-files-with-session-scripts)
+ [Registro de la salida de los scripts de sesión](#logging-session-output)
+ [Uso del almacenamiento persistente con los scripts de sesión](#use-storage-connectors-with-session-scripts)
+ [Habilitación del almacenamiento en buckets de Amazon S3 de los registros de los scripts de sesión](#enable-S3-bucket-storage-session-script-logs)
## Ejecución de scripts antes de que empiecen las sesiones de streaming
Puede configurar los scripts para que se ejecuten durante un máximo de 60 segundos antes de se lancen las aplicaciones de los usuarios y empiecen las sesiones de streaming. Esto le permite personalizar el entorno de WorkSpaces Pools antes de que los usuarios comiencen a transmitir sus aplicaciones. Cuando se ejecutan scripts de sesión, aparece un rotador de carga a los usuarios. Cuando los scripts finalizan correctamente o transcurre el tiempo de espera máximo, empieza la sesión de streaming de los usuarios. Si los scripts no se completan correctamente, se muestra un mensaje de error para los usuarios. Sin embargo, no se impide a los usuarios que usen la sesión de streaming.
Cuando se especifica un nombre de archivo en una instancia de Windows, debe utilizar una doble barra oblicua inversa. Por ejemplo:
```
C:\\Scripts\\Myscript.bat
```
Si no utiliza una doble barra oblicua inversa, aparecerá un mensaje de error para informarle de que el archivo `.json` no tiene el formato correcto.
**nota**
Cuando los scripts finalizan correctamente, deben devolver un valor de 0. Si los scripts devuelven un valor distinto de 0, WorkSpaces muestra el mensaje de error al usuario.
Al ejecutar scripts antes de que comiencen las sesiones de transmisión, tiene lugar el siguiente proceso:
1. Los usuarios se conectan a un WorkSpace WorkSpaces grupo que no está unido a un dominio. Se conectan mediante SAML 2.0.
1. Tiene lugar uno de los siguientes procesos:
+ Si está habilitada la persistencia de la configuración de las aplicaciones para los usuarios, se descarga y monta el archivo VHD (disco duro virtual) de configuración de la aplicación, en el que se almacenan las personalizaciones y los ajustes de Windows de los usuarios. En este caso se requiere un inicio de sesión de usuario de Windows.
Para obtener información sobre la persistencia de la configuración de las aplicaciones, consulte [Habilite la persistencia de la configuración de la aplicación para los usuarios de sus WorkSpaces grupos](app-settings-persistence.md).
+ Si la persistencia de la configuración de las aplicaciones no está habilitada, el usuario de Windows ya ha iniciado sesión.
1. Se inician los scripts de sesión. Si el almacenamiento persistente está habilitado para los usuarios, también comienza el montaje del conector de almacenamiento. Para obtener más información acerca del almacenamiento persistente, consulte [Habilitar y administrar el almacenamiento persistente para WorkSpaces grupos](persistent-storage.md).
**nota**
No es preciso que haya finalizado el montaje del conector de almacenamiento para que se inicie la sesión de streaming. Si los scripts de sesión finalizan antes que el montaje del conector de almacenamiento, se inicia la sesión de streaming.
Para obtener información acerca de la monitorización del estado del montaje de los conectores de almacenamiento, consulte [Uso del almacenamiento persistente con los scripts de sesión](#use-storage-connectors-with-session-scripts).
1. Los scripts de sesión finalizan o se agota el tiempo de espera.
1. Se inicia la sesión de streaming de los usuarios.
## Ejecución de scripts después de finalizar las sesiones de streaming
También puede configurar los scripts para que se ejecuten después de que finalicen las sesiones de streaming. Por ejemplo, puede ejecutar un script cuando los usuarios seleccionen **Finalizar sesión** en la barra de herramientas del WorkSpaces cliente o cuando alcancen la duración máxima permitida para la sesión. También puede usar estos scripts de sesión para limpiar el entorno de WorkSpaces antes de que termine una instancia de streaming. Por ejemplo, puede usar scripts para liberar los bloqueos de archivos o cargar los archivos de registro. Cuando se ejecutan scripts después de que finalicen las sesiones de streaming, tiene lugar el siguiente proceso:
1. Finaliza la sesión WorkSpaces de streaming de tus usuarios.
1. Se inician los scripts de finalización de sesión.
1. Los scripts de finalización de sesión finalizan o se agota el tiempo de espera.
1. Se produce el cierre de sesión del usuario de Windows.
1. En paralelo, se produce uno de los siguientes casos o ambos, si procede:
+ Si está habilitada la persistencia de la configuración de las aplicaciones para los usuarios, se desmonta y se carga a un bucket de Amazon S3 de la cuenta el archivo VHD de configuración de la aplicación, en el que se almacenan las personalizaciones y los ajustes de Windows de los usuarios.
+ Si el almacenamiento persistente está habilitado para los usuarios, el conector de almacenamiento lleva a cabo una sincronización final y se desmonta.
1. WorkSpace Se da por finalizada.
## Creación y especificación de scripts de sesión
Complete el siguiente procedimiento para crear y especificar los scripts de sesión para WorkSpaces In a WorkSpaces Pool.
1. Conéctese a la ventana WorkSpaces desde la que va a crear una imagen personalizada.
1. Cree el directorio `/AWSEUC/SessionScripts` si aún no existe.
1. Cree un archivo de configuración `/AWSEUC/SessionScripts/config.json` si aún no existe, mediante la [plantilla de configuración del script de sesión](https://docs.aws.amazon.com/workspaces/latest/adminguide/pools-images-session-scripts.html#session-script-configuration-file).
1. Navegue hasta `C:\AWSEUC\SessionScripts` y abra el archivo de configuración `config.json`.
Para obtener información acerca de los parámetros de los scripts de sesión, consulte [Archivo de configuración de scripts de sesión](#session-script-configuration-file).
1. Una vez que haya terminado de realizar cambios, guarde y cierre el archivo `config.json`.
1. Complete los pasos para crear una imagen a partir de WorkSpace. Para obtener más información, consulte [Cree una imagen y un paquete personalizados para WorkSpaces piscinas](pools-images-custom-image.md).
## Archivo de configuración de scripts de sesión
Para localizar el archivo de configuración de los scripts de sesión en una instancia de Windows, vaya a `C:\AWSEUC\SessionScripts\config.json`. El archivo tiene el formato siguiente.
**nota**
El archivo de configuración tiene formato JSON. Compruebe que cualquier texto que escriba en este archivo esté en formato JSON válido.
```
{
"SessionStart": {
"executables": [
{
"context": "system",
"filename": "",
"arguments": "",
"s3LogEnabled": true
},
{
"context": "user",
"filename": "",
"arguments": "",
"s3LogEnabled": true
}
],
"waitingTime": 30
},
"SessionTermination": {
"executables": [
{
"context": "system",
"filename": "",
"arguments": "",
"s3LogEnabled": true
},
{
"context": "user",
"filename": "",
"arguments": "",
"s3LogEnabled": true
}
],
"waitingTime": 30
}
}
```
Puede utilizar los siguientes parámetros en el archivo de configuración de scripts de sesión.
**`SessionStart/SessionTermination `**
Los scripts de sesión que se ejecutarán en el evento de sesión apropiado basados en el nombre del objeto.
**Tipo**: cadena
**Obligatorio**: no
**Valores permitidos:** **SessionStart**, **SessionTermination**
**`WaitingTime`**
La duración máxima de los scripts de sesión, en segundos.
**Tipo**: entero
**Obligatorio**: no
**Restricciones:** la duración máxima es de 60 segundos. Si los scripts de sesión no han finalizado antes de cumplirse este plazo, se detendrán. Si necesita un script para continuar con la ejecución, láncelo como un proceso independiente.
**`Executables`**
Los detalles para ejecutar los scripts de sesión.
**Tipo:** cadena
**Obligatorio**: sí
**Restricciones:** el número máximo de scripts que se pueden ejecutar por evento de sesión es de 2 (uno para el contexto del usuario y otro para el contexto del sistema).
**`Context`**
El contexto en el que se ejecutará el script de sesión.
**Tipo:** cadena
**Obligatorio**: sí
**Valores permitidos:** **user**, **system**
**`Filename`**
La ruta completa del script de sesión que se ejecutará. Si no se especifica este parámetro, el script de sesión no se ejecuta.
**Tipo:** cadena
**Obligatorio**: no
**Restricciones:** la longitud máxima del nombre de archivo y su ruta completa es de 1000 caracteres.
**Valores permitidos:** **.bat**, **.exe** y **.sh**
También puede utilizar PowerShell archivos de Windows. Para obtener más información, consulte [Uso de PowerShell archivos de Windows](#using-powershell-files-with-session-scripts).
**`Arguments`**
Los argumentos del script de sesión o del archivo ejecutable.
**Tipo:** cadena
**Obligatorio**: no
**Limitaciones de longitud:** la longitud máxima de 1000 caracteres.
**`S3LogEnabled`**
Cuando el valor de este parámetro se establece en **True**, se crea un bucket de S3 dentro de la cuenta de Amazon Web Services para almacenar los registros creados por el script de sesión. De forma predeterminada, este valor se establece en **True**. Para obtener más información, consulte la sección *Registro de la salida de los scripts de sesión* más adelante en este tema.
**Tipo**: Booleano
**Obligatorio**: no
**Valores permitidos:** **True**, **False**
## Uso de PowerShell archivos de Windows
Para usar PowerShell archivos de Windows, especifique la ruta completa al PowerShell archivo en el `filename` parámetro:
```
"filename":
"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
```
A continuación, especifique el script de sesión en el parámetro **arguments**:
```
"arguments": "-File \"C:\\path\\to\\session\\script.ps1\"",
```
Por último, compruebe que la política de PowerShell ejecución permita que el PowerShell archivo se ejecute.
## Registro de la salida de los scripts de sesión
Cuando esta opción está habilitada en el archivo de configuración, WorkSpaces Pool captura automáticamente el resultado del script de sesión que se escribe en la salida estándar. Esta salida se carga en un bucket de Amazon S3 de la cuenta. Puede revisar los archivos de registro con fines de solución de problemas o depuración.
**nota**
Los archivos de registro se cargan cuando el script de sesión devuelve un valor o cuando transcurre el tiempo establecido en **WaitingTime**, lo que ocurra primero.
## Uso del almacenamiento persistente con los scripts de sesión
Cuando el almacenamiento WorkSpaces persistente está activado, el almacenamiento comienza a montarse cuando se ejecutan los scripts de inicio de sesión. Si el script depende del montaje del almacenamiento persistente, puede esperar a que los conectores estén disponibles. WorkSpaces mantiene el estado de montaje de los conectores de almacenamiento del registro de Windows en Windows WorkSpaces, en la siguiente clave:
```
HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\AWSEUC\Storage\\
```
Los valores de la clave del registro son los siguientes:
+ Nombre de usuario proporcionado: el ID de usuario proporcionado a través del modo de acceso. Los modos de acceso y el valor de cada uno de ellos son los siguientes:
+ Grupo de usuarios: la dirección de correo electrónico del usuario
+ URL de streaming: el valor de UserID
+ SAML: el valor de NameID Si el nombre de usuario incluye una barra (por ejemplo, el SAMAccount nombre de un usuario de dominio), la barra se sustituye por un carácter «-».
+ Conector de almacenamiento: el conector de la opción de almacenamiento persistente que se ha habilitado para el usuario. Los valores del conector de almacenamiento son los siguientes:
+ HomeFolder
Cada clave de registro del conector de almacenamiento contiene un valor **MountStatus**DWORD. En la siguiente tabla se enumeran los valores posibles de **MountStatus**.
**nota**
Para ver estas claves del Registro, debe tener Microsoft .NET Framework versión 4.7.2 o posterior instalado en la imagen.
| Valor | Description (Descripción) |
| --- | --- |
| 0 | El conector de almacenamiento no se ha habilitado para este usuario |
| 1 | El montaje del conector de almacenamiento está en curso |
| 2 | El conector de almacenamiento se ha montado correctamente |
| 3 | Se ha producido un error al montar el conector de almacenamiento |
| 4 | El montaje del conector de almacenamiento está habilitado, pero aún no está montado |
## Habilitación del almacenamiento en buckets de Amazon S3 de los registros de los scripts de sesión
Cuando habilita el registro de Amazon S3 en la configuración del script de sesión, WorkSpaces Pool captura el resultado estándar del script de sesión. La salida se carga periódicamente en un bucket de S3 de la cuenta de Amazon Web Services. Para cada AWS región, WorkSpaces Pool crea un segmento en su cuenta que es exclusivo para su cuenta y la región.
No es necesario realizar ninguna tarea de configuración para administrar estos buckets de S3. El WorkSpaces servicio los gestiona en su totalidad. Los archivos de registro que se almacenan en cada bucket se cifran en tránsito mediante puntos de enlace SSL de Amazon S3 y en reposo, mediante claves de cifrado administradas por Amazon S3. Los nombres de los buckets siguen el formato específico que se indica a continuación:
```
wspool-logs---random-identifier
```
**``**
Este es el código de AWS región en el que se crea el WorkSpaces pool con el almacenamiento en bucket de Amazon S3 habilitado para los registros de scripts de sesión.
**``**
Su identificador de cuenta de Amazon Web Services. El ID aleatorio garantiza que no haya ningún conflicto con otros buckets en esa región. La primera parte del nombre del bucket, `wspool-logs`, no cambia entre cuentas o regiones.
Por ejemplo, si especifica los scripts de sesión en una imagen de la región EE.UU. Oeste (Oregón) (`us-west-2`) en el número de cuenta`123456789012`, WorkSpaces Pool crea un bucket de Amazon S3 en su cuenta de esa región con el nombre que se muestra. Este bucket solo lo puede eliminar un administrador con permisos suficientes.
```
wspool-logs-us-west-2-1234567890123-abcdefg
```
Al deshabilitar scripts de sesión, no se eliminarán los archivos de registro almacenados en el bucket de S3. Para eliminar permanentemente los archivos de registro, usted u otro administrador con los permisos adecuados deben hacerlo mediante la consola o la API de Amazon S3. WorkSpaces Pools añade una política de bucket que evita la eliminación accidental del bucket.
Cuando se habilitan los scripts de sesión, se crea una carpeta única para cada sesión de streaming que se inicia.
La ruta de la carpeta donde se almacenan los archivos de registro en el bucket de S3 en la cuenta utiliza la siguiente estructura:
```
//////SessionScriptsLogs/
```
******
El nombre del bucket de S3 en el que se almacenan los scripts de sesión. El formato del nombre se describe anteriormente en esta sección.
******
El nombre de la pila de la que procede la sesión.
******
El nombre del WorkSpaces grupo en el que se ejecuta el script de la sesión.
******
El método de identidad del usuario: `custom` para la WorkSpaces API o la CLI, `federated` para SAML y `userpool` para los usuarios del grupo de usuarios.
******
El nombre de carpeta específico del usuario. Este nombre se ha creado utilizando una cadena hexadecimal con hasta SHA-256 en minúsculas generada a partir del identificador de usuario.
******
El identificador de la sesión de streaming del usuario. Cada sesión de streaming del usuario genera un identificador único.
******
El evento que generó el registro de script de sesión. Los valores del evento son: `SessionStart` y `SessionTermination`.
La siguiente estructura de carpetas de ejemplo se aplica a una sesión de streaming que se inicia desde la pila de prueba y la flota de prueba. La sesión utiliza la API del ID de usuario`testuser@mydomain.com`, a partir de un Cuenta de AWS ID de `123456789012` y el grupo de configuración `test-stack` de la región EE.UU. Oeste (Oregón) (`us-west-2`):
```
wspool-logs-us-west-2-1234567890123-abcdefg/test-stack/test-fleet/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13/05yd1391-4805-3da6-f498-76f5x6746016/SessionScriptsLogs/SessionStart/
```
Esta estructura de carpetas de ejemplo contiene un archivo de registro para un script de inicio de sesión del contexto del usuario y un archivo de registro para un script de inicio de sesión del contexto del sistema, si procede.