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.
# Imágenes
Puede crear imágenes de Amazon WorkSpaces Applications que contengan aplicaciones que pueda transmitir a sus usuarios y la configuración predeterminada del sistema y las aplicaciones para que los usuarios puedan empezar a utilizar esas aplicaciones rápidamente. Sin embargo, no se puede cambiar una imagen después de crearla. Para añadir otras aplicaciones, actualizar las aplicaciones existentes o cambiar la configuración de las imágenes, debe iniciar y volver a conectar al generador de imágenes que utilizó para crear la imagen. Si eliminó dicho generador de imágenes, lance un nuevo generador de imágenes basado en su imagen. A continuación, realice los cambios y cree una nueva imagen. Para obtener más información, consulte [Lanzar un generador de imágenes para instalar y configurar aplicaciones de streaming](tutorial-image-builder-create.md) y [Tutorial: Crear una imagen de WorkSpaces aplicaciones personalizada mediante la consola de WorkSpaces aplicaciones](tutorial-image-builder.md).
Las imágenes que tiene a su disposición aparecen en el **registro de imágenes** de la consola de WorkSpaces aplicaciones. Se clasifican como públicas, privadas o compartidas. Puede utilizar cualquiera de estos tipos de imágenes para iniciar un generador de imágenes y configurar una flota de WorkSpaces aplicaciones. Las imágenes compartidas son propiedad de otras cuentas de Amazon Web Services y se comparten con el usuario. Los permisos definidos en imágenes que se compartan con el usuario podrían limitar lo que puede hacer con dichas imágenes. Para obtener más información, consulte [Administre WorkSpaces las imágenes de sus aplicaciones de Amazon](administer-images.md).
**Topics**
+ [Configuración predeterminada de aplicaciones y Windows y rendimiento de lanzamiento de aplicaciones en Amazon WorkSpaces Applications](customizing-appstream-images.md)
+ [Gestione WorkSpaces las versiones del agente de aplicaciones](base-images-agent.md)
+ [WorkSpaces Notas de lanzamiento de Applications Agent](agent-software-versions.md)
+ [Tutorial: Crear una imagen de WorkSpaces aplicaciones personalizada mediante la consola de WorkSpaces aplicaciones](tutorial-image-builder.md)
+ [Administre WorkSpaces las imágenes de sus aplicaciones de Amazon](administer-images.md)
+ [Cree la imagen de sus WorkSpaces aplicaciones de Amazon mediante programación mediante las operaciones CLI de Image Assistant](programmatically-create-image.md)
+ [Creación de imágenes basadas en Linux](create-linux-based-images.md)
+ [Usa scripts de sesión para gestionar la experiencia de streaming de tus usuarios de Amazon WorkSpaces Applications](use-session-scripts.md)
# Configuración predeterminada de aplicaciones y Windows y rendimiento de lanzamiento de aplicaciones en Amazon WorkSpaces Applications
Puede crear una configuración predeterminada de las aplicaciones y de Windows para permitir a los usuarios empezar a trabajar con las aplicaciones rápidamente, sin necesidad de crear o configurar los ajustes.
WorkSpaces Applications optimiza el rendimiento de lanzamiento de sus aplicaciones para las sesiones de streaming de sus usuarios. Para asegurarse de que todos los archivos requeridos estén incluidos en este proceso, es posible que tenga que añadir manualmente determinados archivos y carpetas al manifiesto de optimización.
**Topics**
+ [Creación de la configuración predeterminada de aplicaciones y de Windows para los usuarios de sus WorkSpaces aplicaciones](creating-default-app-Windows-settings.md)
+ [Optimización del rendimiento de lanzamiento de sus aplicaciones en Amazon WorkSpaces Applications](optimizing-app-launch-performance.md)
# Creación de la configuración predeterminada de aplicaciones y de Windows para los usuarios de sus WorkSpaces aplicaciones
Las personalizaciones de aplicaciones y la configuración de Windows que se guardan en la carpeta de perfil de usuario de Windows o el subárbol de registro de usuario se pueden establecer como predeterminadas. Al guardar la configuración predeterminada mediante la **plantilla User** en Image Assistant, WorkSpaces Applications reemplaza el perfil de usuario predeterminado de Windows por el perfil que usted configure. El perfil de usuario predeterminado de Windows se utiliza a continuación para crear la configuración inicial para los usuarios en la instancia de la flota. Si la configuración de Windows o de aplicaciones que ha configurado no funciona en la flota, confirme que se guarda en el perfil de usuario de Windows. Para obtener más información, consulte Paso 3: creación de la configuración predeterminada de las aplicaciones y de Windows en [Tutorial: Crear una imagen de WorkSpaces aplicaciones personalizada mediante la consola de WorkSpaces aplicaciones](tutorial-image-builder.md).
Entre la configuración predeterminada que puede crear y configurar se incluye:
+ Preferencias de las aplicaciones, incluidas una página de inicio del navegador, personalizaciones de la barra de herramientas y ajustes de seguridad.
+ Ajustes para los datos de las aplicaciones, incluidos los marcadores del navegador y los perfiles de conexión.
+ Ajustes de la experiencia de Windows, incluidos la visualización de las extensiones de nombres de los archivos y de las carpetas ocultas.
Además, puede modificar o deshabilitar la configuración de seguridad de Internet Explorer, como la configuración de seguridad mejorada (ESC). Para obtener más información, consulte [Desactivar la configuración de seguridad mejorada de Internet Explorer en WorkSpaces las aplicaciones de Amazon](customize-fleets-disable-ie-esc.md).
# Optimización del rendimiento de lanzamiento de sus aplicaciones en Amazon WorkSpaces Applications
Al crear una imagen, WorkSpaces Applications requiere que optimice el rendimiento de lanzamiento de sus aplicaciones para las sesiones de streaming de sus usuarios. Cuando las aplicaciones se abren durante este proceso, asegúrese de que utilizan los componentes iniciales requeridos por sus usuarios. De esta forma, garantiza que estos componentes se capturan por el proceso de optimización. En algunos casos, no se detectan todos los archivos necesarios para las optimizaciones. Entre los ejemplos de este tipo de archivos se encuentran los complementos o componentes que no se abren en el generador de imágenes. Para asegurarse de que se capturen todos los archivos y carpetas necesarios para la aplicación, puede incluirlos en el manifiesto de optimización. La adición de archivos al manifiesto de optimización podría aumentar el tiempo necesario para que se creen las instancias de la flota y para que estén disponibles para los usuarios. Sin embargo, al hacerlo, se reduce el tiempo que tarda la aplicación en lanzarse por primera vez en la instancia de la flota.
Para optimizar todos los archivos de una carpeta, abra PowerShell y utilice el siguiente PowerShell comando:
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```
De forma predeterminada, Image Assistant reemplaza el manifiesto de optimización de la aplicación cada vez que se ejecuta el paso **Optimizar** de Image Assistant. Debe ejecutar el PowerShell comando para optimizar todos los archivos de una carpeta:
+ Cada vez que se ejecute el paso **Optimizar**.
+ Antes de elegir **Desconectar y crear imagen** en la página **Revisión** de Image Assistant.
También puede especificar el manifiesto de optimización para cada aplicación mediante las operaciones de la interfaz de la línea de comandos (CLI) de Image Assistant. Al especificar el manifiesto de optimización mediante las operaciones CLI de Image Assistant, WorkSpaces Applications combina el manifiesto de optimización de la aplicación especificado con los archivos identificados en el paso de **optimización** de Image Assistant. Para obtener más información, consulte [Cree la imagen de sus WorkSpaces aplicaciones de Amazon mediante programación mediante las operaciones CLI de Image Assistant](programmatically-create-image.md).
# Gestione WorkSpaces las versiones del agente de aplicaciones
El agente de WorkSpaces aplicaciones es un software que se ejecuta en las instancias de streaming y permite a los usuarios transmitir aplicaciones. Cuando se crea una imagen, la opción **Always use latest agent version (Utilizar siempre la última versión del agente)** está seleccionada de forma predeterminada. Cuando se selecciona esta opción, los nuevos creadores de imágenes o las instancias de flota que se lanzan desde su imagen siempre utilizan la versión más reciente del agente de WorkSpaces aplicaciones. Es posible que desee controlar las actualizaciones del agente para garantizar la compatibilidad con su software o para cualificar el entorno actualizado antes de implementarlo para sus usuarios finales.
Los siguientes procedimientos describen cómo administrar las versiones del agente de WorkSpaces aplicaciones.
**Topics**
+ [Cree una imagen que utilice siempre la versión más reciente del agente de WorkSpaces aplicaciones](create-image-that-always-uses-latest-agent.md)
+ [Cree una imagen que utilice una versión específica del Agente de WorkSpaces aplicaciones](create-image-that-uses-specific-agent.md)
+ [Cree una imagen que utilice una versión más reciente del Agente de WorkSpaces aplicaciones](create-image-that-uses-newer-agent.md)
# Cree una imagen que utilice siempre la versión más reciente del agente de WorkSpaces aplicaciones
Cuando las imágenes se configuran para utilizar siempre la versión más reciente del agente de WorkSpaces aplicaciones, las instancias de streaming se actualizan automáticamente con las funciones, mejoras de rendimiento y actualizaciones de seguridad más recientes que estén disponibles a partir del AWS lanzamiento de una nueva versión del agente.
**nota**
En algunos casos, una nueva versión del agente de WorkSpaces aplicaciones podría entrar en conflicto con el software. Le recomendamos que califique la nueva versión del agente de WorkSpaces aplicaciones antes de implementarla en sus flotas de producción.
**Para crear una imagen que utilice siempre la última versión del agente de WorkSpaces aplicaciones**
1. Abra la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).
1. Haga una de estas dos operaciones:
+ Si tiene un constructor de imágenes que desea utilizar para crear la imagen, inicie el constructor de imágenes y, a continuación, conéctese al mismo. Si el generador de imágenes no ejecuta la última versión del agente de WorkSpaces aplicaciones, se le solicitará que elija si desea iniciar el generador de imágenes con el agente más reciente. Asegúrese de que esta opción está seleccionada, elija **Start (Comenzar)** y, a continuación, conéctese al constructor de imágenes.
+ Si no tiene un constructor de imágenes que desea utilizar para crear la imagen, lance un nuevo constructor de imágenes. En el **paso 1: elija una imagen**, elija una imagen AWS base o una imagen personalizada. En el **paso 2: Configurar Image Builder**, si la imagen que ha elegido no ejecuta la última versión del agente de WorkSpaces aplicaciones, aparece la sección **WorkSpaces Aplicaciones**. En la lista **Agent version (Versión del agente)**, seleccione la versión del agente más reciente. Complete los demás pasos para crear el constructor de imágenes y, a continuación, conéctese al mismo. Para obtener más información, consulte [Lanzar un generador de imágenes para instalar y configurar aplicaciones de streaming](tutorial-image-builder-create.md).
1. En el escritorio del constructor de imágenes, abra Image Assistant y siga los pasos para crear su nueva imagen. En el paso **Configure Image (Configurar imagen)**, asegúrese de que **Always use the latest agent version (Utilizar siempre la versión más reciente del agente)** está seleccionado. Para obtener más información, consulte [Tutorial: Crear una imagen de WorkSpaces aplicaciones personalizada mediante la consola de WorkSpaces aplicaciones](tutorial-image-builder.md).
Si más adelante decide no utilizar siempre la última versión del agente de WorkSpaces aplicaciones, debe crear una imagen nueva y desactivar esa opción.
1. Cree una nueva flota o especifique una existente. Al configurar la flota, seleccione la nueva imagen que ha creado. Para obtener más información, consulte [Cree una flota y una pila de WorkSpaces aplicaciones de Amazon](set-up-stacks-fleets.md).
1. Creación de una nueva pila o modificación de una existente y su asociación a la flota.
# Cree una imagen que utilice una versión específica del Agente de WorkSpaces aplicaciones
Es posible que desee controlar WorkSpaces las actualizaciones del agente de aplicaciones en lugar de utilizar siempre la última versión para poder probar primero la compatibilidad. Para garantizar que la versión del agente de WorkSpaces aplicaciones que utilice sea compatible con sus aplicaciones de streaming, puede crear una imagen que utilice una versión específica del software del agente. A continuación, realice las pruebas de cualificación en una flota independiente antes de la implementación en su flota de producción.
Al crear una nueva imagen, asegúrese de que la opción **Always use latest agent version (Utilizar siempre la versión más reciente del agente)** no está seleccionada. De este modo, la imagen se anclará en la versión del agente de WorkSpaces aplicaciones que seleccionó al iniciar el generador de imágenes, en lugar de utilizar siempre la versión más reciente. Una vez terminadas las pruebas de cualificación, puede actualizar la flota de producción con la imagen.
**Para crear una imagen que utilice una versión específica del agente de WorkSpaces aplicaciones**
1. Abra la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).
1. Haga una de estas dos operaciones:
+ Si tiene un constructor de imágenes que desea utilizar para crear la imagen, inicie el constructor de imágenes y, a continuación, conéctese al mismo.
+ Si no tiene un constructor de imágenes que desea utilizar para crear la imagen, lance un nuevo constructor de imágenes. En el **paso 1: elija una imagen**, elija una imagen AWS base o una imagen personalizada. En el **paso 2: Configurar Image Builder**, si la imagen que ha elegido no ejecuta la última versión del agente de WorkSpaces aplicaciones, aparece la sección **WorkSpaces Aplicaciones**. En la lista **Agent version (Versión del agente)**, no seleccione la versión del agente más reciente. Complete los demás pasos para crear el constructor de imágenes y, a continuación, conéctese al mismo. Para obtener más información, consulte [Lanzar un generador de imágenes para instalar y configurar aplicaciones de streaming](tutorial-image-builder-create.md).
1. En el escritorio del constructor de imágenes, abra Image Assistant y siga los pasos para crear su nueva imagen. En el paso **Configure Image (Configurar imagen)** en Image Assistant, asegúrese de que **Always use the latest agent version (Utilizar siempre la versión más reciente del agente)** no está seleccionado. Para obtener más información, consulte [Tutorial: Crear una imagen de WorkSpaces aplicaciones personalizada mediante la consola de WorkSpaces aplicaciones](tutorial-image-builder.md).
Si más adelante decide utilizar siempre la última versión del agente de WorkSpaces aplicaciones, debe crear una imagen nueva y seleccionar esa opción.
1. Cree una nueva flota o especifique una existente. Al configurar la flota, seleccione la nueva imagen que ha creado. Para obtener más información, consulte [Cree una flota y una pila de WorkSpaces aplicaciones de Amazon](set-up-stacks-fleets.md).
1. Creación de una nueva pila o modificación de una existente y su asociación a la flota.
1. Conéctese a la flota y compruebe la compatibilidad de las aplicaciones.
# Cree una imagen que utilice una versión más reciente del Agente de WorkSpaces aplicaciones
Si fija la imagen a una versión específica del agente de WorkSpaces aplicaciones, debe actualizarla a una versión más reciente mediante la creación de una imagen nueva. Este enfoque le permite probar primero la compatibilidad de cada actualización del agente y, a continuación, actualizar la flota de forma incremental.
Al crear una nueva imagen, asegúrese de que la opción **Always use latest agent version (Utilizar siempre la versión más reciente del agente)** no está seleccionada. Después de crear su imagen, realice las pruebas de cualificación en una flota independiente antes de la implementación en su flota de producción. Una vez terminadas las pruebas de cualificación, puede actualizar la flota de producción con la imagen.
**Para crear una imagen que utilice una versión más reciente del agente de WorkSpaces aplicaciones**
1. Abra la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).
1. Haga una de estas dos operaciones:
+ Si tiene un constructor de imágenes que desea utilizar para crear la imagen, inicie el constructor de imágenes y, a continuación, conéctese al mismo. Si el generador de imágenes no ejecuta la última versión del agente de WorkSpaces aplicaciones, se le solicitará que elija si desea iniciar el generador de imágenes con el agente más reciente. Asegúrese de que esta opción está seleccionada, elija **Start (Comenzar)** y, a continuación, conéctese al constructor de imágenes.
+ Si no tiene un constructor de imágenes que desea utilizar para crear la imagen, lance un nuevo constructor de imágenes. En el **paso 1: elija una imagen**, elija una imagen AWS base o una imagen personalizada. En el **paso 2: Configurar Image Builder**, si la imagen que ha elegido no ejecuta la última versión del agente de WorkSpaces aplicaciones, aparece la sección **WorkSpaces Aplicaciones**. En la lista **Agent version (Versión del agente)**, seleccione la versión del agente más reciente. Complete los demás pasos para crear el constructor de imágenes y, a continuación, conéctese al mismo. Para obtener más información, consulte [Lanzar un generador de imágenes para instalar y configurar aplicaciones de streaming](tutorial-image-builder-create.md).
1. En el escritorio del constructor de imágenes, abra Image Assistant y siga los pasos para crear su nueva imagen. En el paso **Configure Image (Configurar imagen)** en Image Assistant, asegúrese de que **Always use the latest agent version (Utilizar siempre la versión más reciente del agente)** no está seleccionado. Para obtener más información, consulte [Tutorial: Crear una imagen de WorkSpaces aplicaciones personalizada mediante la consola de WorkSpaces aplicaciones](tutorial-image-builder.md).
Si más adelante decide utilizar siempre la última versión del agente de WorkSpaces aplicaciones, debe crear una imagen nueva y seleccionar esa opción.
1. Cree una nueva flota o especifique una existente. Al configurar la flota, seleccione la nueva imagen que ha creado. Para obtener más información, consulte [Cree una flota y una pila de WorkSpaces aplicaciones de Amazon](set-up-stacks-fleets.md).
1. Creación de una nueva pila o modificación de una existente y su asociación a la flota.
1. Conéctese a la flota y compruebe la compatibilidad de las aplicaciones.
# WorkSpaces Notas de lanzamiento de Applications Agent
El software agente de Amazon WorkSpaces Applications se ejecuta en sus instancias de streaming, lo que permite a los usuarios finales conectarse a sus aplicaciones de streaming e iniciarlas. A partir del 7 de diciembre de 2017, sus instancias de streaming se podrán actualizar automáticamente con las funciones, mejoras de rendimiento y actualizaciones de seguridad más recientes que estén disponibles en AWS. Antes del 7 de diciembre de 2017, las actualizaciones del agente se incluían con las versiones nuevas de la imagen base.
Para utilizar el software de agente de WorkSpaces aplicaciones más reciente, debe reconstruir las imágenes con las nuevas imágenes base publicadas a más tardar AWS el 7 de diciembre de 2017 o después de esa fecha. Al hacerlo, la opción para habilitar las actualizaciones automáticas del agente está seleccionada de forma predeterminada en Image Assistant. Le recomendamos que deje seleccionada esta opción para que cualquier instancia de flota o del constructor de imágenes que se lance desde la imagen siempre utilice la versión más reciente del agente. Para obtener más información, consulte [Tutorial: Crear una imagen de WorkSpaces aplicaciones personalizada mediante la consola de WorkSpaces aplicaciones](tutorial-image-builder.md).
En la siguiente tabla se describen las actualizaciones más recientes disponibles en las versiones publicadas del agente de WorkSpaces aplicaciones para las instancias de Windows.
| Versión del agente WorkSpaces de Amazon Applications | Cambios |
| --- | --- |
| 02-09-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-04-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-06-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-02-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 30-09-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-15-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 29-05-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-05-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-07-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-31-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-21-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 18-09-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 21-05-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 04-15-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 17/01/2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-07-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-06-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 30-05-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-08-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 13-04-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 21-03-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 13-10-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 06-20-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 13-03-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 21-02-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 20 de diciembre de 2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 19 de octubre de 2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 08-02-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-01-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 25-06-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 17-05-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 3 de abril de 2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 17 de diciembre de 2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-04-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 17 de diciembre de 2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-08-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-01-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 30-07-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 27/05/2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 20-04-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 19-02-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 13-01-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 13-11-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 08-10-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 23-09-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-03-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 08-08-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 26/07/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 19/06/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 07/05/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 02/04/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 07/03/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 22/01/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 08/01/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 19/12/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 17/12/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 04/12/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 14/11/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 30/10/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 24/10/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 01/10/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 29/08/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 26/07/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 19/06/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 06/06/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 31/05/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 21-05-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 19/03/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 24/01/2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
| 07/12/2017 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/agent-software-versions.html) |
# Tutorial: Crear una imagen de WorkSpaces aplicaciones personalizada mediante la consola de WorkSpaces aplicaciones
Este tutorial describe cómo crear imágenes de WorkSpaces aplicaciones basadas en los sistemas operativos Microsoft Windows Server. Si desea crear imágenes personalizadas basadas en los sistemas operativos Amazon Linux 2, Rocky Linux o Red Hat Enterprise Linux, consulte [Tutorial: Crear una imagen personalizada de aplicaciones basadas en Linux WorkSpaces](tutorial-create-linux-image.md).
En este tutorial, aprenderá a crear una imagen de Amazon WorkSpaces Applications personalizada que contenga aplicaciones que pueda transmitir a sus usuarios y la configuración predeterminada de aplicaciones y Windows para que los usuarios puedan empezar a utilizar sus aplicaciones rápidamente. Para completar este tutorial, ya debe disponer de un generador de imágenes. Si no tiene un generador de imágenes, consulte [Lanzar un generador de imágenes para instalar y configurar aplicaciones de streaming](tutorial-image-builder-create.md).
**importante**
Este tutorial incluye información que se refiere a la última versión de la imagen base. Para obtener más información, consulte [WorkSpaces Notas de la versión de la actualización de imágenes base e imágenes gestionadas de aplicaciones](base-image-version-history.md).
**Topics**
+ [Paso 1: instalación de aplicaciones en el generador de imágenes](#tutorial-image-builder-install)
+ [Paso 2: Crear un catálogo de WorkSpaces aplicaciones y aplicaciones](#tutorial-image-builder-add)
+ [Paso 3: creación de la configuración predeterminada de las aplicaciones y de Windows](#tutorial-image-builder-create-default-app-settings)
+ [Paso 4: prueba de las aplicaciones](#tutorial-image-builder-test-applications)
+ [Paso 5: optimización de las aplicaciones](#tutorial-image-builder-optimize)
+ [Paso 6: finalización de la creación de la imagen](#tutorial-image-builder-finish-create-image)
+ [Paso 7 (opcional): etiquetado y copia de una imagen](#tutorial-image-builder-tag-copy)
+ [Paso 8: eliminación](#tutorial-image-builder-finish)
## Paso 1: instalación de aplicaciones en el generador de imágenes
En este paso, se conecta un generador de imágenes y se instalan sus aplicaciones en el generador de imágenes.
**importante**
Para completar este paso, debe iniciar sesión en el generador de imágenes con la cuenta **Administrator** local o con una cuenta de usuario de dominio que tenga permisos de administrador local. No cambie el nombre ni elimine la cuenta de **administrador** integrada local. Si lo hace, el generador de imágenes no se iniciará y se producirá un error al crear la imagen.
**Para instalar aplicaciones en el generador de imágenes**
1. Conéctese al constructor de imágenes mediante uno de los siguientes métodos:
+ [Utilice la consola de WorkSpaces aplicaciones](managing-image-builders-connect-console.md) (solo para conexiones web)
+ [Cree una URL de transmisión](managing-image-builders-connect-streaming-URL.md) (para conexiones de clientes web o de WorkSpaces aplicaciones)
**nota**
Si el generador de imágenes al que desea conectarse está unido a un dominio de Active Directory y su organización requiere iniciar sesión con tarjeta inteligente, debe crear una URL de transmisión y utilizar el cliente de WorkSpaces aplicaciones para la conexión. Para obtener información sobre el inicio de sesión con tarjeta inteligente, consulte [Tarjetas inteligentes](feature-support-USB-devices-qualified.md#feature-support-USB-devices-qualified-smart-cards).
1. Instale las aplicaciones desde el sitio web de la aplicación o desde cualquier otro origen de descargas. Instale las aplicaciones que desee antes de continuar con el paso siguiente.
**nota**
Descargue e instale las aplicaciones solo desde sitios de confianza.
Si una aplicación requiere que se reinicie el sistema operativo Windows, hágalo. Antes de que el sistema operativo se reinicie, se desconecta de su generador de imágenes. Una vez completado el reinicio, conéctese de nuevo al generador de imágenes y termine de instalar la aplicación.
## Paso 2: Crear un catálogo de WorkSpaces aplicaciones y aplicaciones
En este paso, cree un catálogo de WorkSpaces aplicaciones especificando las aplicaciones (*.exe*), los scripts por lotes (*.bat*) y los atajos de aplicaciones (*.lnk*) para la imagen. Para cada aplicación que tenga previsto transmitir, puede especificar el nombre, el nombre de visualización, el archivo ejecutable que se va a lanzar y el icono que se mostrará. Si elige un acceso directo a la aplicación, estos valores se rellenan automáticamente.
**importante**
Para completar este paso, debe haber iniciado sesión en el generador de imágenes con la cuenta **Administrator (Administrador)** local o con una cuenta de dominio que tenga permisos de administrador local.
**Para crear un catálogo de aplicaciones y aplicaciones WorkSpaces**
1. En el escritorio del generador de imágenes, abra Image Assistant. Image Assistant le guía a través del proceso de creación de imágenes.
![\[Row of icons representing different functions in Image Assistant interface.\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/images/Image-Builder-Desktop-Image-Assistant.png)
1. En **1. Añadir aplicaciones**, elija **\$1 Añadir aplicación** y desplácese hasta la ubicación de la aplicación, el script o el acceso directo que desee añadir. Elija **Open**.
1. En el cuadro de diálogo **Configuración para lanzar la aplicación**, conserve o modifique la configuración predeterminada de **Nombre**, **Nombre de visualización** e **Ruta de icono**. Si lo prefiere, puede especificar parámetros de lanzamiento (argumentos adicionales que se pasan a la aplicación al lanzarla) y un directorio de trabajo para la aplicación. Cuando haya terminado, elija **Guardar**.
Las opciones **Nombre de visualización** y **Ruta de icono** determinan cómo aparecerán el nombre y el icono de la aplicación en el catálogo de aplicaciones. El catálogo se muestra a los usuarios cuando inician sesión en una sesión de streaming de WorkSpaces aplicaciones.
1. Repita los pasos 2 y 3 para cada aplicación en Image Assistant y confirme que las aplicaciones aparecen en la pestaña **Añadir aplicaciones**. Cuando haya terminado, elija **Siguiente** para seguir utilizando Image Assistant para crear la imagen.
## Paso 3: creación de la configuración predeterminada de las aplicaciones y de Windows
En este paso, creará la configuración predeterminada de la aplicación y de Windows para los usuarios de WorkSpaces las aplicaciones. De este modo, los usuarios podrán empezar a utilizar las aplicaciones rápidamente durante sus sesiones de streaming de WorkSpaces aplicaciones, sin necesidad de crear o configurar estos ajustes ellos mismos.
**importante**
Para completar este paso, debe haber iniciado sesión en el generador de imágenes con la cuenta **Usuario de plantilla** local o con una cuenta de usuario de dominio que no tenga permisos de administrador local.
**Para crear la configuración predeterminada de las aplicaciones y de Windows para los usuarios**
1. En Image Assistant, en **2. Configurar aplicaciones**, elija **Cambiar de usuario**. De esta forma, se desconectará de la sesión actual y visualizará el menú de inicio de sesión.
1. Haga una de estas dos operaciones:
+ Si el generador de imágenes no se ha unido a un dominio de Active Directory, elija **Usuario de plantilla** en la pestaña **Usuario local**. Esta cuenta le permite crear la configuración predeterminada de las aplicaciones y de Windows.
+ Si el generador de imágenes se ha unido a un dominio de Active Directory, elija **Usuario de Directory** e inicie sesión como usuario de dominio que no tiene permisos de administrador local.
1. En el escritorio del generador de imágenes, abra Image Assistant, que mostrará las aplicaciones que se han añadido al crear el catálogo de aplicaciones.
1. Elija la aplicación para la que desea crear la configuración predeterminada.
1. Una vez abierta la aplicación, cree esta configuración según sea necesario.
1. Cuando haya terminado, cierre la aplicación y vuelva a Image Assistant.
1. Si ha especificado más de una aplicación en Image Assistant, repita los pasos del 4 al 6 para cada aplicación según sea necesario.
1. Si desea crear la configuración predeterminada de Windows, hágalo ahora. Cuando haya terminado, vuelva a Image Assistant.
1. Elija **Cambiar de usuario** e inicie sesión con la misma cuenta que ha utilizado para crear el catálogo de aplicaciones (una cuenta que tenga permisos de administrador local).
1. En Image Assistant, en **2. Configurar aplicaciones**, realice una de estas operaciones:
+ Si el generador de imágenes no se ha unido a un dominio de Active Directory, elija **Guardar configuración**.
+ Si el generador de imágenes se ha unido a un dominio de Active Directory, en la lista **Elegir los ajustes de usuario que se van a copiar**, elija la misma cuenta que ha utilizado para iniciar sesión en el generador de imágenes al crear la configuración predeterminada de las aplicaciones y de Windows; por último, elija **Guardar configuración**.
La lista **Elegir los ajustes de usuario que se van a copiar** muestra las cuentas de usuario cuyos ajustes se han guardado en el generador de imágenes.
1. Cuando haya terminado, elija **Siguiente** para seguir creando la imagen.
## Paso 4: prueba de las aplicaciones
En este paso, comprobará que las aplicaciones que ha añadido se abren correctamente y funcionan según lo previsto. Para ello, iniciará una sesión de Windows con un usuario que tenga los mismos permisos que los usuarios finales.
**importante**
Para completar este paso, debe iniciar sesión en el generador de imágenes con la cuenta **Usuario de prueba** o con una cuenta de usuario de dominio que no tenga permisos de administrador local.
**Para probar las aplicaciones**
1. En Image Assistant, en **3. Probar**, realice una de las operaciones siguientes:
+ Si el generador de imágenes no se ha unido a un dominio de Active Directory, elija **Cambiar de usuario**.
+ Si el generador de imágenes se ha unido a un dominio de Active Directory, necesitará una cuenta de dominio para probar las aplicaciones, y si el usuario ya ha guardado ajustes en el generador de imágenes, deberá restablecer la configuración de la aplicación para ese usuario. Para ello, seleccione el usuario en la lista **Usuario que se va a restablecer** y elija **Restablecer**. Elija **Cambiar de usuario** cuando haya terminado.
**nota**
Si el generador de imágenes es nuevo y ningún usuario ha guardado ajustes en él, la lista no muestra ningún usuario.
1. Elija la cuenta de usuario que se va a utilizar para la realización de las pruebas mediante una de las acciones siguientes:
+ Si el generador de imágenes no se ha unido a un dominio de Active Directory, elija **Usuario de prueba**. Esta cuenta le permite probar las aplicaciones utilizando las mismas políticas y los mismos permisos que los usuarios.
+ Si el generador de imágenes se ha unido a un dominio de Active Directory, elija **Usuario de Directory**, especifique las credenciales de una cuenta de usuario de dominio que no tenga permisos de administrador local y, a continuación, elija **Iniciar sesión**.
1. En el escritorio del generador de imágenes, abra Image Assistant, que mostrará las aplicaciones que se han especificado al crear el catálogo de aplicaciones.
1. Elija la aplicación que desea probar para confirmar que se abre correctamente y que se aplica la configuración predeterminada que ha creado.
1. Una vez abierta la aplicación, pruébela según sea necesario. Cuando haya terminado, cierre la aplicación y vuelva a Image Assistant.
1. Si ha especificado más de una aplicación en Image Assistant, repita los pasos 4 y 5 para probar cada aplicación según sea necesario.
1. Cuando haya terminado, elija **Cambiar de usuario** y realice una de las operaciones siguientes:
+ Si el generador de imágenes no se ha unido a un dominio de Active Directory, elija **Administrador** en la pestaña **Usuario local**.
+ Si el generador de imágenes se ha unido a un dominio de Active Directory e inició sesión como usuario de dominio con permisos de administrador local para especificar aplicaciones en Image Assistant, inicie sesión como dicho usuario.
1. Elija **Siguiente** para seguir creando la imagen.
## Paso 5: optimización de las aplicaciones
En este paso, Image Assistant abre las aplicaciones una detrás de otra, identifica sus dependencias de lanzamiento y realiza optimizaciones para garantizar que las aplicaciones se inician rápidamente. Estos son pasos obligatorios que se llevan a cabo en todas las aplicaciones de la lista.
**Para optimizar las aplicaciones**
1. En Image Assistant, en **4. Optimizar**, elija **Lanzar**.
1. WorkSpaces Aplicaciones lanza automáticamente la primera aplicación de la lista. Cuando la aplicación se haya iniciado por completo, facilite las acciones necesarias para llevar a cabo la experiencia de primer uso de la aplicación. Por ejemplo, un navegador web podría solicitar que se importen unos ajustes para que pueda funcionar a pleno rendimiento.
1. Una vez que haya completado la experiencia de primer uso y comprobado que la aplicación se comporta según lo previsto, elija **Continuar**. Si ha añadido más de una aplicación a la imagen, cada una se abrirá automáticamente. Repita este paso para cada aplicación según sea necesario, dejando todas las aplicaciones en ejecución.
1. Cuando haya terminado, se mostrará automáticamente la pestaña de Image Assistant **5. Configurar imagen**.
## Paso 6: finalización de la creación de la imagen
En este paso, elegirá un nombre de imagen y terminará de crear la imagen.
**Para crear la imagen**
1. Escriba un nombre de imagen exclusivo y, opcionalmente, el nombre para mostrar y descripción de la imagen. El nombre de la imagen no puede empezar por «Amazon»AWS, «» o «»AppStream.
También puede añadir una o varias etiquetas a la imagen. Para ello, elija **Añadir etiqueta** y escriba la clave y el valor de la etiqueta. Para añadir más etiquetas, repita este paso. Para obtener más información, consulte [Cómo etiquetar los recursos de tus WorkSpaces aplicaciones de Amazon](tagging-basic.md). Cuando haya terminado, elija **Siguiente**.
**nota**
Si elige una imagen base que se publique a más tardar AWS el 7 de diciembre de 2017, aparecerá la opción **Usar siempre la última versión del agente**, seleccionada de forma predeterminada. Le recomendamos que deje esta opción seleccionada para que las instancias de streaming que se lancen desde la imagen siempre utilicen la versión más reciente del agente. Si deshabilita esta opción, no puede volver a habilitarla después de finalizar la creación de la imagen. Para obtener información sobre la última versión del agente de WorkSpaces aplicaciones, consulte[WorkSpaces Notas de lanzamiento de Applications Agent](agent-software-versions.md).
1. En **6. Revisar**, revise los detalles de la imagen. Para realizar cambios, elija **Anterior** con objeto de desplazarse a la pestaña de Image Assistant adecuada, realice los cambios pertinentes y, a continuación, lleve a cabo los pasos que indique Image Assistant según sea necesario.
1. Una vez que termine de revisar los detalles de la imagen, elija **Desconectar y crear imagen**.
1. La sesión remota se desconecta al cabo de un momento. Cuando aparezca el mensaje **Se ha perdido la conectividad**, cierre la pestaña del navegador. Aunque la imagen se ha creado, el estado del generador de imágenes aparece como **Creando instantáneas**. No puede conectarse al generador de imágenes hasta que este proceso termine.
1. Vuelva a la consola y desplácese hasta **Imágenes**, **Registro de imágenes**. Compruebe que la nueva imagen aparezca en la lista.
Aunque la imagen se está creando, su estado en el registro de imágenes de la consola aparece como **Pendiente** y no se podrá conectar con ella.
1. Elija el icono **Actualizar** periódicamente para actualizar el estado. Una vez creada la imagen, su estado cambia a **Disponible** y el generador de imágenes se detiene automáticamente.
Para seguir trabajando en la creación de imágenes, inicie el generador de imágenes y conéctese a él desde la consola, o bien cree un nuevo generador de imágenes.
**nota**
Una vez creada la imagen, usted es responsable de mantener las actualizaciones del sistema operativo Windows. Para ello, puede utilizar las actualizaciones de imágenes de WorkSpaces las aplicaciones gestionadas. También es responsable del mantenimiento de las actualizaciones de las aplicaciones y sus dependencias. Para obtener más información, consulte [Conserve la imagen de sus WorkSpaces aplicaciones de Amazon Up-to-Date](keep-image-updated.md).
Para añadir otras aplicaciones, actualice las aplicaciones existentes o cambie la configuración de las imágenes, debe iniciar y volver a conectar al generador de imágenes que utilizó para crear la imagen. O, si eliminó dicho constructor de imágenes, lance un nuevo constructor de imágenes basado en su imagen. A continuación, realice los cambios y cree una nueva imagen.
## Paso 7 (opcional): etiquetado y copia de una imagen
Puede añadir una o varias etiquetas a una imagen al crearla o después de haberla creado. También puede copiar la imagen dentro de la misma región o en una nueva región dentro de la misma cuenta de Amazon Web Services. Al copiar una imagen de origen, se obtiene una imagen de destino idéntica pero distinta. AWS Sin embargo, no copia ninguna etiqueta definida por el usuario. Además, solo puede copiar las imágenes personalizadas que cree, no las imágenes base proporcionadas por AWS.
**nota**
Puede copiar hasta dos imágenes al mismo tiempo a un destino. Si el destino al que se va a copiar una imagen se encuentra en el límite de imagen, recibe un error. Para copiar la imagen en este caso, primero debe eliminar imágenes del destino. Una vez que el destino está por debajo de la cuota de imágenes (también denominado límite), inicie la copia de la imagen desde la región de origen. Para obtener más información, consulte [Amazon WorkSpaces Applications Service Quotas](limits.md).
**Para añadir etiquetas a una imagen existente**
1. En el panel de navegación, elija **Imágenes** e **Registro de imágenes**.
1. En la lista de imágenes, seleccione la imagen a la que desea añadir etiquetas.
1. Elija **Etiquetas**, seguido de **Agregar o editar etiquetas** y de **Agregar etiquetas**, especifique la clave y el valor de la etiqueta y, a continuación, elija **Guardar**.
Para obtener más información, consulte [Cómo etiquetar los recursos de tus WorkSpaces aplicaciones de Amazon](tagging-basic.md).
**Para copiar una imagen**
Copiar una imagen entre regiones geográficamente distribuidas le permite transmitir aplicaciones desde varias regiones basadas en la misma imagen. Al transmitir sus aplicaciones más cerca de sus usuarios, puede mejorar la experiencia de los usuarios al transmitir WorkSpaces aplicaciones con Applications.
1. En el panel de navegación, elija **Imágenes** e **Registro de imágenes**.
1. En la lista de imágenes, seleccione la imagen que desea copiar.
1. Elija **Acciones**, **Copiar**.
1. En el cuadro de diálogo **Copiar imagen**, especifique la información siguiente y, a continuación, elija **Copiar imagen:**.
+ Para **Región de destino**, elija la región en la que desea copiar la nueva imagen.
+ Para **Nombre**, especifique un nombre que tendrá la imagen cuando se copie al destino.
+ Para **Descripción** (opcional), especifique una descripción que tendrá la imagen cuando se copie al destino.
1. Para comprobar el progreso de la operación de copia, vuelva a la consola y desplácese hasta **Imágenes**, **Registro de imágenes**. Utilice la barra de navegación para cambiar a la región de destino (si procede) y confirme que su nueva imagen aparece en la lista de imágenes.
Primero, la nueva imagen aparece con el estado **Copiando** en el registro de imágenes de la consola. Una vez que la imagen se ha creado correctamente, su estado cambia a **Disponible**, lo que significa que ya puede utilizarla para lanzar una pila y transmitir en streaming las aplicaciones.
## Paso 8: eliminación
Por último, detenga los generadores de imágenes en ejecución para liberar recursos y evitar cargos no deseados en su cuenta. Recomendamos detener todos los generadores de imágenes en ejecución que no se utilicen. Para obtener más información, consulte los [precios de WorkSpaces las aplicaciones](https://aws.amazon.com/appstream2/pricing/).
**Para detener un generador de imágenes en ejecución**
1. En el panel de navegación, elija **Imágenes**, **Generadores de imágenes** y seleccione la instancia del generador de imágenes en ejecución.
1. Elija **Acciones**, **Detener**.
# Administre WorkSpaces las imágenes de sus aplicaciones de Amazon
Las imágenes disponibles se muestran en el **registro de imágenes** de la consola de WorkSpaces aplicaciones y se clasifican según su visibilidad de la siguiente manera:
+ **Públicas**: imágenes básicas que son propiedad de y están disponibles por AWS. Las imágenes base incluyen el sistema operativo Windows más reciente y el software agente de WorkSpaces aplicaciones. Puede usar estas imágenes base para crear imágenes que incluyan sus propias aplicaciones. Para obtener información sobre las imágenes base publicadas por AWS, consulte[WorkSpaces Notas de la versión de la actualización de imágenes base e imágenes gestionadas de aplicaciones](base-image-version-history.md).
+ **Privadas**: imágenes que usted crea y son de su propiedad y que no ha compartido con otras AWS cuentas.
+ **Compartidas con otras personas**: imágenes que creas y de las que eres propietario y que has compartido con una o más AWS cuentas de la misma AWS región. Cuando compartes una imagen con otra AWS cuenta, puedes especificar si la imagen se puede usar como generador de imágenes (para crear una imagen nueva), para una flota o para ambas cosas.
+ **Compartidas conmigo**: imágenes creadas y propiedad de otra AWS cuenta de la misma AWS región y que se comparten con tu AWS cuenta. En función de los permisos que el propietario proporcionó al compartir la imagen con su cuenta, puede utilizar esta imagen para constructores de imágenes, para flotas o para ambos.
**Topics**
+ [Eliminar una imagen privada en WorkSpaces las aplicaciones de Amazon](delete-private-image.md)
+ [Copia una imagen de tu propiedad a otra AWS región en Amazon WorkSpaces Applications](copy-image-different-region.md)
+ [Comparte una imagen de tu propiedad con otra AWS cuenta en Amazon WorkSpaces Applications](share-image-with-another-account.md)
+ [Deja de compartir una imagen que te pertenece en WorkSpaces las aplicaciones de Amazon](stop-sharing-image-with-all-accounts.md)
+ [Conserve la imagen de sus WorkSpaces aplicaciones de Amazon Up-to-Date](keep-image-updated.md)
+ [Windows Update y software antivirus en las WorkSpaces aplicaciones de Amazon](windows-update-antivirus-software.md)
+ [Cree una nueva imagen en Amazon Applications mediante programación WorkSpaces](create-image-programmatically.md)
+ [Gestiona las aplicaciones con licencia incluida en tu imagen en Amazon WorkSpaces Applications](license-included-applications.md)
+ [Importar imagen](import-image.md)
+ [Exportar imagen](export-image.md)
# Eliminar una imagen privada en WorkSpaces las aplicaciones de Amazon
Puede eliminar sus imágenes privadas cuando ya no las necesite. No puedes eliminar una imagen que utilizan las flotas o que se comparte con otras AWS cuentas. Para eliminar una imagen utilizada por flotas o compartida, primero debe quitar la imagen de las flotas y quitar todos los permisos de uso compartido de la imagen. No puede recuperar una imagen después de que la elimine.
**Para eliminar una imagen privada**
1. Abre la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)
1. En el panel de navegación, elija **Imágenes** e **Registro de imágenes**.
1. En la lista de imágenes, seleccione la imagen privada que desea eliminar.
1. Elija **Acciones**, **Eliminar** y, a continuación, vuelva a elegir **Eliminar**.
La imagen se quita del registro de imágenes y se elimina.
# Copia una imagen de tu propiedad a otra AWS región en Amazon WorkSpaces Applications
**importante**
Para las regiones de AWS de Asia Pacífico (Malasia), Europa (Milán), Europa (España) e Israel (Tel Aviv): la copia de imágenes entre regiones solo se admite para imágenes WorkSpaces con versiones de agente de aplicaciones on/after publicadas el 2 de octubre de 2025 o imágenes que utilizan actualizaciones gestionadas on/after publicadas el 5 de septiembre de 2025. Las versiones anteriores no se pueden copiar entre regiones. Actualice sus imágenes para que cumplan con estos requisitos mínimos de versión para habilitar la funcionalidad de copia entre regiones.
Puedes copiar las imágenes que te pertenezcan a otra AWS región. El uso de la misma imagen en distintas AWS regiones puede ayudar a simplificar la implementación global de sus WorkSpaces aplicaciones en Applications. Al implementar sus aplicaciones en las AWS regiones geográficamente más cercanas a sus usuarios, puede ayudar a proporcionarles una experiencia con mayor capacidad de respuesta.
**Para copiar una imagen de su propiedad a otra región AWS**
1. Abra la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)
1. En el panel de navegación, elija **Imágenes** e **Registro de imágenes**.
1. En la lista de imágenes, seleccione la imagen que desee copiar en otra región. AWS
1. Seleccione **Actions** (Acciones), **Copy** (Copiar).
1. En el cuadro de diálogo **Copiar imagen**, en **Región de destino**, seleccione la AWS región en la que desee copiar la imagen.
1. Escriba un nombre único y, como opción, una descripción para la imagen en **Destination region (Región de destino)**.
1. Elija **Copy Image (Copiar imagen)**.
# Comparte una imagen de tu propiedad con otra AWS cuenta en Amazon WorkSpaces Applications
WorkSpaces Las imágenes de las aplicaciones son un recurso regional, por lo que puedes compartir una imagen que te pertenezca con otras AWS cuentas de la misma AWS región. Si lo hace, puede resultar útil en diferentes situaciones. Por ejemplo, si separas los recursos de desarrollo y producción mediante AWS cuentas diferentes, puedes crear una imagen con tu cuenta de desarrollo. A continuación, puede compartir la imagen con su cuenta de producción. Si su organización es un proveedor de software independiente (ISV), puede compartir imágenes optimizadas con sus clientes. Las imágenes optimizadas que disponen de las aplicaciones requeridas ya instaladas y configuradas permiten a los clientes comenzar a utilizar las aplicaciones rápidamente, de modo que no es necesario que instalen y configuren dichas aplicaciones.
Cuando compartes una imagen con otra AWS cuenta, especificas si la cuenta de destino puede usar la imagen en una flota o crear nuevas imágenes mediante la creación de un generador de imágenes. Sigue siendo el propietario de las imágenes que comparta. De esta forma, puede añadir, modificar o eliminar permisos según sea necesario para sus imágenes compartidas.
Si comparte una imagen con una cuenta y le concede a la cuenta permisos de flota, la imagen compartida se puede utilizar para crear o actualizar las flotas de dicha cuenta. Si quita estos permisos más tarde, la cuenta ya no podrá utilizar la imagen. Para las flotas en la cuenta que utilizan la imagen compartida, la capacidad deseada se establece en 0, lo que impide que se creen nuevas instancias de flota. Las sesiones existentes continúan hasta que concluye la sesión de streaming. Para crear nuevas instancias de flota, la flota de dicha cuenta se debe actualizar con una imagen válida.
Si comparte una imagen con una cuenta y le concede permisos de constructor de imágenes a la cuenta, la imagen compartida se puede utilizar para crear constructores de imágenes e imágenes en dicha cuenta. Si quita estos permisos más tarde, los constructores de imágenes y las imágenes que se crearon a partir de la imagen no se ven afectados.
**importante**
Después de compartir una imagen con una cuenta, no puede controlar los constructores de imágenes o las imágenes en la cuenta que se crean a partir de la imagen. Por este motivo, conceda al constructor de permisos para una cuenta solo si desea permitir que la cuenta haga una copia de su imagen y conserve el acceso a la copia una vez que deje de compartir la imagen.
**Para compartir una imagen de tu propiedad con otra AWS cuenta**
1. Abre la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)
1. En el panel de navegación, elija **Imágenes** e **Registro de imágenes**.
1. En la lista de imágenes, seleccione la imagen que desea compartir.
1. Elija **Actions (Acciones)**, **Share (Compartir)**.
1. En el cuadro de diálogo **Share image (Compartir imagen)**, seleccione **Add account (Añadir cuenta)**.
1. Escriba el ID de AWS cuenta de 12 dígitos de la cuenta con la que desee compartir la imagen y, a continuación, seleccione si la cuenta puede realizar una de las siguientes acciones o ambas:
+ Utilizar la imagen para lanzar un constructor de imágenes, si desea crear una nueva imagen.
+ Utilizar la imagen con una flota.
Para quitar una cuenta de la lista de cuentas con las que se comparte la imagen, en la fila correspondiente a la cuenta que desea eliminar, seleccione el icono de X que se encuentra a la derecha de la opción **Use for fleet (Utilizar para flota)**.
1. Para compartir la imagen con más AWS cuentas, repite el paso 6 para cada cuenta con la que quieras compartir la imagen.
1. Elija **Share Image (Compartir imagen)**.
**Para añadir o actualizar los permisos de uso compartido de una imagen de su propiedad**
1. Abre la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)
1. En el panel de navegación, elija **Imágenes** e **Registro de imágenes**.
1. En la lista de imágenes, seleccione la imagen a la que desea cambiar los permisos.
1. Debajo de la lista de imágenes, seleccione la pestaña **Permissions (Permisos)** para la imagen que ha seleccionado, a continuación, elija **Edit (Editar)**.
1. En el cuadro de diálogo **Editar permisos de imagen**, active o desactive una o ambas de las siguientes opciones para compartir imágenes según sea necesario para una o más cuentas. AWS Si desactiva ambas opciones para una cuenta, la imagen deja de compartirse con dicha cuenta.
+ Utilizar la imagen para lanzar un constructor de imágenes, si desea crear una nueva imagen.
+ Utilizar la imagen con una flota.
Para quitar una cuenta de la lista de cuentas con las que se comparte la imagen, en la fila correspondiente a la cuenta que desea eliminar, seleccione el icono de X que se encuentra a la derecha de la opción **Use for fleet (Utilizar para flota)**.
1. Para editar los permisos para compartir imágenes de más AWS cuentas, repite el paso 5 para cada cuenta para la que quieras actualizar los permisos.
1. Elija **Update image sharing permissions (Actualizar permisos de uso compartido)**.
# Deja de compartir una imagen que te pertenece en WorkSpaces las aplicaciones de Amazon
Sigue estos pasos para dejar de compartir una imagen de tu propiedad con cualquier otra AWS cuenta.
**Para dejar de compartir una imagen de tu propiedad con cualquier otra AWS cuenta**
1. Abre la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)
1. En el panel de navegación, elija **Imágenes** e **Registro de imágenes**.
1. En la lista de imágenes, seleccione la imagen a la que desea cambiar los permisos.
1. Debajo de la lista de imágenes, seleccione la pestaña **Permissions (Permisos)** para la imagen que ha seleccionado, a continuación, elija **Edit (Editar)**.
1. En el cuadro de diálogo **Editar permisos de imagen**, en la fila correspondiente a todas AWS las cuentas con las que se comparte la imagen, elija el icono X situado a la derecha de la opción **Usar para flota**.
1. Elija **Update image sharing permissions (Actualizar permisos de uso compartido)**.
# Conserve la imagen de sus WorkSpaces aplicaciones de Amazon Up-to-Date
Puede conservar la imagen de su WorkSpaces aplicación up-to-date realizando una de las siguientes acciones:
+ [Actualice una imagen mediante WorkSpaces aplicaciones gestionadas (actualizaciones de imágenes)](keep-image-updated-managed-image-updates.md)— Este método de actualización proporciona las últimas actualizaciones del sistema operativo y de los controladores, así como el software del agente de WorkSpaces aplicaciones más reciente.
+ [Actualice el software del agente de WorkSpaces aplicaciones mediante las versiones del agente de WorkSpaces aplicaciones gestionadas](keep-image-updated-manage-image-versions.md)— Este método de actualización proporciona el software de agente de WorkSpaces aplicaciones más reciente.
# Actualice una imagen mediante WorkSpaces aplicaciones gestionadas (actualizaciones de imágenes)
WorkSpaces Las aplicaciones proporcionan una forma automática de actualizar la imagen con las actualizaciones más recientes del sistema operativo, las actualizaciones de las aplicaciones con licencia incluida, las actualizaciones de los controladores y el software del agente de WorkSpaces aplicaciones. Con las actualizaciones de imágenes de las WorkSpaces aplicaciones gestionadas, usted selecciona la imagen que desea actualizar. WorkSpaces Applications crea un generador de imágenes en la misma AWS cuenta y región para instalar las actualizaciones y crear la nueva imagen. Una vez creada la nueva imagen, puede probarla en una flota de preproducción antes de actualizar sus flotas de producción o compartir la imagen con otras AWS cuentas.
**nota**
Las actualizaciones de imágenes de WorkSpaces aplicaciones administradas están disponibles para los sistemas operativos Microsoft Windows Server, Red Hat Enterprise Linux y Rocky Linux.
**nota**
Una vez creada la nueva imagen, usted es responsable de mantener las actualizaciones del sistema operativo. Para ello, puede seguir utilizando las actualizaciones de imágenes de WorkSpaces las aplicaciones gestionadas.
Usted es responsable de mantener las actualizaciones del controlador Amazon EC2 Windows Paravirtual (PV), del controlador ENA y del controlador. AWS NVMe Para obtener más información sobre cómo actualizar los controladores, consulte [Administración de controladores de dispositivos para su instancia de EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-device-drivers.html).
También es responsable del mantenimiento de las aplicaciones y sus dependencias. Para añadir otras aplicaciones, actualice las aplicaciones existentes o cambie la configuración de las imágenes, debe iniciar y volver a conectar al generador de imágenes que utilizó para crear la imagen. O, si eliminó dicho constructor de imágenes, lance un nuevo constructor de imágenes basado en su imagen. A continuación, realice los cambios y cree una nueva imagen.
## Requisitos previos
A continuación, se indican los requisitos previos y las consideraciones a la hora de trabajar con actualizaciones de imágenes administradas.
+ Asegúrese de que las cuotas de su cuenta de WorkSpaces aplicaciones (también denominadas límites) sean suficientes para permitir la creación de un nuevo generador de imágenes y una nueva imagen. Para solicitar un aumento de cuota, puede utilizar la consola Service Quotas en [https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/). Para obtener información sobre WorkSpaces las cuotas de aplicaciones predeterminadas, consulte[Amazon WorkSpaces Applications Service Quotas](limits.md).
+ Debe poseer la imagen que se actualiza. No puede actualizar una imagen que se haya compartido con usted.
+ Cuando WorkSpaces Applications crea un generador de imágenes para instalar las actualizaciones más recientes del sistema operativo, las actualizaciones de controladores y el software del agente de WorkSpaces aplicaciones, y crea la nueva imagen, se le cobrará por la instancia del generador de imágenes mientras se actualiza.
+ Las imágenes compatibles deben crearse a partir de una imagen base publicada el 24 de julio de 2017 a las 00:00:00 Z o con posterioridad.
+ Se admiten inglés y japonés como idiomas de visualización. Para obtener más información, consulte [Especificar un idioma predeterminado](configure-default-display-language.md).
+ Utilice la versión más reciente del agente de SSM. Para obtener información sobre la versión, consulte [WorkSpaces Notas de la versión de la actualización de imágenes base e imágenes gestionadas de aplicaciones](base-image-version-history.md). Para obtener información de instalación, consulte [Instalación manual de SSM Agent en instancias de EC2 para Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html).
## Cómo actualizar una imagen mediante WorkSpaces aplicaciones gestionadas (actualizaciones de imágenes)
Para actualizar una imagen de WorkSpaces aplicaciones con los últimos parches, actualizaciones de controladores y software de agente de WorkSpaces aplicaciones, lleve a cabo los siguientes pasos.
1. Abra la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)
1. En el panel de navegación, elija **Imágenes** e **Registro de imágenes**.
1. En la lista de imágenes, elija la imagen que desea actualizar. Compruebe que el estado de la imagen sea **Disponible**.
1. Elija **Acciones**, **Actualizar**.
1. En el cuadro de diálogo **Crear imagen**, haga lo siguiente:
+ En Nombre de **imagen nueva, introduzca un nombre** de imagen que sea único en la AWS cuenta y la región. El nombre de la imagen no puede empezar por «Amazon»AWS, «» o «»AppStream.»
+ En el campo **Nombre de visualización de la nueva imagen**, si lo desea, puede ingresar un nombre para mostrarlo en la imagen.
+ En **Descripción de la nueva imagen**, tiene la opción de proporcionar una descripción de la imagen.
+ En **Etiquetas**, elija **Agregar etiqueta** y escriba la clave y el valor de la etiqueta. Para añadir más etiquetas, repita este paso. Para obtener más información, consulte [Cómo etiquetar los recursos de tus WorkSpaces aplicaciones de Amazon](tagging-basic.md).
1. Elija **Actualizar imagen**.
Si la imagen actual ya está actualizada, recibirá un mensaje que se lo notifica.
1. En el panel de navegación, elija **Imágenes** y, a continuación, **Constructor de imágenes**.
1. En la lista de constructores de imágenes, compruebe que aparezca un nuevo constructor de imágenes con el estado **Actualizando**. El nombre del constructor de imágenes incluye un sufijo aleatorio de 10 dígitos.
El constructor de imágenes es el tamaño más pequeño de la familia de instancias que eligió para la nueva imagen en el paso 5. No se ha especificado ninguna subred porque el constructor de imágenes no está asociado a la nube privada virtual (VPC).
1. Elija **Registro de imágenes** y compruebe que la nueva imagen aparezca en la lista.
Aunque la imagen se está creando, su estado en el registro de imágenes de la consola aparece como **Creando**.
1. Una vez creada la imagen, WorkSpaces Applications lleva a cabo un proceso de calificación para comprobar que la imagen funciona según lo esperado.
Durante este tiempo, el constructor de imágenes, que también se utiliza para este proceso, aparece en la lista **Constructor de imágenes** con el estado **Pendiente de cualificación**.
1. Cuando el proceso de cualificación se haya completado correctamente, aparecerá un mensaje **Correcto** a modo de confirmación en la parte superior de la consola y el estado de la imagen en el registro de imágenes aparecerá como **Disponible**.
Además, el generador de imágenes que creó WorkSpaces Applications se elimina automáticamente.
**nota**
Según el volumen de actualizaciones del sistema operativo, la actualización de una imagen puede tardar varias horas en completarse. Si un problema impide que la imagen se actualice, aparecerá un icono rojo con un signo de exclamación junto al nombre de la imagen y el estado de la imagen en el registro de imágenes aparecerá como **Error**. Si esto ocurre, seleccione la imagen, elija la pestaña **Notificaciones** y revise las notificaciones de error. Para obtener más información, consulte la información de la sección [Servicio interno de la imagen](troubleshooting-notification-codes.md#troubleshooting-notification-codes-image) de la documentación para la solución de problemas de códigos de notificación.
Si el proceso de calificación no se realiza correctamente, el generador de imágenes que creó WorkSpaces Applications se eliminará automáticamente.
1. Una vez que WorkSpaces Applications haya creado la nueva imagen, pruébela en una flota de preproducción. Después de verificar que sus aplicaciones funcionan según lo previsto, actualice su flota de producción con la nueva imagen.
# Actualice el software del agente de WorkSpaces aplicaciones mediante las versiones del agente de WorkSpaces aplicaciones gestionadas
WorkSpaces Applications proporciona una forma automática de actualizar su generador de imágenes con el software de agente de WorkSpaces aplicaciones más reciente. Esto le permite crear una nueva imagen cada vez que se publica una nueva versión del agente. A continuación, puede probar la imagen antes de actualizar las flotas de producción. Para obtener más información sobre cómo administrar el software del agente de WorkSpaces aplicaciones, consulte[Gestione WorkSpaces las versiones del agente de aplicaciones](base-images-agent.md).
**nota**
Usted es responsable de instalar y mantener las actualizaciones del sistema operativo Windows, de sus propias aplicaciones y de las dependencias entre ellos.
Para mantener la imagen de la WorkSpaces aplicación actualizada con las actualizaciones más recientes del sistema operativo Windows, realice una de las siguientes acciones:
+ Instale sus aplicaciones en la última imagen base cada vez que se publique una imagen nueva.
+ Instale las actualizaciones del sistema operativo Windows, de sus propias aplicaciones y de las dependencias entre ellos en un constructor de imágenes existente.
+ Instale las actualizaciones del sistema operativo Windows, de sus propias aplicaciones y de las dependencias entre ellos en un constructor de imágenes nuevo a partir de una imagen existente.
Tras crear una imagen nueva con el sistema operativo Windows más reciente, las aplicaciones y sus dependencias y el software del agente de WorkSpaces aplicaciones, pruebe la imagen en una flota de desarrollo. Después de verificar que sus aplicaciones funcionan según lo previsto, actualice su flota de producción con la nueva imagen.
# Windows Update y software antivirus en las WorkSpaces aplicaciones de Amazon
WorkSpaces Las instancias de streaming de aplicaciones no son persistentes. Cuando finaliza la sesión de streaming de un usuario, WorkSpaces Applications finaliza la instancia utilizada por la sesión y, según sus políticas de escalado, aprovisiona una nueva instancia para sustituirla en su flota. Todas las instancias de la flota se aprovisionan a partir de la misma imagen. Dado que las imágenes no se pueden cambiar una vez creadas, las instancias de la flota utilizadas en las sesiones de streaming de los usuarios únicamente tienen las actualizaciones de Windows y de las aplicaciones que estaban instaladas en la imagen subyacente en el momento de crearla. Además, dado que una instancia de la flota utilizada para una sesión de streaming termina al finalizar la sesión, las actualizaciones realizadas en Windows o en las aplicaciones de la instancia durante la sesión de streaming no persistirán en sesiones futuras, ya sean del mismo o de otros usuarios.
**nota**
Si habilitó la persistencia de la configuración de la aplicación para su pila, WorkSpaces Applications conserva Windows y los cambios de configuración de las aplicaciones realizados por un usuario en futuras sesiones del mismo usuario si esos cambios de configuración se almacenan en el perfil de Windows del usuario. Sin embargo, la característica de persistencia de la configuración de las aplicaciones solo conserva las opciones de configuración de Windows y de la aplicación. Las actualizaciones de software de Windows y de las aplicaciones de la instancia de streaming no son persistentes.
Por estos motivos, WorkSpaces Applications adopta el siguiente enfoque con respecto a Windows Update y al software antivirus en WorkSpaces las instancias de Applications.
## Actualización de Windows
Windows Update no está habilitado de forma predeterminada en WorkSpaces las imágenes base de las aplicaciones. Si Windows Update se habilita en un constructor de imágenes y, a continuación, se intenta crear una imagen, Image Assistant muestra una advertencia y deshabilita Windows Update durante el proceso de creación de imágenes. Para asegurarse de que las instancias de la flota tengan instaladas las actualizaciones de Windows más recientes, recomendamos instalar las actualizaciones de Windows en el constructor de imágenes, crear una nueva imagen y actualizar la flota con la nueva imagen de forma periódica.
## Software antivirus
Si decide instalar un software antivirus en la imagen, recomendamos no habilitar las actualizaciones automáticas para él. De lo contrario, el software antivirus podría intentar actualizarse con los últimos archivos de definición u otras actualizaciones durante las sesiones de usuario. Esto podría afectar al rendimiento. Además, las actualizaciones realizadas en el software antivirus no se conservarán una vez finalizada la sesión de usuario actual. Para asegurarse de que las instancias de la flota tengan siempre las últimas actualizaciones antivirus, recomendamos realizar una de las siguientes acciones:
+ Actualice el constructor de imágenes y cree una nueva imagen de forma periódica (por ejemplo, utilizando las [operaciones de la CLI de Image Assistant](https://docs.aws.amazon.com/appstream2/latest/developerguide/programmatically-create-image.html)).
+ Utilice una aplicación antivirus que delegue el escaneo u otras operaciones en un servidor always-up-to-date externo.
**nota**
Aunque no habilite las actualizaciones automáticas para el software antivirus, este puede realizar análisis del disco duro u otras operaciones que podrían afectar al rendimiento de las instancias de la flota durante las sesiones de usuario.
En WorkSpaces las imágenes base de las aplicaciones Windows Server 2025/2022/2019/2016 publicadas a partir del 10 de septiembre de 2019, Windows Defender no está activado de forma predeterminada. En WorkSpaces las imágenes base de las aplicaciones Windows Server 2016 y Windows Server 2019 publicadas el 24 de junio de 2019, Windows Defender está activado de forma predeterminada.
**Para habilitar Windows Defender de forma manual**
Si Windows Defender no está habilitado en la imagen base, puede habilitarlo de forma manual. Para ello, complete los siguientes pasos.
1. Abra la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)
1. En el panel de navegación izquierdo, elija **Imágenes**, **Generador de imágenes**.
1. Seleccione el constructor de imágenes en el que desea habilitar Windows Defender, compruebe que se encuentra en estado **Running (En ejecución)** y elija **Connect (Conectarse)**.
1. Inicie sesión en el constructor de imágenes con la cuenta **Administrador** local o con una cuenta de dominio que tenga permisos de administrador local.
1. Abra el editor del registro.
1. Navegue hasta la siguiente ubicación del registro: **HKLM\$1 SOFTWARE\$1 Policies\$1 Microsoft\$1 Windows Defender\$1**. DisableAntiSpyware
1. Para editar esta clave de registro, haga doble clic en ella o haga clic con el botón derecho en la clave de registro y seleccione **Modify (Modificar)**.
1. En el cuadro de diálogo **Edit DWORD (32-bit) Value (Editar valor DWORD [32 bits])**, en **Value data (Datos de valor)**, cambie **1** por **0**.
1. Seleccione **Aceptar**.
1. Cierre el editor del registro.
1. Abra el complemento **Services (Servicios)** de la consola de administración de Microsoft (MMC) (`services.msc`).
1. En la lista de servicios, realice una de las siguientes acciones:
Si utiliza Microsoft Windows Server 2022/2025, realice una de las siguientes acciones:
+ Haga clic con el botón derecho en el **Servicio antivirus de Windows Defender** y elija **Inicio**.
+ Haga doble clic en **Servicio antivirus de Windows Defender**, elija **Iniciar** en el cuadro de diálogo de propiedades y, a continuación, elija **Aceptar**.
Si utiliza Microsoft Windows Server 2019 o 2016, realice una de las siguientes acciones:
+ Haga clic con el botón derecho en el **Windows Defender Antivirus Service (Servicio antivirus de Windows Defender)** y elija **Start (Inicio)**.
+ Haga doble clic en el **Windows Defender Antivirus Service (Servicio antivirus de Windows Defender)**, elija **Start (Inicio)** en el cuadro de diálogo de propiedades y, a continuación, elija **OK (Aceptar)**.
1. Cierre el complemento **Services (Servicios)**.
# Cree una nueva imagen en Amazon Applications mediante programación WorkSpaces
Puede crear imágenes de WorkSpaces aplicaciones mediante programación conectándose a un generador de imágenes y utilizando las operaciones de la interfaz de línea de comandos (CLI) de Image Assistant. Para obtener más información, consulte [Cree la imagen de sus WorkSpaces aplicaciones de Amazon mediante programación mediante las operaciones CLI de Image Assistant](programmatically-create-image.md).
# Gestiona las aplicaciones con licencia incluida en tu imagen en Amazon WorkSpaces Applications
Puede transmitir las siguientes aplicaciones incluidas con licencia de Microsoft mediante WorkSpaces Aplicaciones. Puede instalar estas aplicaciones en su imagen de Windows, usar esta imagen personalizada para crear flotas y, a continuación, transmitir estas aplicaciones. Todas las aplicaciones siguientes están disponibles en arquitectura de 32 o 64 bits:
+ Microsoft Office LTSC Profesional Plus 2021/2024
+ Microsoft Visio LTSC Profesional 2021/2024
+ Microsoft Project Profesional 2021/2024
+ Estándar LTSC de Microsoft Office 2021/2024
+ Estándar LTSC de Microsoft Visio 2021/2024
+ Estándar de Microsoft Project 2021/2024
**importante**
Microsoft Office, Visio y Project deben seguir las mismas versiones. Por ejemplo, no se pueden mezclar aplicaciones de 2021 con aplicaciones de 2024.
Microsoft Office, Visio y Project deben seguir la misma arquitectura. Por ejemplo, no se pueden mezclar aplicaciones de 32 bits con aplicaciones de 64 bits.
Standard/Professional versions are supported on Microsoft Windows Server 2019/2022/2025. Microsoft Office, Visio, and Project 2024 Standard/ProfessionalLas versiones Microsoft Office, Visio y Project 2021 son compatibles con Microsoft Windows Server 2022 y 2025.
Para habilitar esta función, debe usar un WorkSpaces Applications Image Builder que utilice un agente de WorkSpaces aplicaciones publicado el 2 de octubre de 2025 o después. Para obtener más información, consulte [Gestione WorkSpaces las versiones del agente de aplicaciones](base-images-agent.md) . O bien, su imagen debe utilizar las actualizaciones de imágenes de WorkSpaces aplicaciones gestionadas publicadas a partir del 3 de octubre de 2025. Para obtener más información, consulte [Conserve la imagen de sus WorkSpaces aplicaciones de Amazon Up-to-Date](keep-image-updated.md).
TCP de salida en el puerto 1688 debe estar abierto en la interfaz de red de administración de todas las instancias de streaming:
Todos los usuarios que hagan streaming a través de una flota basada en una imagen con una o más aplicaciones con licencia deberán facturar estas aplicaciones mensualmente, independientemente del uso. La característica de autorización de aplicaciones no restringe el acceso a usuarios específicos.
Las aplicaciones con licencia incluida en Image Builder no se activan porque se instalan con fines administrativos. La activación se produce cuando los usuarios transmiten a través de una instancia de flota.
**Topics**
+ [Consulte la lista de aplicaciones con licencia incluida instaladas en su imagen](view-list-image.md)
+ [Consulte la lista de aplicaciones con licencia incluida en el generador de imágenes](view-list-apps.md)
+ [Instalación o desinstalación de aplicaciones con licencia incluida](install-uninstall-apps.md)
+ [Habilitación de actualizaciones para aplicaciones con licencia incluida en el generador de imágenes](updates-image-builder.md)
+ [Habilitación de actualizaciones para aplicaciones con licencia incluida en el generador de imágenes con Powershell](enable-updates-managed-powershell.md)
+ [Habilitación de actualizaciones para aplicaciones con licencia incluida en el generador de imágenes con actualización de imágenes administradas](enable-updates-managed.md)
# Consulte la lista de aplicaciones con licencia incluida instaladas en su imagen
**Consulte la lista de aplicaciones con licencia incluida instaladas en su imagen**
Para consultar la lista de aplicaciones con licencia incluida instaladas en su imagen, siga estos pasos.
1. Abra la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)
1. Elija **Imágenes** en el panel de navegación izquierdo y la pestaña **Registro de imágenes**.
1. Seleccione una imagen y elija **Ver detalles**.
1. Revise la lista de todas las aplicaciones instaladas en **Aplicaciones con licencia incluida**.
# Consulte la lista de aplicaciones con licencia incluida en el generador de imágenes
**Consulte la lista de aplicaciones con licencia incluida en el generador de imágenes**
Para consultar la lista de aplicaciones con licencia incluida en el generador de imágenes, siga estos pasos.
1. [Abra la consola de WorkSpaces aplicaciones en /appstream2. https://console.aws.amazon.com](https://console.aws.amazon.com/appstream2)
1. Elija **Imágenes** en el panel de navegación izquierdo y la pestaña **Generador de imágenes**.
1. Seleccione un generador de imágenes y elija **Ver detalles**.
1. Revise la lista de todas las aplicaciones y sus estados en **Aplicaciones con licencia incluida**.
# Instalación o desinstalación de aplicaciones con licencia incluida
**Instalación o desinstalación de aplicaciones con licencia incluida**
Para instalar o desinstalar una o varias aplicaciones con licencia incluida en la imagen, sigue estos pasos.
1. Complete una de las siguientes opciones:
+ Inicie un generador de imágenes y configure las aplicaciones con licencia incluida. Para obtener más información, consulte [Lanzar un generador de imágenes para instalar y configurar aplicaciones de streaming](tutorial-image-builder-create.md).
+ Administre la lista de aplicaciones con licencia incluida en el generador de imágenes. Para obtener más información, consulte [Derechos de aplicaciones basados en atributos con un proveedor de identidades SAML 2.0 de terceros](application-entitlements-saml.md).
1. Si ha creado una imagen con una o varias aplicaciones con licencia incluida, puede utilizarla para crear flotas. Los usuarios que se conecten a esta flota pueden acceder a estas aplicaciones.
**importante**
Todos los usuarios que hagan streaming a través de una flota basada en una imagen con una o más aplicaciones con licencia deberán facturar estas aplicaciones mensualmente, independientemente del uso. La característica de autorización de aplicaciones no restringe el acceso a usuarios específicos.
Si se producen errores durante la instalación o desinstalación de una aplicación con licencia incluida, aparecerá un estado de error en la página de detalles del generador de imágenes. Para solucionar estos problemas, le recomendamos que se conecte al generador de imágenes y habilite el registro detallado. Para obtener más información, consulte [Cómo habilitar aplicaciones de Microsoft 365 para registro de empresa](https://learn.microsoft.com/en-us/troubleshoot/microsoft-365-apps/diagnostic-logs/how-to-enable-office-365-proplus-uls-logging). Si el problema persiste después de revisar los registros y solucionar el problema, ponte en contacto con nosotros AWS Support para solicitar ayuda.
# Habilitación de actualizaciones para aplicaciones con licencia incluida en el generador de imágenes
**Habilitación de actualizaciones para aplicaciones con licencia incluida en el generador de imágenes**
Las actualizaciones para todas las aplicaciones con licencia incluida están deshabilitadas de forma predeterminada. Puede habilitar las actualizaciones de estas aplicaciones en el generador de imágenes con una imagen que incluya una o varias de estas aplicaciones. Las actualizaciones de instancias de flota permanecen deshabilitadas para impedir su instalación durante la configuración de sesiones.
Existen tres opciones para habilitar actualizaciones de aplicaciones con licencia incluida en el generador de imágenes.
Para habilitar actualizaciones de aplicaciones con licencia incluida en el generador de imágenes con el menú de aplicaciones, siga estos pasos.
1. Abra cualquier aplicación con licencia incluida.
1. Elija **Archivo**, **Cuenta**, **Opciones de actualización** y **Habilitar actualizaciones**.
# Habilitación de actualizaciones para aplicaciones con licencia incluida en el generador de imágenes con Powershell
Siga estos pasos para habilitar actualizaciones para aplicaciones con licencia incluida en el generador de imágenes con Powershell.
+ Ejecute el siguiente comando PowerShell como administrador:
`Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration" -Name UpdatesEnabled -Value True `
# Habilitación de actualizaciones para aplicaciones con licencia incluida en el generador de imágenes con actualización de imágenes administradas
Siga estos pasos para habilitar actualizaciones para aplicaciones con licencia incluida en el generador de imágenes con actualización de imágenes administradas.
+ Utilice actualización de imágenes administradas para recibir actualizaciones sobre las aplicaciones con licencia incluida de Microsoft. Para obtener más información, consulte
[Actualice una imagen mediante WorkSpaces aplicaciones gestionadas (actualizaciones de imágenes)](keep-image-updated-managed-image-updates.md).
# Importar imagen
Puede crear imágenes de WorkSpaces aplicaciones importando sus imágenes personalizadas EC2 AMIs. Así es como funciona:
1. Personalice su EC2 AMI con cualquier método preferido, incluido [EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/).
1. Importe su AMI personalizada a WorkSpaces las aplicaciones para crear una imagen de WorkSpaces aplicaciones
1. Si lo desea, utilice Image Builder para una personalización adicional de la imagen
Las imágenes creadas mediante la importación de AMI son de`type = "custom"`, mientras que WorkSpaces las imágenes proporcionadas por las aplicaciones son de`type = "native"`.
Puede utilizar los tipos de instancia stream.\$1 para las imágenes con. `type = "native"` Para usar cualquiera de los siguientes tipos de instancias, debe importar su AMI y crear una imagen con ella`type = "custom"`.
+ GeneralPurpose.\$1
+ MemoryOptimized.\$1
+ ComputeOptimized.\$1
+ Acelerado. \$1
## Requisitos previos para la importación de imágenes
Todos estos requisitos previos son importantes para una ejecución correcta del flujo de trabajo. Las configuraciones de AMI compatibles y otros requisitos obligatorios se enumeran a continuación.
### Propiedades de AMI obligatorias
EBS
+ Un tamaño igual o inferior a 500 GB
+ Puede importar una AMI con menos de 200 GB; sin embargo, la imagen importada utilizará 200 GB como mínimo.
+ GP2
+ Puede importar una AMI con el tipo de volumen EBS gp2 o gp3; sin embargo, la imagen importada utilizará gp2.
+ Un volumen por imagen
+ `/dev/sda1`Nombre del dispositivo raíz
+ Tipo de imagen: Máquina
+ Arquitectura: x86\$164
+ Tipo de virtualización: HVM
+ Modo de arranque: UEFI
+ Soporte TPM: v2.0. Esto es obligatorio. Consulte [https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html\$1](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html#ami-windows-tpm-find) para ami-windows-tpm-find buscar una AMI habilitada para TPM.
+ ENA Support: cierto
+ Plataforma: Windows
+ Detalles de la plataforma: Windows
### Propiedades del sistema operativo
**Base completa de Windows Server 2022/2025**
+ No se admite Windows Server **Core**
+ No se admite Windows con SQL Server
Agentes
+ EC2 Inicie la versión V2 >= 2.1.1
+ Se requiere un agente SSM
Controladores
+ EC2 Versión del controlador ENA >= 2.9.0
+ EC2 NVMe Versión del controlador >= 1.6.0
Library Support
+ .NET Framework 4.8 o superior
+ Se instala de forma predeterminada en Windows Server 2022/2025
+ PowerShell 5.1 o superior
+ Se instala de forma predeterminada en Windows Server 2022/2025
+ Características de Windows: no se deben instalar las licencias de los servicios de escritorio remoto ni el host de sesión de los servicios de escritorio remoto
+ Puertos: los puertos 8000, 8300 y 8443 deben estar desbloqueados y desocupados
+ Modo de arranque: UEFI
Si desea utilizar imágenes con instancias gráficas como Accelerated.G4DN, Accelerated.G5, Accelerated.G6 o Accelerated.G6E, debe instalar el controlador GRID adecuado en su AMI. [Para https://docs.aws.amazon.com/AWSEC2/ latest/UserGuide/nvidia obtener más información, consulte -GRID-driver.html.](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html) Si los controladores no están configurados correctamente, la transmisión funcionará; sin embargo, es posible que la tarjeta gráfica no esté disponible.
**importante**
El «identificador de la cuenta del propietario» de la AMI debe ser el identificador de su AWS cuenta. No puede importar una EC2 AMI pública.
Realice cualquier actualización de Windows y desactive las actualizaciones automáticas de Windows antes de importar la imagen.
Actualmente no EC2 AMIs se admite la importación de archivos cifrados
### Requisitos del rol de IAM
**importante**
«Cree un rol de IAM con los siguientes permisos para usarlo en la importación de imágenes:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowModifyImageAttributeWithTagCondition",
"Effect": "Allow",
"Action": "ec2:ModifyImageAttribute",
"Resource": "*"
},
{
"Sid": "AllowDescribeImages",
"Effect": "Allow",
"Action": "ec2:DescribeImages",
"Resource": "*"
}
]
}
```
Añada la siguiente relación de confianza para este rol de IAM
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "appstream.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
## Para importar una imagen
1. Abra la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)
1. **En el panel de navegación izquierdo, selecciona **Imágenes y, a continuación, selecciona Registro de imágenes**.**
1. Selecciona **Importar imagen**.
1. **ID de AMI**: introduzca un ID de AMI para la AMI que desee importar a WorkSpaces las aplicaciones. También puede buscar su AMI en este campo.
1. **Nombre de la imagen**: introduzca un nombre exclusivo para la imagen que se creará como consecuencia de la operación de importación.
1. **Nombre para mostrar** *(opcional)*: introduzca un nombre para mostrar la imagen.
1. **Descripción** *(opcional)*: introduzca una descripción para la imagen.
1. **Función de IAM**: seleccione la función de IAM que ha creado para la importación de imágenes. Para obtener más información, consulte. [Requisitos del rol de IAM](#iam-role-requirements)
1. **Administrar el agente de WorkSpaces aplicaciones**: seleccione esta opción si desea utilizar siempre la versión más reciente del agente de WorkSpaces aplicaciones, ya que sus instancias de streaming AWS se actualizan automáticamente con las últimas funciones, mejoras de rendimiento y actualizaciones de seguridad disponibles desde el lanzamiento de una nueva versión del agente.
1. **Validación en tiempo de ejecución** *(opcional)*: seleccione esta opción y el servicio aprovisionará una instancia con la imagen que se está importando y realizará pruebas de streaming.
+
**nota**
Estas pruebas de streaming se ejecutarán en segundo plano; no puedes conectarte a esta instancia a través del cliente de WorkSpaces aplicaciones.
+ Le recomendamos que utilice esta opción para tener más confianza en que su imagen es adecuada para WorkSpaces las aplicaciones.
+ Se te facturará el precio por hora de esa instancia.
+ Puede evitar ejecutar la validación en tiempo de ejecución si vuelve a importar la AMI después de realizar cambios menores que pueden no afectar a la prueba de transmisión y, si la validación en tiempo de ejecución se aprobó por última vez, importó esta AMI.
+ **Elija el tipo de instancia** *(opcional)*: seleccione la familia de instancias, el tipo y el tamaño correctos para ejecutar la prueba de transmisión. Se recomienda usar la misma instancia que planea usar para la creación de la flota.
1. **Catálogo de aplicaciones y manifiesto de rendimiento de lanzamiento** *(opcional)*: proporcione detalles para crear un catálogo de aplicaciones para sus usuarios finales y mejorar el rendimiento de lanzamiento de las aplicaciones.
+ **Catálogo de aplicaciones**: para crear un catálogo de aplicaciones, especifique los detalles sobre las aplicaciones instaladas en su imagen. Para cada aplicación que tenga previsto transmitir, puede especificar el nombre, el nombre de visualización, el archivo ejecutable que se va a lanzar y el icono que se mostrará.
+ **Rendimiento de lanzamiento**: al añadir archivos al manifiesto de optimización de la aplicación, se reduce el tiempo que tarda la aplicación en lanzarse por primera vez en una nueva instancia de flota. El manifiesto de optimización es un archivo de texto delimitado por líneas que se crea para cada aplicación.
Para obtener más información, consulte[Detalles de las aplicaciones](applications-details.md).
1. **Etiquetas** *(opcional)*: selecciona **Añadir etiqueta** y escribe la clave y el valor de la etiqueta. Para añadir más etiquetas, repita este paso. Para obtener más información, consulte [Cómo etiquetar los recursos de tus WorkSpaces aplicaciones de Amazon](tagging-basic.md).
1. **Importar imagen**: revisa toda la información que has introducido y selecciona **Importar imagen**. El servicio realizará comprobaciones de compatibilidad para garantizar que la AMI sea compatible con WorkSpaces las aplicaciones.
+ Si las comprobaciones estáticas fallan, recibirá un error inmediatamente.
+ Si se superan las comprobaciones estáticas, se enviará tu solicitud de importación y, según las opciones que hayas seleccionado, la creación de una nueva imagen de la WorkSpaces aplicación con ella podría tardar entre 30 y 60 minutos `type = "custom"`
# Detalles de las aplicaciones
Los detalles de las aplicaciones contienen información sobre los manifiestos previos al calentamiento y las configuraciones del catálogo de aplicaciones.
## Manifiestos de aplicaciones PreWarm
Al crear imágenes de WorkSpaces aplicaciones, puede especificar las aplicaciones que se pondrán a disposición de los usuarios. Para acelerar el tiempo de inicio de la aplicación, puede preparar un PreWarm manifiesto. Básicamente, se trata de un catálogo de los archivos que la aplicación necesita para ejecutarse cuando los usuarios la lanzan. Durante el aprovisionamiento de instancias, estos archivos se prepararán antes de las conexiones de sesión para acelerar los tiempos de lanzamiento de las aplicaciones en las sesiones de los usuarios.
Los manifiestos de precalentamiento se deben crear previamente en la AMI antes de importarlos al entorno de WorkSpaces aplicaciones. Puede elegir entre crear un archivo de manifiesto de Prewarm común o uno para cada aplicación. Esto cambiará la forma en que importará la AMI más adelante.
### Manifiesto común de precalentamiento
Para cada aplicación que desee precalentar, inicie la aplicación y realice cualquier interacción inicial que puedan realizar los usuarios. A continuación, utilice el siguiente comando para dirigirse al directorio en el que se almacenan los datos de la aplicación.
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```
Esto añadirá los archivos que desee optimizar para cada aplicación al `C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt` archivo común. No es necesario realizar ninguna acción adicional para realizar el precalentamiento de la aplicación. WorkSpaces Las aplicaciones buscarán el archivo de precalentamiento en la ubicación anterior y lo utilizarán si está presente.
Este proceso es opcional y, a medida que aumente el tamaño del manifiesto de precalentamiento, también aumentará el tiempo de aprovisionamiento de la flota. Por lo tanto, procure equilibrar la optimización con el aprovisionamiento de la flota.
### Manifiestos específicos de la aplicación
Durante la importación de imágenes, es posible que desee especificar archivos de manifiesto de aplicación independientes para cada aplicación para facilitar el seguimiento de los activos precalentados por aplicación. Para ello, lleve a cabo los mismos pasos descritos anteriormente, pero en lugar de crear un `C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt` archivo común, cree un archivo por aplicación en la AMI.
Para cada aplicación que desee precalentar, ejecútela y realice cualquier interacción inicial que puedan realizar los usuarios. A continuación, utilice el siguiente comando para dirigirse al directorio en el que se almacenan los datos de la aplicación.
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\Path\To\My\PreWarm.txt" -encoding UTF8 -append
```
Utilizaremos estos archivos de precalentamiento de aplicaciones durante el proceso de importación de imágenes. De nuevo, esto es completamente opcional. Puedes optar por utilizar este método, el método Common Prewarm Manifest o no utilizar ningún manifiesto de precalentamiento.
## Configuraciones del catálogo de aplicaciones
`AppCatalogConfig`que le permite especificar las aplicaciones que desea registrar en su imagen de WorkSpaces aplicaciones durante la importación de la AMI. `AppCatalogConfig`Es una lista JSON de objetos de configuración de aplicaciones con la siguiente estructura.
```
[
{
"Name": "Rufus", //Required and must be unique among the list of applications
"DisplayName": "Rufus",
"AbsoluteAppPath": "Rufus", //Required
"AbsoluteIconPath": "Rufus",
"AbsoluteManifestPath": "Rufus",
"WorkingDirectory": "Rufus",
"LaunchParameters": "Rufus"
}
...
// Up to 50 applications total
]
```
Los únicos campos obligatorios por aplicación son el `Name` y el`AbsoluteAppPath`. Los detalles de cada campo son los siguientes:
Nombre [**Obligatorio**]
+ Un nombre de pila para su solicitud a fin de identificarla
+ Entre 1 y 100 caracteres
+ Regex de caracteres permitidos `^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,99}$`
+ Debe ser único en un determinado AppCatalogConfig
DisplayName
+ El nombre para mostrar de una aplicación determinada para que lo vean los usuarios
+ Entre 0 y 100 caracteres
+ Regex de caracteres permitidos `^[a-zA-Z0-9][a-zA-Z0-9_. -]{0,99}$`
AbsoluteAppPath **[Obligatorio]**
+ La ruta al ejecutable para lanzar la aplicación
+ Este es el ejecutable que se lanzará cuando los usuarios seleccionen la aplicación
+ Entre 1 y 32767 caracteres
+ Este límite superior de longitud de caracteres es para admitir rutas de archivo extendidas en Windows. Asegúrese de que la AMI y la aplicación estén configuradas correctamente para admitir las rutas de archivo extendidas de Windows si utiliza rutas de archivo de más de 260 caracteres.
+ Utilice cadenas de rutas de archivos escapadas, como
+ `"C:\\Windows\\System32\\notepad.exe"`
AbsoluteManifestPath
+ Solo se aplica si está utilizando [Manifiestos específicos de la aplicación](#application-specific-manifests)
+ Ruta al archivo de manifiesto de precalentamiento de esta aplicación
+ Entre 0 y 32767 caracteres
+ Este límite superior de longitud de caracteres es para admitir rutas de archivo extendidas en Windows. Asegúrese de que la AMI y la aplicación estén configuradas correctamente para admitir las rutas de archivo extendidas de Windows si utiliza rutas de archivo de más de 260 caracteres.
+ Utilice cadenas de rutas de archivos escapadas, como
+ `"C:\\Path\\To\\PrewarmManifest.txt"`
AbsoluteIconPath
+ Ruta al archivo de iconos de la AMI que se va a utilizar en la aplicación.
+ Este icono se mostrará a los usuarios cuando transmitan esta imagen.
+ Si no se proporciona ninguno, el icono se derivará del propio archivo ejecutable.
+ Asegúrese de seleccionar los archivos de iconos con una transparencia de fondo adecuada para que sus usuarios disfruten de una buena experiencia de cliente
+ Utilice imágenes PNG
+ Entre 1 y 32767 caracteres
+ Este límite superior de longitud de caracteres es para admitir rutas de archivo extendidas en Windows. Asegúrese de que la AMI y la aplicación estén configuradas correctamente para admitir las rutas de archivo extendidas de Windows si utiliza rutas de archivo de más de 260 caracteres.
+ Utilice cadenas de rutas de archivos escapadas, como
+ `"C:\\Path\\To\\ApplicationIcon.png"`
WorkingDirectory
+ El directorio de trabajo en el que ejecutar la aplicación
+ Entre 0 y 32767 caracteres
+ Este límite superior de longitud de caracteres es para admitir rutas de archivo extendidas en Windows. Asegúrese de que la AMI y la aplicación estén configuradas correctamente para admitir las rutas de archivo extendidas de Windows si utiliza rutas de archivo de más de 260 caracteres.
+ Utilice cadenas de rutas de archivos escapadas, como
+ `"C:\\Path\\To\\Working\\Directory"`
LaunchParameters
+ Una cadena para utilizarla como parámetros de lanzamiento del ejecutable especificado en `AbsoluteAppPath`
+ Entre 0 y 1024 caracteres
+ Utilice cadenas de escape con la lista completa de los parámetros de inicio necesarios, como en el siguiente ejemplo, que muestra cómo puede utilizar los PowerShell scripts como aplicaciones si utiliza el PowerShell ejecutable como aplicación con un script incluido en los parámetros de inicio
+ AbsoluteAppPath
+ `"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe"`
+ LaunchParameters
+ `"-File \"C:\\Path\\To\\App\\Script.ps1\""`
### Ejemplo AppCatalogConfig
Este es un ejemplo básico de una aplicación AppCatalogConfig para el Bloc de notas, Google Chrome y Mozilla Firefox
```
[
{
"Name": "Notepad",
"DisplayName": "Notepad",
"AbsoluteAppPath": "C:\\Windows\\System32\\notepad.exe"
},
{
"Name": "Chrome",
"DisplayName": "Chrome",
"AbsoluteAppPath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
"LaunchParameters": "https://www.amazon.com/"
},
{
"Name": "Firefox",
"DisplayName": "Firefox",
"AbsoluteAppPath": "C:\\Program Files\\Mozilla Firefox\\firefox.exe",
"LaunchParameters": "https://aws.amazon.com/"
}
]
```
# Exportar imagen
Puede exportar sus imágenes para crearlas EC2 AMIs. Más tarde, puede AMIs volver a [Importar imagen](import-image.md) utilizarlas para crear imágenes de WorkSpaces aplicaciones. Esto le ayuda a utilizar sus propias herramientas de personalización de AMI para personalizar sus imágenes.
**nota**
Durante la exportación, los siguientes componentes se eliminarán de sus imágenes
WorkSpaces Agente de aplicaciones
La licencia de Microsoft incluía aplicaciones, que se agregaron mediante Image Builder
Solo se pueden exportar imágenes de Microsoft Windows Server 2022 y 2025.
## Requisitos de rol de IAM
**importante**
Cree una función de IAM con los siguientes permisos para utilizarla en la exportación e importación:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowCopyImage",
"Effect": "Allow",
"Action": "ec2:CopyImage",
"Resource": "*"
},
{
"Sid": "AllowDescribeImages",
"Effect": "Allow",
"Action": "ec2:DescribeImages",
"Resource": "*"
},
{
"Sid": "AllowCreateTags",
"Effect": "Allow",
"Action": "ec2:CreateTags",
"Resource": "*"
}
]
}
```
Añada la siguiente relación de confianza para este rol de IAM
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "appstream.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
## Exportar una imagen
1. Abra la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)
1. En el panel de navegación, elija **Imágenes** e **Registro de imágenes**.
1. En la lista de imágenes, seleccione la imagen privada que desee exportar.
1. Elija **Acciones**, **Exportar**.
1. En el cuadro de diálogo **Exportar imagen**, escriba un **nombre único de la AMI** y, si lo desea, una **descripción** de la AMI.
1. **Función de IAM**: seleccione la función de IAM que ha creado para la exportación de imágenes.
1. Si lo desea, puede copiar las etiquetas de la imagen a la AMI marcando la casilla **Copiar etiquetas en la exportación**.
1. Seleccione **Exportar imagen**.
# Cree la imagen de sus WorkSpaces aplicaciones de Amazon mediante programación mediante las operaciones CLI de Image Assistant
Puede crear imágenes de Amazon WorkSpaces Applications conectándose a un generador de imágenes y utilizando las operaciones de la interfaz gráfica de usuario (GUI) o la interfaz de línea de comandos (CLI) de Image Assistant. Las operaciones de la CLI de Image Assistant proporcionan funcionalidad similar a la de la GUI de Image Assistant. Con estas operaciones, puede hacer lo siguiente mediante programación:
+ Administrar las aplicaciones incluidas en una imagen.
+ Guardar, actualizar y restablecer la configuración predeterminada de las aplicaciones.
+ Habilite o deshabilite el marco de WorkSpaces aplicaciones dinámico de Applications.
+ Especificar etiquetas.
+ Crear una imagen.
Puede utilizar estas operaciones para integrar la creación de imágenes de WorkSpaces aplicaciones con su proceso continuo de desarrollo de software de integración o despliegue.
Para trabajar con las operaciones de la CLI de Image Assistant, utilice el shell de línea de comandos de su elección en un generador de imágenes. Por ejemplo, puede utilizar la línea de comandos de Windows o PowerShell.
**nota**
El generador de imágenes debe usar una versión del agente de WorkSpaces aplicaciones que se publique a partir del 26 de julio de 2019. Si no dispone de un generador de imágenes, debe crear uno. Para obtener más información, consulte [Lanzar un generador de imágenes para instalar y configurar aplicaciones de streaming](tutorial-image-builder-create.md).
**Topics**
+ [Creación de la configuración predeterminada de las aplicaciones y de Windows con las operaciones de la CLI de Image Assistant](create-default-app-windows-settings-image-assistant.md)
+ [Optimización del rendimiento de lanzamiento de las aplicaciones mediante operaciones de la CLI de Image Assistant](optimize-app-launch-performance-image-assistant-cli.md)
+ [Descripción general del proceso para crear mediante programación una imagen de Amazon Applications WorkSpaces](process-overview-creating-image-programmatically-image-assistant-cli.md)
+ [Operaciones de CLI de Image Assistant para crear y administrar la imagen de sus WorkSpaces aplicaciones de Amazon](cli-operations-managing-creating-image-image-assistant.md)
# Creación de la configuración predeterminada de las aplicaciones y de Windows con las operaciones de la CLI de Image Assistant
Puede crear la configuración predeterminada de las aplicaciones y de Windows para que los usuarios puedan comenzar a utilizar sus aplicaciones rápidamente. Al crear estos ajustes, WorkSpaces Applications reemplaza el perfil de usuario predeterminado de Windows por el perfil que usted configure. El perfil de usuario predeterminado de Windows se utiliza a continuación para crear la configuración inicial para los usuarios en la instancia de la flota. Si crea esta configuración mediante operaciones de la CLI de Image Assistant, el instalador de la aplicación o la automatización deben modificar el perfil de usuario predeterminado de Windows directamente.
Para sobrescribir el perfil de usuario predeterminado de Windows por el de otro usuario de Windows, también puede utilizar la operación `update-default-profile` de la CLI de Image Assistant.
Para obtener más información sobre cómo configurar las aplicaciones predeterminadas y los ajustes de Windows, consulte *Creación de aplicaciones y ajustes de Windows predeterminados para los usuarios de sus WorkSpaces aplicaciones* en[Configuración predeterminada de aplicaciones y Windows y rendimiento de lanzamiento de aplicaciones en Amazon WorkSpaces Applications](customizing-appstream-images.md).
# Optimización del rendimiento de lanzamiento de las aplicaciones mediante operaciones de la CLI de Image Assistant
WorkSpaces Las aplicaciones le permiten optimizar el rendimiento de lanzamiento de las aplicaciones para las sesiones de streaming de los usuarios. Si lo hace mediante las operaciones de la CLI de Image Assistant, puede especificar los archivos que se deben optimizar para el lanzamiento de la aplicaciones. Si se agregan los archivos al manifiesto de optimización de la aplicación, se reduce el tiempo que se tarda en lanzar la aplicación por primera vez en una nueva instancia de la flota. Sin embargo, esto también aumenta el tiempo que se tarda en que las instancias de la flota estén disponibles para los usuarios. El manifiesto de optimización es un archivo de texto delimitado por líneas que se crea para cada aplicación.
**nota**
Si añade manifiestos de optimización de aplicaciones mediante operaciones de la CLI de Image Assistant y la GUI de Image Assistant, ambos manifiestos se combinan.
A continuación, se muestra un ejemplo de un archivo de manifiesto de optimización de aplicaciones:
```
C:\Program Files (x86)\Notepad++\autoCompletion
C:\Program Files (x86)\Notepad++\localization
C:\Program Files (x86)\Notepad++\plugins
C:\Program Files (x86)\Notepad++\themes
C:\Program Files (x86)\Notepad++\updater
C:\Program Files (x86)\Notepad++\userDefineLangs
C:\Program Files (x86)\Notepad++\change.log
C:\Program Files (x86)\Notepad++\config.xml
C:\Program Files (x86)\Notepad++\contextMenu.xml
C:\Program Files (x86)\Notepad++\doLocalConf.xml
C:\Program Files (x86)\Notepad++\functionList.xml
C:\Program Files (x86)\Notepad++\langs.model.xml
C:\Program Files (x86)\Notepad++\license.txt
C:\Program Files (x86)\Notepad++\notepad++.exe
C:\Program Files (x86)\Notepad++\readme.txt
C:\Program Files (x86)\Notepad++\SciLexer.dll
C:\Program Files (x86)\Notepad++\shortcuts.xml
C:\Program Files (x86)\Notepad++\stylers.model.xml
```
Para obtener más información sobre cómo optimizar el rendimiento de lanzamiento de las aplicaciones, consulte *Optimización del rendimiento de lanzamiento de las aplicaciones* en [Configuración predeterminada de aplicaciones y Windows y rendimiento de lanzamiento de aplicaciones en Amazon WorkSpaces Applications](customizing-appstream-images.md).
# Descripción general del proceso para crear mediante programación una imagen de Amazon Applications WorkSpaces
Puede utilizar las operaciones CLI de Image Assistant con la automatización de la instalación de aplicaciones para crear un flujo de trabajo de creación de imágenes de WorkSpaces aplicaciones totalmente programático. Cuando finalice la automatización de la instalación de aplicaciones, pero antes de crear la imagen, utilice las operaciones de la CLI de Image Assistant para especificar lo siguiente:
+ Los archivos ejecutables que pueden lanzar los usuarios
+ Los manifiestos de optimización de las aplicaciones
+ Metadatos de imágenes WorkSpaces de otras aplicaciones
La siguiente descripción general de alto nivel describe el proceso de creación mediante programación de una imagen de WorkSpaces aplicaciones.
1. Utilice la automatización de la instalación de aplicaciones para instalar las aplicaciones necesarias en el generador de imágenes. Esta instalación puede incluir las aplicaciones que lanzarán los usuarios, las dependencias y las aplicaciones en segundo plano.
1. Determine los archivos y las carpetas que se deben optimizar.
1. Si corresponde, utilice la operación `add-application` CLI de Image Assistant para especificar los metadatos de la aplicación y el manifiesto de optimización de la imagen de la WorkSpaces aplicación.
1. Para especificar aplicaciones adicionales para la imagen de WorkSpaces aplicaciones, repita los pasos 1 a 3 para cada aplicación según sea necesario.
1. Si procede, utilice la operación `update-default-profile` de la CLI de Image Assistant para sobrescribir el perfil predeterminado de Windows y crear la configuración predeterminada de las aplicaciones y de Windows para los usuarios.
1. Utilice la operación `create-image` de la CLI de Image Assistant para crear la imagen.
# Operaciones de CLI de Image Assistant para crear y administrar la imagen de sus WorkSpaces aplicaciones de Amazon
En esta sección se describen las operaciones de CLI de Image Assistant que puede utilizar para crear y administrar la imagen de WorkSpaces aplicaciones.
En los generadores de imágenes de Windows, el archivo ejecutable que incluye la interfaz de línea de comandos se encuentra en: C:\$1Program Files\$1 Amazon\$1 Photon\$1ConsoleImageBuilder\$1 Image-Assistant.exe. Para su comodidad, este archivo ejecutable se incluye en la variable PATH de Windows. Esto le permite llamar a las operaciones de la CLI de Image Assistant sin especificar la ruta completa del archivo ejecutable. Para llamar a estas operaciones, escriba el comando **image-assistant.exe**.
En los generadores de imágenes de Linux, la herramienta de asistente de imágenes se encuentra en/usr/local/appstream/image-assistant/AppStreamImageAssistant, with a symbolic link at /bin/AppStreamImageAssistant.
## Operación de `help`
Recupera una lista de todas las operaciones de la CLI de Image Assistant. Para cada operación de la lista, se muestra una descripción y la sintaxis de uso. Para mostrar ayuda para una operación específica, escriba el nombre de la operación y especifique el parámetro **-help**. Por ejemplo:
```
add-application --help
```
**Sinopsis**
```
help
```
**Salida**
Imprime en la salida estándar la lista de las operaciones disponibles con una descripción de su función.
## Operación de `add-application`
Añade la aplicación a la lista de WorkSpaces aplicaciones para los usuarios de aplicaciones. Las aplicaciones de esta lista se incluyen en el catálogo de aplicaciones. El catálogo de aplicaciones se muestra a los usuarios cuando inician sesión en una sesión de streaming de WorkSpaces aplicaciones.
**nota**
Si necesita realizar cambios en la configuración de una aplicación, elimine la aplicación y añada la aplicación con la configuración actualizada.
**Sinopsis**
```
add-application
--name
--absolute-app-path
[--display-name ]
[--absolute-icon-path ]
[--working-directory ]
[--launch-parameters <""-escaped value>]
[--absolute-manifest-path ]
```
**Opciones**
**`--name` (cadena)**
Un nombre único para la aplicación. La longitud máxima es de 256 caracteres. Puede añadir hasta 50 aplicaciones. No puede utilizar caracteres de espacio en blanco.
**`--absolute-app-path` (cadena)**
La ruta completa del archivo ejecutable, el archivo de procesamiento por lotes o el script de la aplicación. La ruta debe apuntar a un archivo válido.
**`--display-name` (cadena)**
El nombre que se usará para la aplicación en el catálogo de aplicaciones. Si no especifica un nombre para mostrar, WorkSpaces Applications crea un nombre derivado del nombre del archivo ejecutable. El nombre se crea sin la extensión de archivo y con guiones bajos en lugar de espacios. La longitud máxima es de 256 caracteres.
**`--absolute-icon-path` (cadena)**
La ruta completa para el icono de la aplicación. La ruta debe apuntar a un archivo de icono válido de uno de los siguientes tipos: .jpg, .png o .bmp. Las dimensiones máximas son: 256 px x 256 px. Si no especifica una ruta, se utiliza el icono predeterminado del archivo ejecutable, si está disponible. Si no hay un icono predeterminado disponible para el archivo ejecutable, se utiliza un icono de aplicación de WorkSpaces aplicaciones predeterminado.
**`--working-directory` (cadena)**
El directorio de trabajo inicial de la aplicación cuando se lanza.
**`--absolute-manifest-path` (cadena)**
La ruta de un archivo de texto nuevo delimitado por líneas. El archivo especifica las rutas absolutas de los archivos que se deben optimizar antes de que la instancia de la flota esté disponible para un usuario mediante streaming. La ruta debe apuntar a un archivo de texto válido.
**Mensajes de salida**
| Código de salida | Mensaje que se muestra en la salida estándar | Description (Descripción) |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | La aplicación se añadió correctamente. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | Se necesitan privilegios de administrador para llevar a cabo la operación. |
| 1 | \$1"status": 1, "message": "Unable to add more than 50 apps to the catalog."\$1 | No se pudo agregar la aplicación porque el número máximo de aplicaciones que se pueden agregar al catálogo de WorkSpaces aplicaciones es 50. |
| 1 | \$1"status": 1, "message": "Name is not unique"\$1 | Ya existe una aplicación con ese nombre en el catálogo de WorkSpaces aplicaciones. |
| 1 | \$1"estado»: 1, «mensaje»: «No se ha encontrado el archivo (absolute-app-path)"\$1 | No es posible encontrar el archivo especificado para absolute-app-path. |
| 1 | \$1"status": 1, "message": "Unsupported file extension"\$1 | El parámetro Absolute-app-path solo es compatible con los siguientes tipos de archivos: .exe y .bat. |
| 1 | \$1"status": 1, "message": "Directory not found (working-directory)" | No es posible encontrar el directorio especificado para working-directory. |
| 1 | \$1"status": 1, "message": "Optimization-manifest not found: "\$1 | No es posible encontrar el archivo especificado para optimization-manifest. |
| 1 | \$1"status": 1, "message": "File not found: "\$1 | No es posible encontrar un archivo especificado en el manifiesto de optimización. |
| 255 | \$1"status": 255, "message": \$1 | Se ha producido un error inesperado. Intente volver a realizar la solicitud. Si el error persiste, ponte en contacto con nosotros AWS Support para obtener ayuda. Para obtener más información, consulte el [Centro de AWS Support](https://console.aws.amazon.com/support/home#/). |
## Operación de `remove-application`
Elimina una aplicación de la lista de aplicaciones de la imagen de WorkSpaces aplicaciones. La aplicación no se desinstala ni se modifica, pero los usuarios no podrán iniciarla desde el catálogo de WorkSpaces aplicaciones de aplicaciones.
**Sinopsis**
```
remove-application
--name
```
**Opciones**
**`--name` (cadena)**
El identificador único de la aplicación que se va a eliminar.
**Mensajes de salida**
| Código de salida | Mensaje que se muestra en la salida estándar | Description (Descripción) |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | La aplicación se ha eliminado correctamente. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | Se necesitan privilegios de administrador para llevar a cabo la operación. |
| 1 | \$1"status": 1, "message": "App not found"\$1 | La aplicación que se especificó no se encuentra en el catálogo de WorkSpaces aplicaciones. |
| 255 | \$1"status": 255, "message": \$1 | Se ha producido un error inesperado. Intente volver a realizar la solicitud. Si el error persiste, póngase en contacto con nosotros AWS Support para obtener ayuda. Para obtener más información, consulte el [Centro de AWS Support](https://console.aws.amazon.com/support/home#/). |
## Operación de `list-applications`
Muestra una lista de todas las aplicaciones especificadas en el catálogo de aplicaciones.
**Sinopsis**
```
list-applications
```
**Mensajes de salida**
| Código de salida | Mensaje que se muestra en la salida estándar | Description (Descripción) |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success", "applications": [ \$1..app1.. \$1, \$1 ..app2.. \$1]\$1 | Lista de aplicaciones en el catálogo de WorkSpaces aplicaciones. |
| 255 | \$1"status": 255, "message": \$1 | Se ha producido un error inesperado. Intente volver a realizar la solicitud. Si el error persiste, póngase en contacto con nosotros AWS Support para obtener ayuda. Para obtener más información, consulte el [Centro de AWS Support](https://console.aws.amazon.com/support/home#/). |
## Operación de `update-default-profile`
Copia el perfil de usuario de Windows especificado en el perfil de usuario predeterminado de Windows. Los usuarios nuevos que utilicen el streaming heredan la configuración almacenada en el perfil especificado.
**nota**
La herramienta de la CLI del asistente de imágenes de Linux no admite esta operación.
**Sinopsis**
```
update-default-profile
[--profile ]
```
**Opciones**
**`--profile` (cadena)**
El nombre del usuario cuyo perfil de Windows se copiará en el perfil de usuario predeterminado de Windows. Utilice el formato siguiente para el nombre:
"\$1"
Si el generador de imágenes no se ha unido a un dominio de Microsoft Active Directory, escriba un punto "." para el dominio. Si no especifica un usuario, se utilizará la cuenta de usuario de la plantilla de WorkSpaces aplicaciones.
**Mensajes de salida**
| Código de salida | Mensaje que se muestra en la salida estándar | Description (Descripción) |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | La configuración de usuario se ha copiado correctamente al perfil predeterminado de Windows. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | Se necesitan privilegios de administrador para llevar a cabo la operación. |
| 1 | \$1"status": 1, "message": "Unable to copy file or folder: . "\$1 | La configuración de usuario no se pudo copiar porque un archivo o carpeta no estaba disponible. |
| 1 | \$1"status": 1, "message": "Cannot copy a domain user when not joined to a domain""\$1 | Se ha especificado un usuario de un dominio de Microsoft Active Directory, pero el generador de imágenes no se ha unido a un dominio de Active Directory. |
| 255 | \$1"status": 255, "message": \$1 | Se ha producido un error inesperado. Intente volver a realizar la solicitud. Si el error persiste, póngase en contacto con nosotros AWS Support para obtener ayuda. Para obtener más información, consulte el [Centro de AWS Support](https://console.aws.amazon.com/support/home#/). |
## Operación de `reset-user-profile`
Elimina el perfil de usuario de Windows para el usuario especificado.
**nota**
La herramienta de la CLI del asistente de imágenes de Linux no admite esta operación.
**Sinopsis**
```
reset-user-profile
[--profile ]
```
**Opciones**
**`--profile` (cadena)**
El nombre del usuario de Windows cuyo perfil de Windows se eliminará. Utilice el formato siguiente para el nombre:
"\$1"
Si el generador de imágenes no se ha unido a un dominio de Microsoft Active Directory, escriba un punto "." para el dominio.
**Mensajes de salida**
| Código de salida | Mensaje que se muestra en la salida estándar | Description (Descripción) |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | Se ha eliminado correctamente la configuración del usuario especificado. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | Se necesitan privilegios de administrador para llevar a cabo la operación. |
| 1 | \$1"status": 1, "message": "Unable to copy file or folder: . "\$1 | La configuración del usuario no se pudo restablecer porque un archivo o carpeta no estaba disponible. |
| 1 | \$1"status": 1, "message": "Cannot copy a domain user when not joined to a domain""\$1 | Se ha especificado un usuario de un dominio de Microsoft Active Directory, pero el generador de imágenes no se ha unido a un dominio de Active Directory. |
| 255 | \$1"status": 255, "message": \$1 | Se ha producido un error inesperado. Intente volver a realizar la solicitud. Si el error persiste, ponte en contacto con nosotros AWS Support para obtener ayuda. Para obtener más información, consulte el [Centro de AWS Support](https://console.aws.amazon.com/support/home#/). |
## Operación de `create-image`
Inicia el flujo de trabajo de creación de imágenes, lo que da como resultado una imagen de WorkSpaces aplicaciones que se puede utilizar para WorkSpaces las flotas de aplicaciones.
**Sinopsis**
```
create-image
--name
[--description ]
[--display-name ]
[--enable-dynamic-app-catalog] | [--no-enable-dynamic-app-catalog]
[--use-latest-agent-version] | [--no-use-latest-agent-version]
[--tags ]
[--dry-run]
```
**Opciones**
**`--name` (cadena)**
El nombre de la imagen de WorkSpaces aplicaciones. El nombre debe ser único en la cuenta y la AWS región de Amazon Web Services. La longitud máxima es de 100 caracteres. Los caracteres permitidos son:
a-z, A-Z, 0-9, guiones bajos (\$1), guiones (-) y puntos (.)
El nombre de la imagen no puede comenzar por ninguno de los siguientes prefijos: "aws', "appstream" y "amazon". Estos prefijos están reservados para uso de AWS .
**`--description` (cadena)**
La descripción que se va a mostrar para la imagen. La longitud máxima es de 256 caracteres.
**`--display-name` (cadena)**
El nombre que se va a mostrar para la imagen. La longitud máxima es de 256 caracteres.
**`--enable-dynamic-app-catalog` \$1 `--no-enable-dynamic-app-catalog`**
Habilita o deshabilita la compatibilidad con el marco de WorkSpaces aplicaciones dinámico de Applications. Si no especifica uno de los parámetros, la compatibilidad con el marco de aplicaciones dinámicas no está habilitada.
El marco de aplicaciones dinámicas proporciona operaciones dentro de una instancia de streaming de WorkSpaces aplicaciones que puede utilizar para crear un proveedor de aplicaciones dinámicas. Los proveedores de aplicaciones dinámicas pueden utilizar estas operaciones para modificar el catálogo de aplicaciones al que los usuarios pueden tener acceso en tiempo real. Para obtener más información, consulte [Utilice el marco de WorkSpaces aplicaciones dinámicas para crear un proveedor de aplicaciones dinámicas](build-dynamic-app-provider.md).
**`--use-latest-agent-version` \$1 `--no-use-latest-agent-version`**
Especifica si se debe fijar la imagen a la versión del agente de WorkSpaces aplicaciones que está instalada actualmente o si se debe utilizar siempre la versión más reciente del agente. Si no especifica ninguno de los parámetros, la imagen se fija a la versión del agente de WorkSpaces aplicaciones que esté instalada actualmente. Para obtener más información, consulte [Gestione WorkSpaces las versiones del agente de aplicaciones](base-images-agent.md).
**`--tags` (cadena)**
Las etiquetas que se deben asociar a la imagen. Una etiqueta es un par clave-valor. Use el siguiente formato:
--tags "miclave" "mivalor" "miclave2" "mivalor2"
Para obtener más información acerca de las etiquetas, consulte [Cómo etiquetar los recursos de tus WorkSpaces aplicaciones de Amazon](tagging-basic.md).
**`--dry-run` (cadena)**
Realiza la validación sin crear la imagen. Utilice este comando para identificar si la imagen tiene algún problema antes de crearla.
**Mensajes de salida**
| Código de salida | Mensaje que se muestra en la salida estándar | Description (Descripción) |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | El flujo de trabajo para crear la imagen se inició correctamente. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | Se necesitan privilegios de administrador para llevar a cabo la operación. |
| 1 | \$1"status": 1, "message": "An image with the given name already exists"\$1 | Ya existe una imagen con el nombre especificado en la cuenta de Amazon Web Services. |
| 1 | \$1"status": 1, "message": "Invalid value (tags)"\$1 | Las etiquetas especificadas no son válidas. |
| 255 | \$1"status": 255, "message": \$1 | Se ha producido un error inesperado. Intente volver a realizar la solicitud. Si el error persiste, póngase en contacto con nosotros AWS Support para obtener ayuda. Para obtener más información, consulte el [Centro de AWS Support](https://console.aws.amazon.com/support/home#/). |
# Creación de imágenes basadas en Linux
Puede crear imágenes de WorkSpaces Amazon Applications basadas en Linux conectándose a un generador de imágenes de Linux, instalando las aplicaciones que necesite, creando parámetros de aplicación y variables de entorno predeterminados y utilizando una herramienta de interfaz de línea de comandos (CLI) o una herramienta Image Assistant (GUI) para añadir estas aplicaciones al catálogo de aplicaciones. Para abrir la herramienta GUI, busque **Image Assistant** en la lista de aplicaciones.
**Topics**
+ [Creación de la configuración predeterminada de la aplicación para los usuarios](create-default-app-settings.md)
+ [Creación de variables de entorno predeterminadas para los usuarios de Linux](create-default-variables-linux.md)
+ [Optimización del rendimiento de lanzamiento de las aplicaciones de Linux](optimize-launch-performance.md)
+ [Creación de scripts de sesión](create-session-scripts.md)
+ [Uso de la herramienta CLI de Image Assistant para Linux](image-assistant-cli.md)
+ [Habilitación y deshabilitación de la compatibilidad con cámaras web](webcam-support.md)
+ [Habilitación y deshabilitación del modo de sincronización de archivos pesados en las carpetas de inicio](heavy-file-sync.md)
+ [Tutorial: Crear una imagen personalizada de aplicaciones basadas en Linux WorkSpaces](tutorial-create-linux-image.md)
+ [Tutorial: habilitación de la compatibilidad con el japonés para las imágenes de Linux](enable-japanese-support-linux.md)
# Creación de la configuración predeterminada de la aplicación para los usuarios
Siga estos pasos para crear la configuración predeterminada de la aplicación para los usuarios.
**Topics**
+ [Paso 1: instalación de aplicaciones Linux en el constructor de imágenes](#app-settings-image-install)
+ [Paso 2: Crear una cuenta TemplateUser](#app-settings-template-user)
+ [Paso 3: creación de la configuración predeterminada de la aplicación](#app-settings-image-create-default-app-settings)
+ [Paso 4: creación de la configuración predeterminada de la aplicación](#app-settings-image-save-default-app-settings)
+ [Paso 5: prueba de la configuración predeterminada de la aplicación (opcional)](#app-settings-image-test-applications)
+ [Paso 6: eliminación](#app-settings-image-finish)
## Paso 1: instalación de aplicaciones Linux en el constructor de imágenes
En este paso, se conecta un constructor de imágenes de Linux y se instalan sus aplicaciones en el constructor de imágenes.
**Para instalar aplicaciones en el generador de imágenes**
1. Conéctese al constructor de imágenes mediante uno de los siguientes métodos:
+ [Utilice la consola de WorkSpaces aplicaciones (solo](managing-image-builders-connect-console.md) para conexiones web)
+ [Cree una URL de transmisión](managing-image-builders-connect-streaming-URL.md) (para conexiones de clientes web o de WorkSpaces aplicaciones)
**nota**
Iniciará sesión como ImageBuilderAdmin usuario en el escritorio GNOME de Amazon Linux y tendrá privilegios de administrador root.
1. Instale las aplicaciones que necesite. Por ejemplo, para instalar un navegador Chromium desde un repositorio de yum público, abra primero la aplicación Terminal y, a continuación, ejecute el siguiente comando:
**[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164**
## Paso 2: Crear una cuenta TemplateUser
En este paso, crea una TemplateUser cuenta, que crea la configuración de aplicación predeterminada para sus usuarios de streaming.
**Para crear una TemplateUser cuenta**
1. Cree una TemplateUser cuenta que no tenga permisos de root. Por ejemplo, en una ventana de Terminal, ejecuta los siguientes comandos para crear TemplateUser en el generador de imágenes:
**[ImageBuilderAdmin]\$1 sudo useradd -m TemplateUser**
**[ImageBuilderAdmin]\$1 echo -e '<*password*>\$1n<*password*>\$1n' \$1 sudo passwd TemplateUser**
1. Cambia a la TemplateUser cuenta:
**[ImageBuilderAdmin]\$1 su - TemplateUser**
## Paso 3: creación de la configuración predeterminada de la aplicación
En este paso, crea la configuración de aplicación predeterminada para los usuarios de sus WorkSpaces aplicaciones. De este modo, los usuarios pueden empezar a utilizar las aplicaciones rápidamente durante sus sesiones de streaming de WorkSpaces aplicaciones, sin necesidad de crear o configurar estos ajustes ellos mismos.
**Para crear la configuración predeterminada de la aplicación para los usuarios**
1. Inicie la aplicación para la que desee crear la configuración predeterminada. Por ejemplo, en una ventana Terminal, ejecute el siguiente comando para iniciar el navegador Chromium:
**[TemplateUser]\$1 chromium-browser**
1. Configure las opciones de la aplicación. Por ejemplo, configure la página de inicio del navegador Chromium como **https://aws.amazon.com**.
1. Cierre las aplicaciones.
1. Cierre la sesión:
**[TemplateUser]\$1 logout**
## Paso 4: creación de la configuración predeterminada de la aplicación
En este paso, copiará la configuración predeterminada de la aplicación que ha añadido al directorio **/etc/skel/** y la pondrá a disposición de los usuarios de streaming.
**Para guardar la configuración predeterminada de la aplicación**
+ Ejecute el siguiente comando en una ventana Terminal para copiar la configuración predeterminada de la aplicación para los usuarios de streaming:
**[ImageBuilderAdmin]\$1 sudo cp -r -f /home/TemplateUser/. /etc/skel**
## Paso 5: prueba de la configuración predeterminada de la aplicación (opcional)
En este paso, comprobará que las aplicaciones que ha agregado se ejecutan correctamente y que la configuración predeterminada de las aplicaciones funciona según lo previsto.
**Para probar las aplicaciones y la configuración predeterminada en un constructor de imágenes**
1. Cree un usuario de prueba que no tenga permisos raíz. Por ejemplo, en una ventana **Terminal**, ejecute los siguientes comandos para crear un **usuario-prueba** en el constructor de imágenes:
**[ImageBuilderAdmin]\$1 sudo useradd -m test-user**
**[ImageBuilderAdmin]\$1 echo -e '*password*>\$1n<*password*>\$1n' \$1 sudo passwd test-user**
1. Cambie al usuario de prueba:
**[ImageBuilderAdmin]\$1 su - test-user**
1. Abra la aplicación (p. ej., Chromium) como usuario de prueba:
**[test-user]\$1 /usr/bin/chromium-browser**
1. Comprueba que la configuración predeterminada esté disponible para el usuario de prueba (por ejemplo, la página de inicio de Chromium es https://aws.amazon.com/).
1. Cierre la sesión:
**[test-user]\$1 logout**
## Paso 6: eliminación
Por último, el paso final consiste en eliminar.
**Eliminación**
1. Eliminar TemplateUser:
**[ImageBuilderAdmin]\$1 sudo killall -u TemplateUser**
**[ImageBuilderAdmin]\$1 sudo userdel -r TemplateUser**
1. Elimine test-user (no es obligatorio si omitió el paso 5):
**[ImageBuilderAdmin]\$1 sudo killall -u test-user**
**ImageBuilderAdmin]\$1 sudo userdel -r test-user**
# Creación de variables de entorno predeterminadas para los usuarios de Linux
Puede crear variables de entorno en una instancia de Image Builder de Linux. La creación de variables de entorno hace que estén disponibles en las instancias de streaming creadas a partir de esa imagen.
**nota**
En las instancias de flota Linux, las variables de entorno configuradas mediante la herramienta Image Assistant (GUI) y las variables de entorno del sistema predeterminadas se exportan mediante el script/etc/profile.d/appstream\$1system\$1vars.sh script. To access these environment variables, you must explicitly source the /etc/profile.d/appstream\$1system\$1vars.sh de las aplicaciones.
**Para crear variables de entorno para los usuarios**
1. Si la carpeta `/etc/profile` no existe, ejecute el siguiente comando para crearla:
**[ImageBuilderAdmin]\$1 sudo mkdir -p /etc/profile.d**
1. Para crear un nuevo archivo de script de intérprete de comandos (por ejemplo, my-environment.sh) en esta carpeta, ejecute el siguiente comando:
**[ImageBuilderAdmin]\$1 vim my-environment.sh**
1. En la primera línea del archivo de script, añada el siguiente contenido:
**\$1\$1/bin/sh **
1. En cada línea siguiente, añada un comando **export** para establecer las variables de entorno de la imagen. En el siguiente ejemplo, se añade `$HOME/bin` a la variable `PATH`.
**export PATH=”\$1HOME/bin:\$1PATH”**
1. Pulse la tecla **Esc** para volver al modo de comando en vim y, a continuación, ejecute el siguiente comando para guardar el script y salir de vim:
**:x**
1. Ejecute el siguiente comando para permitir que el script se ejecute como un programa:
**[ImageBuilderAdmin]\$1 chmod \$1x my-environment.sh**
# Optimización del rendimiento de lanzamiento de las aplicaciones de Linux
Si utiliza la herramienta GUI de Image Assistant, la herramienta optimiza automáticamente el rendimiento de inicio de sus aplicaciones.
Si utiliza la CLI de Image Assistant, siga los siguientes pasos para optimizar el rendimiento del lanzamiento manualmente. Al crear y añadir archivos a un manifiesto de optimización de aplicaciones, la aplicación se iniciará más rápido cuando se inicie por primera vez en una nueva instancia de flota. Sin embargo, esto también aumenta el tiempo que se tarda en que las instancias de la flota estén disponibles para los usuarios. El manifiesto de optimización es un archivo de texto delimitado por líneas para cada aplicación.
Puedes crear un archivo de manifiesto (como < *your-app* >-manifest.txt) manualmente o siguiendo los pasos que se indican a continuación.
**Para crear un archivo de manifiesto**
1. Asegúrese de que la aplicación que desea optimizar esté iniciada y en ejecución.
1. Desde una terminal del constructor de imágenes de Linux, ejecute el siguiente comando:
**ps -ef \$1 grep <*application-process-name*>**
1. Busque el número PID más pequeño del resultado del último paso. Este es el PID del proceso principal raíz de la aplicación.
1. Mantenga la aplicación en ejecución y asegúrese de utilizar los componentes iniciales que necesitan los usuarios. De esta forma, garantiza que el proceso de optimización capture estos componentes.
1. Cree un archivo de script (p. ej., `~/getfilestool.sh`), con el siguiente contenido:
```
#!/bin/bash
## usage getfilestool.sh $pid
lsof -p $(pstree -p $1 | grep -o '([0-9]\+)' | grep -o '[0-9]\+' | tr '\012' ,)|grep REG | sed -n '1!p' | awk '{print $9}'|awk 'NF'
```
1. Asegúrese de que el archivo pueda ejecutarse con el siguiente comando:
**[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh**
1. Ejecute el siguiente comando para capturar todos los archivos en ejecución del proceso principal raíz que se encuentra en el paso 3 y guárdelos en un archivo de manifiesto temporal.
**[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh <*root-parent-pid*> > /tmp/-manifest.txt **
1. Compruebe el contenido del manifiesto de optimización, que es un archivo de texto delimitado por líneas para cada aplicación.
Puede especificar el manifiesto de optimización para cada aplicación mediante las operaciones de la herramienta de interfaz de la línea de comandos (CLI) de Image Assistant. Para obtener más información, consulte [Uso de la herramienta CLI de Image Assistant para Linux](image-assistant-cli.md).
# Creación de scripts de sesión
WorkSpaces Las aplicaciones proporcionan scripts de sesión en la instancia en las instancias de streaming basadas en Windows y Linux. Para obtener más información acerca de los scripts de sesión, consulte [Usa scripts de sesión para gestionar la experiencia de streaming de tus usuarios de Amazon WorkSpaces Applications](use-session-scripts.md).
Los scripts de sesión se especifican dentro de una imagen de aplicaciones. WorkSpaces Para localizar el archivo de configuración de los scripts de sesión en una instancia de Linux, vaya a `/opt/appstream/SessionScripts/config.json`. El siguiente código es un archivo `config.json` de ejemplo que especifica un script de inicio de sesión denominado “`test-session-start`” y un script de fin de sesión denominado “`test-session-stop`” junto con sus parámetros de tiempo de ejecución. Asegúrese de que los scripts a los que se hace referencia en el documento `config.json` tengan permisos de ejecución y de haber definido un intérprete de comandos (por ejemplo, \$1\$1/bin/bash).
```
{
"SessionStart": {
"Executables": [
{
"Context": "system",
"Filename": "/opt/appstream/SessionScripts/test-session-start",
"Arguments": "arg1",
"S3LogEnabled": true
}
],
"WaitingTime": 30
},
"SessionTermination": {
"Executables": [
{
"Context": "system",
"Filename": "/opt/appstream/SessionScripts/test-session-stop",
"Arguments": "arg2",
"S3LogEnabled": true
}
],
"WaitingTime": 30
}
}
```
# Uso de la herramienta CLI de Image Assistant para Linux
En un generador de imágenes basado en Linux, puede usar la herramienta CLI Image Assistant **AppStreamImageAssistant**para crear y administrar la imagen de sus WorkSpaces aplicaciones. La herramienta se encuentra en `/usr/local/appstream/image-assistant/AppStreamImageAssistant` con un enlace simbólico en `/bin/AppStreamImageAssistant`. Esta herramienta CLI para Linux admite muchas de las mismas operaciones que la herramienta CLI de Image Assistant para Windows. Para obtener más información sobre estas operaciones, consulte [Operaciones de CLI de Image Assistant para crear y administrar la imagen de sus WorkSpaces aplicaciones de Amazon](cli-operations-managing-creating-image-image-assistant.md).
# Habilitación y deshabilitación de la compatibilidad con cámaras web
WorkSpaces Applications admite audio y vídeo (AV) en tiempo real al redirigir la entrada de vídeo de la cámara web local a las sesiones de streaming de Applications. WorkSpaces Esta capacidad permite a los usuarios utilizar su cámara web local para realizar videoconferencias y audioconferencias dentro de una WorkSpaces sesión de streaming de aplicaciones. Gracias a la tecnología AV en tiempo real y a la compatibilidad con audio en tiempo real, sus usuarios pueden colaborar utilizando aplicaciones de videoconferencia y audioconferencia conocidas sin tener que abandonar la sesión de streaming de WorkSpaces las aplicaciones.
Para utilizar esta función, debe utilizar una imagen de WorkSpaces aplicaciones de Linux que utilice un agente de WorkSpaces aplicaciones de Linux publicado el 21 de septiembre de 2022 o después de esa fecha.
**nota**
La AV en tiempo real no es compatible con las instancias stream.standard.small que funcionan con Rocky Linux o Red Hat Enterprise Linux. Los usuarios no ven los iconos de cámara y micrófono en la barra de herramientas del cliente.
La característica de AV en tiempo real está habilitada de forma predeterminada para las sesiones de streaming de Linux. Para configurar los permisos de cámara web para sus usuarios en un constructor de imágenes de Linux, cree `/etc/appstream/appstream.conf` y añada el siguiente contenido:
**nota**
Especifique **1** para habilitar o especifique **0** para deshabilitar la cámara web.
```
[webcam]
permission = 1
```
# Habilitación y deshabilitación del modo de sincronización de archivos pesados en las carpetas de inicio
Puede habilitar las opciones de carpetas de Amazon Simple Storage Service inicio para su organización. Al habilitar Amazon S3 Home Folders para una pila de WorkSpaces aplicaciones, los usuarios de la pila pueden acceder a una carpeta de almacenamiento persistente durante sus sesiones de streaming de aplicaciones. Los usuarios no tienen que realizar ninguna configuración adicional para tener acceso a su carpeta de inicio. Los datos almacenados por los usuarios en su carpeta de inicio se copian automáticamente en un bucket de Amazon S3 de la suya y se ponen a disposición de esos usuarios en sesiones posteriores. Cuenta de AWS Para obtener más información, consulte [Habilite y administre las carpetas de inicio para los usuarios de sus WorkSpaces aplicaciones](home-folders.md).
Para garantizar una experiencia fluida y abordar algunas limitaciones existentes, por las que se puede observar una sincronización de archivos incoherente cuando los usuarios guardan archivos de texto de gran tamaño de sus instancias de streaming en sus carpetas de inicio, los administradores de WorkSpaces aplicaciones pueden activar la opción de configuración **heavy\$1sync** si es habitual que los usuarios suban archivos de gran tamaño a Amazon S3 mientras utilizan Aplicaciones. WorkSpaces Activar esta opción podría añadir algo de latencia al proceso de sincronización de archivos de la carpeta principal, pero se garantiza la integridad de todas las sincronizaciones con Amazon S3.
Esta función está disponible en todas las imágenes de Red Hat Enterprise Linux y en las imágenes de WorkSpaces aplicaciones de Linux que utilicen un agente de WorkSpaces aplicaciones de Linux publicado el 12 de septiembre de 2024 o después.
La característica de sincronización de archivos pesados está deshabilitada de forma predeterminada para las sesiones de streaming de Red Hat Enterprise Linux y Amazon Linux. Para configurar los permisos de sincronización de archivos pesados para sus usuarios en un generador de imágenes de Red Hat Enterprise Linux o Amazon Linux, cree `/etc/appstream/appstream.conf` y añada el siguiente contenido:
**nota**
Especifique **1** para habilitar la sincronización de archivos pesados, o **0** para deshabilitarla.
```
[storage]
heavy_sync = 1
```
# Tutorial: Crear una imagen personalizada de aplicaciones basadas en Linux WorkSpaces
En este tutorial se describe cómo crear una imagen personalizada de WorkSpaces Amazon Applications basada en Linux que contenga aplicaciones que puede transmitir a sus usuarios.
**importante**
No cree un usuario llamado "as2-streaming-user" en el generador de imágenes. Este es un nombre de usuario reservado para Fleet. Si crea este nombre de usuario fuera del flujo de trabajo de WorkSpaces aplicaciones, es posible que tenga problemas de transmisión en Fleets.
**Topics**
+ [Paso 1: instalación de aplicaciones Linux en el constructor de imágenes](#tutorial-linux-image-install)
+ [Paso 2: Generar el archivo del manifiesto de optimización de aplicaciones](#tutorial-linux-image-manifest)
+ [Paso 3: Cree un catálogo de WorkSpaces aplicaciones y aplicaciones](#tutorial-linux-image-catalog)
+ [Paso 4: Crear la configuración de la aplicación y las variables de entorno predeterminadas](#tutorial-linux-image-create-default-app-settings)
+ [Paso 5: Probar aplicaciones y configuraciones](#tutorial-linux-image-test-applications)
+ [Paso 6: finalización de la creación de la imagen](#tutorial-linux-image-finish-create-image)
+ [Paso 7 (opcional): etiquetado y copia de una imagen](#tutorial-linux-image-tag-copy)
+ [Paso 8: eliminación](#tutorial-linux-image-finish)
## Paso 1: instalación de aplicaciones Linux en el constructor de imágenes
En este paso, se conecta un constructor de imágenes de Linux y se instalan sus aplicaciones en el constructor de imágenes.
**Para instalar aplicaciones en el generador de imágenes**
1. Conéctese al constructor de imágenes mediante uno de los siguientes métodos:
+ [Utilice la consola de WorkSpaces aplicaciones](managing-image-builders-connect-console.md) (solo para conexiones web)
+ [Cree una URL de transmisión](managing-image-builders-connect-streaming-URL.md) (para conexiones de clientes web o de WorkSpaces aplicaciones)
**nota**
Iniciará sesión como ImageBuilderAdmin usuario en el escritorio GNOME de Amazon Linux y tendrá privilegios de administrador root.
1. Instale las aplicaciones que necesite. Por ejemplo, para instalar un navegador Chromium desde un repositorio de yum público, abra primero la aplicación Terminal y, a continuación, ejecute el siguiente comando:
**[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164**
**nota**
Descargue e instale las aplicaciones solo desde sitios de confianza.
## Paso 2: Generar el archivo del manifiesto de optimización de aplicaciones
En este paso, generará un archivo de manifiesto para cada aplicación que haya instalado en el paso 1.
**Para generar un archivo de manifiesto para optimizar el rendimiento de lanzamiento de una aplicación**
1. Asegúrese de que la aplicación que desea optimizar (p. ej., Chromium) esté iniciada y en ejecución.
1. En una ventana del terminal, ejecute el siguiente comando para ver los procesos relacionados con la aplicación:
**[ImageBuilderAdmin]\$1 ps -ef \$1 grep chromium **
1. Busque el PID principal raíz en el resultado del comando anterior. A continuación se muestra un ejemplo de salida, y el PID principal raíz es 16712:
**Example**
```
[ImageBuilderAdmin]$ ps -ef | grep chromium
ImageBu+ 16712 4128 0 Aug26 ? 00:00:44 /usr/lib64/chromium- browser/chromium-browser --enable-plugins --enable-extensions -- enable-user- scripts --enable-printing --enable-gpu-rasterization -- enable-sync --auto-ssl- client-auth
ImageBu+ 16726 16712 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium-browser --type=zygote --no-zygote-sandbox ImageBu+ 16727 16712 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium- browser --type=zygote
ImageBu+ 16731 16727 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium-browser --type=zygot
```
1. Mantenga la aplicación en ejecución y asegúrese de utilizar los componentes iniciales que necesitan los usuarios. De esta forma, garantiza que el proceso de optimización capture estos componentes.
1. Cree un archivo de script (p. ej., `~/getfilestool.sh`), con el siguiente contenido:
```
#!/bin/bash
## usage getfilestool.sh $pid
lsof -p $(pstree -p $1 | grep -o '([0-9]\+)' | grep -o '[0-9]\+' | tr '\012' ,)|grep REG | sed -n '1!p' | awk '{print $9}'|awk 'NF'
```
1. Verifique que el archivo se pueda ejecutar mediante el siguiente comando:
**[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh**
1. Ejecute el siguiente comando para capturar todos los archivos en ejecución del proceso principal raíz que se encuentra en el paso 3 anterior y guárdelos en un archivo de manifiesto temporal.
**[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh 16712 > /tmp/chromium-manifest.txt **
1. Compruebe el contenido del manifiesto de optimización, que es un archivo de texto delimitado por líneas para cada aplicación.
## Paso 3: Cree un catálogo de WorkSpaces aplicaciones y aplicaciones
En este paso, utilizará la herramienta `AppStreamImageAssistant` CLI del generador de imágenes para crear un catálogo de WorkSpaces aplicaciones especificando las aplicaciones de la imagen. Para cada aplicación que tenga previsto transmitir, puede especificar el nombre, el nombre de visualización, el archivo ejecutable que se va a lanzar y el icono que se mostrará.
**Para crear un catálogo de WorkSpaces aplicaciones y aplicaciones**
1. Desde el escritorio del generador de imágenes, abra el **Terminal** desde el panel lateral o abriendo la cuadrícula de aplicaciones.
1. Ejecute **AppStreamImageAssistant --help** para ver la lista de comandos disponibles. Utilizará estos comandos para añadir aplicaciones y crear una imagen.
1. Ejecute el siguiente comando para añadir una aplicación instalada (p. ej., Chromium) a la lista de WorkSpaces aplicaciones para los usuarios de aplicaciones:
```
AppStreamImageAssistant add-application \
--name Chromium \
--absolute-app-path /usr/lib64/chromium-browser/chromium-browser \
--display-name Chromium \
--absolute-icon-path /usr/share/icons/hicolor/256x256/apps/chromium-browser.png \
--absolute-manifest-path /tmp/chromium-manifest.txt
```
También puede ejecutar el siguiente comando:
```
AppStreamImageAssistant add-application \
--name="Chromium" \
--absolute-app-path="/usr/lib64/chromium-browser/chromium-browser" \
--display-name="Chromium" \
--absolute-icon-path="/usr/share/icons/hicolor/256x256/apps/chromium-browser.png" \
--absolute-manifest-path="/tmp/chromium-manifest.txt"
```
1. Para agregar más aplicaciones, repita el paso 3 para cada aplicación adicional.
1. Para ver la lista de aplicaciones que se han agregado al catálogo, junto con los metadatos, como las rutas de los iconos y los parámetros de inicio, ejecute el siguiente comando:
**AppStreamImageAssistant list-applications**
1. Para eliminar aplicaciones del catálogo, ejecute el siguiente comando:
**AppStreamImageAssistant remove-application –-name *application\$1name***
## Paso 4: Crear la configuración de la aplicación y las variables de entorno predeterminadas
En este paso, crearás la configuración de la aplicación y las variables de entorno predeterminadas para los usuarios de tus WorkSpaces aplicaciones. De este modo, los usuarios pueden empezar a utilizar las aplicaciones rápidamente durante sus sesiones de streaming de WorkSpaces aplicaciones, sin necesidad de crear o configurar estos ajustes ellos mismos.
**Para crear variables de aplicaciones y entorno predeterminadas para los usuarios**
1. Inicie la aplicación para la que desee crear la configuración predeterminada. Por ejemplo, en una ventana de Terminal, ejecute el siguiente comando para iniciar el navegador Chromium:
**[ImageBuilderAdmin]\$1 chromium-browser**
1. Configure las opciones de la aplicación. Por ejemplo, configure la página de inicio del navegador Chromium como **https://aws.amazon.com**.
1. Asegúrese de que la aplicación Chromium esté cerrada y ejecute los siguientes comandos para copiar la configuración de Chromium a **/etc/skel**:
**[ImageBuilderAdmin]\$1 sudo mkdir /etc/skel/.config**
**[ImageBuilderAdmin]\$1 sudo cp -R \$1/.config/chromium /etc/skel/.config**
1. Defina las variables de entorno y agréguelas al archivo de script. Por ejemplo, ejecute los siguientes comandos:
**[ImageBuilderAdmin]\$1 echo "export *FOO*=*BAR*" \$1 sudo tee -a /etc/profile.d/myenvvars.sh**
**[ImageBuilderAdmin]\$1 sudo chmod \$1x /etc/profile.d/myenvvars.sh**
## Paso 5: Probar aplicaciones y configuraciones
En este paso, comprobará que las aplicaciones que ha agregado se ejecutan correctamente y que la configuración predeterminada de las aplicaciones y las variables de entorno funcionan según lo previsto.
**Para probar las aplicaciones y la configuración predeterminada en un generador de imágenes**
1. Cree un usuario de prueba que no tenga permisos raíz. Por ejemplo, en una ventana **Terminal**, ejecute los siguientes comandos para crear un **usuario-prueba** en el constructor de imágenes:
**[ImageBuilderAdmin]\$1 sudo useradd -m test-user**
**[ImageBuilderAdmin]\$1 echo -e 'Pa55w0rdas2\$1\$1\$1\$1nPa55w0rdas2\$1\$1\$1\$1n' \$1 sudo passwd test-user**
1. Cambie al usuario de prueba:
**[ImageBuilderAdmin]\$1 su - test-user**
1. Abra la aplicación (p. ej., Chromium) como usuario de prueba:
**[test-user]\$1 /usr/bin/chromium-browser**
1. Comprueba que la configuración predeterminada esté disponible para el usuario de prueba (por ejemplo, la página de inicio de Chromium es https://aws.amazon.com/).
1. Compruebe que las variables de entorno estén disponibles para el usuario de prueba. Por ejemplo, ejecute el siguiente comando:
**[test-user]\$1 echo \$1*FOO***
Este comando debería mostrar el resultado ***BAR*** en el terminal.
1. Ejecute los siguientes comandos para eliminar el usuario de prueba antes de crear una imagen desde este generador de imágenes:
**\$1 logout test user**
**[test-user]\$1 logout**
**\$1 kill test user's running processes**
**[ImageBuilderAdmin]\$1 sudo killall -u test-user**
**\$1 delete user**
**[ImageBuilderAdmin]\$1 sudo userdel -r test-user**
## Paso 6: finalización de la creación de la imagen
En este paso, elegirá un nombre de imagen y terminará de crear la imagen.
**Para crear la imagen**
1. En una ventana de **Terminal**, ejecute **AppStreamImageAssistant create-image** para crear una imagen desde su generador de imágenes. Esta imagen contiene las aplicaciones instaladas y registradas, además de los scripts de sesión y los ajustes de aplicación predeterminados que haya configurado.
Ejecute **AppStreamImageAssistant create-image --help** para ver la lista de opciones disponibles. Para obtener más información, consulte la operación **create-image** en [Cree la imagen de sus WorkSpaces aplicaciones de Amazon mediante programación mediante las operaciones CLI de Image Assistant](programmatically-create-image.md).
1. La sesión remota se desconecta al cabo de unos momentos. Cuando aparezca el mensaje **Se ha perdido la conectividad**, cierre la pestaña del navegador. Aunque la imagen se ha creado, el estado del generador de imágenes aparece como **Creando instantáneas**. No puede conectarse al generador de imágenes hasta que este proceso termine.
1. Vuelva a la consola y desplácese hasta **Imágenes**, **Registro de imágenes**. Compruebe que la nueva imagen aparezca en la lista.
Aunque la imagen se está creando, su estado en el registro de imágenes de la consola aparece como **Pendiente**. No puede conectarse a imágenes que estén en estado **Pendiente**.
1. Elija el icono **Actualizar** para actualizar el estado. Una vez creada la imagen, su estado cambia a **Disponible** y el generador de imágenes se detiene automáticamente.
Para seguir trabajando en la creación de imágenes, inicie el generador de imágenes y conéctese a él desde la consola, o bien cree un nuevo generador de imágenes.
## Paso 7 (opcional): etiquetado y copia de una imagen
Puede añadir una o varias etiquetas a una imagen al crearla o después de haberla creado. También puede copiar la imagen dentro de la misma región o en una nueva región dentro de la misma cuenta de Amazon Web Services. Al copiar una imagen de origen, se obtiene una imagen de destino idéntica pero distinta. AWS Sin embargo, no copia ninguna etiqueta definida por el usuario. Además, solo puede copiar las imágenes personalizadas que cree, no las imágenes base proporcionadas por AWS.
**nota**
Puede copiar hasta dos imágenes al mismo tiempo a un destino. Si el destino al que se va a copiar una imagen se encuentra en el límite de imagen, recibe un error. Para copiar la imagen en este caso, primero debe eliminar imágenes del destino. Una vez que el destino está por debajo de la cuota de imágenes (también denominado límite), inicie la copia de la imagen desde la región de origen. Para obtener más información, consulte [Amazon WorkSpaces Applications Service Quotas](limits.md).
**Para añadir etiquetas a una imagen existente**
1. En el panel de navegación, elija **Imágenes** e **Registro de imágenes**.
1. En la lista de imágenes, seleccione la imagen a la que desea añadir etiquetas.
1. Seleccione **Etiquetas**, **Agregar o editar etiquetas** y, a continuación, seleccione **Agregar etiqueta**. Especifique la clave y el valor de la etiqueta y, a continuación, elija **Guardar**.
Para obtener más información, consulte [Cómo etiquetar los recursos de tus WorkSpaces aplicaciones de Amazon](tagging-basic.md).
**Para copiar una imagen**
Copiar una imagen entre regiones geográficamente distribuidas le permite transmitir aplicaciones desde varias regiones basadas en la misma imagen. Al transmitir sus aplicaciones más cerca de sus usuarios, puede mejorar la experiencia de los usuarios al transmitir WorkSpaces aplicaciones con Applications.
1. En el panel de navegación, elija **Imágenes** e **Registro de imágenes**.
1. En la lista de imágenes, seleccione la imagen que desea copiar.
1. Elija **Acciones**, **Copiar**.
1. En el cuadro de diálogo **Copiar imagen**, especifique la información siguiente y, a continuación, elija **Copiar imagen:**.
+ Para **Región de destino**, elija la región en la que desea copiar la nueva imagen.
+ Para **Nombre**, especifique un nombre que tendrá la imagen cuando se copie al destino.
+ Para **Descripción** (opcional), especifique una descripción que tendrá la imagen cuando se copie al destino.
1. Para comprobar el progreso de la operación de copia, vuelva a la consola y desplácese hasta **Imágenes**, **Registro de imágenes**. Utilice la barra de navegación para cambiar a la región de destino (si procede) y confirme que su nueva imagen aparece en la lista de imágenes.
Primero, la nueva imagen aparece con el estado **Copiando** en el registro de imágenes de la consola. Una vez que la imagen se ha creado correctamente, su estado cambia a **Disponible**, lo que significa que ya puede utilizarla para lanzar una pila y transmitir en streaming las aplicaciones.
## Paso 8: eliminación
Por último, puede detener los generadores de imágenes en ejecución para liberar recursos y evitar cargos no deseados en su cuenta. Recomendamos detener todos los generadores de imágenes en ejecución que no se utilicen. Para obtener más información, consulte los [precios de WorkSpaces las aplicaciones](https://aws.amazon.com/appstream2/pricing/).
**Para detener un generador de imágenes en ejecución**
1. En el panel de navegación, elija **Imágenes**, **Generadores de imágenes** y seleccione la instancia del generador de imágenes en ejecución.
1. Elija **Acciones**, **Detener**.
# Tutorial: habilitación de la compatibilidad con el japonés para las imágenes de Linux
En este tutorial se describe cómo habilitar la compatibilidad con el japonés para una imagen de Linux. Esto permite que las aplicaciones de la imagen muestren caracteres japoneses y que los usuarios de streaming puedan utilizar el método de entrada en japonés en las sesiones de streaming cuando utilicen este tipo de imagen.
**Topics**
+ [Paso 1: instalación de la fuente y el método de entrada japoneses](#tutorial-japanese-font)
+ [Paso 2: establecimiento de la zona horaria del sistema](#tutorial-japanese-zone)
+ [Paso 3: establecimiento de la configuración regional del sistema y el idioma de visualización](#tutorial-japanese-locale)
+ [Paso 4: configuración de los métodos de entrada](#tutorial-japanese-input)
+ [Paso 5: establecimiento de la distribución del teclado](#tutorial-japense-keyboard)
+ [Paso 6: verificación en el generador de imágenes](#tutorial-japense-verify)
+ [Paso 7: creación de la imagen](#tutorial-japanese-create)
## Paso 1: instalación de la fuente y el método de entrada japoneses
En este paso, conectará un generador de imágenes de Linux e instalará los paquetes de fuentes y métodos de entrada que prefiera.
**Para instalar la fuente y el método de entrada japoneses**
1. Inicie sesión en el generador de imágenes mediante uno de los siguientes métodos:
+ [Utilice la consola de WorkSpaces aplicaciones](managing-image-builders-connect-console.md) (solo para conexiones web)
+ [Cree una URL de transmisión](managing-image-builders-connect-streaming-URL.md) (para conexiones de clientes web o de WorkSpaces aplicaciones)
**nota**
Iniciará sesión como ImageBuilderAdmin usuario en el escritorio GNOME de Amazon Linux y tendrá privilegios de administrador root.
1. Instale la fuente y el método de entrada que necesite. Para ello, abra la aplicación del Terminal y ejecute los siguientes comandos:
**sudo yum install vlgothic-p-fonts.noarch**
**sudo yum install ibus-kkc.x86\$164**
1. Además de los comandos anteriores, para Rocky Linux y Red Hat Enterprise Linux, ejecute el siguiente comando:
**sudo yum install glibc-langpack-ja**
## Paso 2: establecimiento de la zona horaria del sistema
Para establecer la zona horaria del sistema, ejecute el siguiente comando:
**sudo timedatectl set-timezone "Asia/Tokyo"**
## Paso 3: establecimiento de la configuración regional del sistema y el idioma de visualización
Para establecer la configuración regional del sistema y el idioma de visualización, ejecute los siguientes comandos.
**Para establecer la configuración regional y el idioma de visualización**
1. Actualice el archivo `cloud-init config` ejecutando el comando **sudo vim /etc/cloud/cloud.cfg** y cambie la **configuración regional** a la **configuración regional: ja\$1JP.UTF8** y, a continuación, guarde y cierre el archivo.
1. Actualice la configuración del sistema ejecutando **sudo localectl set-locale LANG=ja\$1JP.utf8**.
1. Actualice la configuración del intérprete de comandos de Gnome ejecutando **sudo gsettings set org.gnome.system.locale region "ja\$1JP.utf8"**.
## Paso 4: configuración de los métodos de entrada
Configure los métodos de entrada para la aplicación que desee añadir a la imagen. Para obtener más información sobre cómo instalar una aplicación, generar un archivo de manifiesto y crear la configuración predeterminada, consulte [Tutorial: Crear una imagen personalizada de aplicaciones basadas en Linux WorkSpaces](tutorial-create-linux-image.md). En este paso, suponemos que ya ha instalado la aplicación Firefox, que se encuentra en `/usr/local/firefox/firefox`.
**Para configurar los métodos de entrada**
1. Cree un script ejecutando el comando **sudo vim /usr/local/bin/update-input-method.sh** y añada el siguiente contenido al script:
```
#!/bin/bash
function start_process()
{
command=$1
process_name=$2
process_count=$(pgrep $process_name -c)
echo "$(date) current $process_name count: $process_count"
while [ $process_count -lt 1 ]
do
echo "$(date) starting $process_name"
eval $command
sleep 1
process_count=$(pgrep $process_name -c)
done
echo "$(date) $process_name started"
}
start_process "ibus-daemon --xim &" "ibus-daemon"
start_process "/usr/libexec/ibus-engine-kkc --ibus &" "ibus-engine-kkc"
gsettings set org.gnome.desktop.input-sources sources "[('ibus','kkc'), ('xkb', 'us')]"
gsettings set org.gnome.desktop.wm.keybindings switch-input-source "['space']"
gsettings set org.gnome.desktop.wm.keybindings switch-input-source-backward "['space']"
echo "$(date) updated input source and switch shortcut"
```
En el script anterior, la primera fuente de entrada (“ibus”, “kkc”) es el método de entrada predeterminado. Puede cambiar el método de entrada predeterminado modificando el orden de las fuentes de entrada. Además, “Control\$1Espacio” y “Mayús\$1Control\$1Espacio” están especificados como combinaciones de teclas de acceso directo para cambiar entre los métodos de entrada. Puede especificar sus propias combinaciones de teclas que podrán utilizar los usuarios para cambiar los métodos de entrada durante las sesiones de streaming.
1. Cree el script para iniciar la aplicación (Firefox) que añadirá a la imagen. Para ello, ejecute el comando y**sudo vim /usr/local/bin/firefox-jp.sh**, a continuación, añada el siguiente contenido al script:
```
#!/bin/bash
# Gather required environment variables from the GNOME shell session
while IFS= read -r -d $'\0' env_var; do
case "$env_var" in
DBUS_SESSION_BUS_ADDRESS=*|\
GTK_IM_MODULE=*|\
QT_IM_MODULE=*|\
XMODIFIERS=*|\
XAUTHORITY=*)
echo "$env_var"
export "$env_var"
;;
esac
done < "/proc/$(pgrep -u as2-streaming-user gnome-shell | head -n1)/environ"
/usr/local/bin/update-input-method.sh > /var/tmp/update-input-method.log 2>&1 &
/usr/local/firefox/firefox &
```
1. Añada el permiso de ejecución a ambos scripts ejecutando los siguientes comandos:
**sudo chmod \$1x /usr/local/bin/update-input-method.sh**
**sudo chmod \$1x /usr/local/bin/firefox-jp.sh**
1. Si ya ha creado el archivo de manifiesto de optimización para la aplicación, ejecute los siguientes comandos para añadir el script de inicio de la aplicación al catálogo de aplicaciones:
```
sudo AppStreamImageAssistant add-application \
--name firefox \
--absolute-app-path /usr/local/bin/firefox-jp.sh \
--display-name firefox \
--absolute-icon-path /usr/local/firefox/browser/chrome/icons/default/default128.png \
--absolute-manifest-path /tmp/firefox-manifest.txt
```
Como alternativa, también puede configurar los métodos de entrada añadiendo el script update-input-method .sh como una aplicación independiente al catálogo de aplicaciones de la imagen. Durante las sesiones de streaming, los usuarios pueden iniciar esta aplicación para habilitar la entrada en japonés y cambiar entre los métodos de entrada con atajos de teclado específicos dentro de la misma sesión.
## Paso 5: establecimiento de la distribución del teclado
Puede configurar la distribución del teclado para que coincida con los teclados que utilizarán sus usuarios durante las sesiones de streaming. Puede usar el comando **localectl list-keymaps** para enumerar todos los mapas de teclas disponibles y usar el comando **sudo localectl set-keymap jp106** para configurar el mapa de teclas para el teclado japonés de 106 teclas, por ejemplo.
## Paso 6: verificación en el generador de imágenes
Para verificar el funcionamiento del generador de imágenes, reinicie en primer lugar el generador de imágenes ejecutando el comando **sudo shutdown -r now**. Tras reiniciarlo, vuelva a conectarse al generador de imágenes y compruebe que todo funcione según lo previsto, incluida la zona horaria, la configuración regional, el idioma y el método de entrada.
## Paso 7: creación de la imagen
Cree la imagen en el generador de imágenes. Para obtener más información, consulte [Tutorial: Crear una imagen personalizada de aplicaciones basadas en Linux WorkSpaces](tutorial-create-linux-image.md). Asegúrese de crear la configuración predeterminada de la aplicación, incluida la configuración regional que acaba de configurar. Para obtener más información, consulte “Creación de la configuración predeterminada de las aplicaciones para los usuarios” en [Creación de imágenes basadas en Linux](create-linux-based-images.md).
Todas las instancias de la flota de Linux creadas a partir de esta imagen tendrán los mismos ajustes predeterminados de zona horaria, configuración regional, idioma y método de entrada que haya configurado para la imagen.
# Usa scripts de sesión para gestionar la experiencia de streaming de tus usuarios de Amazon WorkSpaces Applications
WorkSpaces Las aplicaciones proporcionan 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 aplicaciones antes de que comiencen las sesiones de streaming de los 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 imagen de WorkSpaces aplicaciones. 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.md)
+ [Ejecución de scripts después de finalizar las sesiones de streaming](run-scripts-after-streaming-sessions-end.md)
+ [Creación y especificación de scripts de sesión](create-specify-session-scripts.md)
+ [Archivo de configuración de scripts de sesión](session-script-configuration-file.md)
+ [Uso de PowerShell archivos de Windows](using-powershell-files-with-session-scripts.md)
+ [Registro de la salida de los scripts de sesión](logging-session-output.md)
+ [Uso de conectores de almacenamiento con scripts de sesión](use-storage-connectors-with-session-scripts.md)
+ [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.md)
+ [Uso de scripts de sesión en flotas multisesión](session-scripts-multi-session-fleets.md)
# 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 las WorkSpaces aplicaciones 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:\$1\$1Scripts\$1\$1Myscript.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 Applications muestra el mensaje de error al usuario.
Cuando ejecuta los scripts antes de que comiencen las sesiones de streaming y el marco de WorkSpaces aplicaciones dinámicas de aplicaciones no esté habilitado, se produce el siguiente proceso:
![\[WorkSpaces Applications workflow diagram showing connection, application selection, and session launch steps.\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/images/session-scripts-without-DAF-non-domain-joined2.png)
1. Los usuarios se conectan a una instancia de la flota de WorkSpaces aplicaciones que no está unida a un dominio. Se conectan mediante uno de los siguientes métodos de acceso:
+ WorkSpaces Grupo de usuarios de aplicaciones
+ SAML 2.0
+ WorkSpaces API de aplicaciones
1. El catálogo de aplicaciones se muestra en el portal de WorkSpaces aplicaciones y los usuarios eligen una aplicación para lanzarla.
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 aplicaciones](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 [Habilite y administre el almacenamiento persistente para los usuarios de sus WorkSpaces aplicaciones](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 de conectores de almacenamiento con scripts de sesión](use-storage-connectors-with-session-scripts.md).
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.
1. Se lanza la aplicación que los usuarios han elegido.
Para obtener información sobre el marco de WorkSpaces aplicaciones dinámicas de aplicaciones, consulte[Utilice el marco de WorkSpaces aplicaciones dinámicas para crear un proveedor de aplicaciones dinámicas](build-dynamic-app-provider.md).
Al ejecutar scripts antes de que comiencen las sesiones de streaming y se WorkSpaces active el marco de aplicaciones dinámicas de aplicaciones, se produce el siguiente proceso:
![\[WorkSpaces Applications workflow from user login to application launch, including SAML authentication and session scripts.\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/images/session-scripts-with-DAF-domain-joined2.png)
1. Los usuarios visitan el portal de aplicaciones SAML 2.0 de su organización y eligen la pila de WorkSpaces aplicaciones.
1. Se conectan a una instancia de la flota de WorkSpaces aplicaciones que está unida a un dominio.
1. Si está habilitada la persistencia de la configuración de las aplicaciones para los usuarios, se descarga y monta 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.
1. Se produce el inicio de sesión del usuario de Windows.
1. El catálogo de aplicaciones se muestra en el portal de WorkSpaces aplicaciones y los usuarios eligen una aplicación para lanzarla.
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.
**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 de conectores de almacenamiento con scripts de sesión](use-storage-connectors-with-session-scripts.md).
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.
1. Se lanza la aplicación que los usuarios han elegido.
# 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 de WorkSpaces aplicaciones o cuando alcancen la duración máxima permitida para la sesión. También puede utilizar estos scripts de sesión para limpiar el entorno de WorkSpaces aplicaciones antes de que finalice 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:
![\[Flowchart showing WorkSpaces Applications session termination process with scripts and storage actions.\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/images/session-scripts-termination.png)
1. Finaliza la sesión de streaming de WorkSpaces las aplicaciones de sus 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. La instancia de la flota termina.
# Creación y especificación de scripts de sesión
Puede configurar y especificar los scripts de sesión para las flotas siempre activas, bajo demanda y de Elastic.
**Para configurar y especificar los scripts de sesión para las flotas siempre activas y bajo demanda**
1. Abra la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)
1. En el panel de navegación, elija **Imágenes**, **Image Builder**.
1. Elija un generador de imágenes cuyo estado sea **En ejecución** y seleccione **Conectar**.
1. Cuando se lo pidan, seleccione **Administrador**.
1. Navegue hasta `C:\AppStream\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.md).
1. Una vez que haya terminado de realizar cambios, guarde y cierre el archivo `config.json`.
1. En el escritorio del generador de imágenes, abra **Image Assistant**.
1. (Opcional) Puede especificar cualquier otra aplicación que quiera incluir en la imagen.
1. Siga los pasos necesarios en Image Assistant para terminar de crear la imagen.
Si la configuración de scripts de sesión no se puede validar (por ejemplo, porque el archivo .json no tiene el formato correcto), se le notificará cuando elija **Desconectar y crear imagen**.
**nota**
Para localizar el archivo de configuración de los scripts de sesión en generadores de imágenes basados en Linux, vaya a `/opt/appstream/SessionScripts/config.json`.
**Para configurar y especificar los scripts de sesión para las flotas de Elastic**
1. Cree un archivo zip con los scripts de sesión y el archivo config.json. Los archivos de scripts se copiarán en las siguientes ubicaciones. Debe usar estas ubicaciones para su config.json.
+ Para Windows, use `C:\AppStream\SessionScripts\SessionScript`.
+ Para Linux, use `/opt/appstream/SessionScripts/SessionScript`.
**nota**
Para ejecutar los archivos de scripts de sesión, asegúrese de que el archivo.zip solo contenga los scripts y archivos `config.json` de la sesión y no la carpeta que los contiene. Para obtener más información, consulte [Archivo de configuración de scripts de sesión](session-script-configuration-file.md).
1. Cargue el archivo zip en un bucket de Amazon S3 de su cuenta.
**nota**
Su VPC debe proporcionar acceso al bucket de Amazon S3. Para obtener más información, consulte [Uso de puntos de enlace de VPC de Amazon S3 para las características de las aplicaciones WorkSpaces](managing-network-vpce-iam-policy.md).
Debe tener el bucket de S3 y la flota de WorkSpaces aplicaciones en la misma unidad. Región de AWS
Debe tener permisos de IAM para realizar la acción `S3:GetObject` en el objeto del script de la sesión en el bucket de Amazon S3. Para obtener más información sobre cómo almacenar los scripts de sesión en un bucket de Amazon S3, consulte [Guardar el icono de la aplicación, el script de configuración, el script de sesión y el VHD en un bucket de S3](store-s3-bucket.md).
1. Abra la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)
1. En el panel de navegación, seleccione **Flotas**.
1. Elija la flota de Elastic que quiera actualizar y, a continuación, seleccione **Ver detalles**.
1. En la pestaña **Configuración de scripts de sesión**, elija **Editar**.
1. Para **Objeto de script de sesión en S3**, especifique el URI de S3 que representa el objeto de script de sesión o elija **Explorar S3** para ir a los buckets de S3 y buscar el objeto de script de sesión.
1. Cuando termine de realizar los cambios, seleccione **Guardar cambios**.
1. En este momento, los scripts de sesión están disponibles para todas las instancias de flota lanzadas.
**nota**
También puede configurar los scripts de sesión al crear una nueva flota de Elastic.
# 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:\$1\$1AppStream\$1 SessionScripts config.json. En una instancia de Linux, navegue hasta/opt/appstream/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 puedes usar PowerShell archivos de Windows. Para obtener más información, consulte [Uso de PowerShell archivos de Windows](using-powershell-files-with-session-scripts.md).
***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 Applications 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 de conectores de almacenamiento con scripts de sesión
Cuando los conectores de almacenamiento de WorkSpaces aplicaciones están habilitados, comienzan a montarse cuando se ejecutan los scripts de inicio de sesión. Si el script se basa en el montaje de los conectores de almacenamiento, puede esperar a que estén disponibles. WorkSpaces Las aplicaciones mantienen el estado de montaje de los conectores de almacenamiento del registro de Windows en las instancias de Windows, en la clave siguiente:
HKEY\$1LOCAL\$1MACHINE\$1 SOFTWARE\$1 Amazon\$1\$1 Storage\$1\$1 AppStream
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
+ GoogleDrive
+ OneDrive
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 |
En las instancias de Linux, puede comprobar el estado de montaje de la carpeta principal consultando el valor de appstream\$1home\$1folder\$1mount\$1status en el archivo \$1/. config/appstream-home-folder/appstream-. home-folder-mount-status
| Valor | Description (Descripción) |
| --- | --- |
| True | La carpeta principal se ha montado correctamente |
| False | La carpeta principal aún no está montada |
# 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 Applications 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 Applications 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 servicio de WorkSpaces Aplicaciones las 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:
```
appstream-logs-region-code-account-id-without-hyphens-random-identifier
```
***region-code***
Este es el código de AWS región en el que se crea la pila con el almacenamiento en cubos de Amazon S3 habilitado para los registros de scripts de sesión.
***account-id-without-hyphens***
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, `appstream-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) con el número de cuenta 123456789012, WorkSpaces Applications 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.
```
appstream-logs-us-west-2-1234567890123-abcdefg
```
Al desactivar scripts de sesión no se eliminan 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 Applications añade una política de bucket que evita la eliminación accidental del bucket. Para obtener más información, consulte la sección *Políticas de IAM y el bucket de Amazon S3 para la persistencia de la configuración de aplicaciones* en [Identity and Access Management para WorkSpaces aplicaciones de Amazon](controlling-access.md).
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:
```
bucket-name/stack-name/fleet-name/access-mode/user-id-SHA-256-hash/session-id/SessionScriptsLogs/session-event
```
***bucket-name***
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.
***stack-name***
El nombre de la pila de la que procede la sesión.
***fleet-name***
El nombre de la flota en la que se ejecuta el script de sesión.
***access-mode***
El método de identidad del usuario: `custom` para la API o CLI de WorkSpaces aplicaciones, `federated` para SAML y `userpool` para los usuarios del grupo de usuarios.
***user-id-SHA-256-hash***
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.
***session-id***
El identificador de la sesión de streaming del usuario. Cada sesión de streaming del usuario genera un identificador único.
***session-event***
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 `test-stack` de configuración de la región EE.UU. Oeste (Oregón) (us-west-2):
```
appstream-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.
# Uso de scripts de sesión en flotas multisesión
Al utilizar scripts de sesión en flotas multisesión, existen requisitos y consideraciones adicionales para garantizar un rendimiento y una seguridad óptimos.
## Requisitos
En una flota de sesión única, en un caso concreto, se garantiza que los **SessionTermination**ganchos **SessionStart**y se ejecutarán solo una vez. Esto se debe a que hay una asignación 1:1 de sesiones a instancias. Cuando se utilizan flotas multisesión, existe un mapeo N:M de las sesiones a las instancias, en el que cada sesión ejecuta su propio enlace. **SessionStart**SessionTermination**** Esto significa que los **SessionTermination**enlaces **SessionStart**y se pueden ejecutar muchas veces en una instancia determinada y en muchos órdenes diferentes. Para disfrutar de una experiencia óptima, deberían cumplirse las siguientes condiciones para los scripts de sesión si se utilizan en flotas multisesión:
+ Los scripts son idempotentes.
Cuando ya se ha realizado una acción, los scripts deben tratar más de una ejecución en la misma instancia con un manejo correcto.
+ Los scripts son independientes.
Como los scripts se ejecutan por sesión, si una sesión se ejecuta **SessionTermination**mientras se ejecuta otra **SessionStart**, no deberían interferir entre sí ni con la experiencia de otras sesiones.
+ Los scripts son eficaces.
En las instancias multisesión, se pueden aprovisionar varias sesiones simultáneamente. Esto significa que puede haber varias ejecuciones simultáneas de los scripts de sesión. Los scripts deben ser eficientes, no consumir recursos excesivos y no afectar a la experiencia de otros usuarios en la instancia ni a la estabilidad de las sesiones.
Muchos de estos requisitos se pueden cumplir manteniendo la lógica del script de sesión centrada en la sesión de usuario específica en la que se ejecuta el script.
## Consideraciones de seguridad
WorkSpaces Las imágenes de las aplicaciones no deben configurarse para permitir a ningún usuario permiso de escritura en los archivos de secuencias de comandos de la sesión. Esto introduce un vector de ataque crítico para los usuarios malintencionados, pues se les permite modificar los archivos de script. Estos archivos podrían ejecutarse entonces como SYSTEM o como otro usuario, dependiendo de la configuración.
**importante**
Es su responsabilidad asegurarse de que las imágenes de sus WorkSpaces aplicaciones estén configuradas de forma segura. Esto es especialmente importante en el caso de las instancias multisesión en las que varios usuarios utilizan la misma instancia. Si las imágenes no se configuran de forma segura, todos los usuarios de esa instancia corren un riesgo de seguridad.
Los archivos de imágenes y scripts de sesión deben cumplir las condiciones siguientes:
+ Los usuarios no tienen permiso para modificar los archivos de script de sesión.
+ Los usuarios no tienen permiso para modificar el script de sesión config.json. El comportamiento predeterminado de la imagen restringe el acceso a los administradores.
Los archivos ejecutables de script de sesión deben almacenarse en un lugar seguro donde no se puedan modificar durante el tiempo de ejecución.
Si el servicio detecta que se ha modificado un archivo ejecutable de script de sesión, no ejecutará posteriormente ese enlace en esa instancia, cargará los archivos de registro en Amazon S3 (si el registro en Amazon S3 está habilitado) y se verá el siguiente mensaje:
**El script de sesión no se ejecutó porque el archivo ejecutable se modificó después de aprovisionarse la instancia. Se ha omitido la ejecución por motivos de seguridad.**
Si su caso de uso requiere modificar el archivo ejecutable del script de sesión en el tiempo de ejecución (por ejemplo, si selecciona un archivo EXE modificado mediante un proceso de actualización automática en el tiempo de ejecución), no superará las comprobaciones anteriores. En este caso, utilice un script para redirigir la ejecución al archivo ejecutable modificado. Deje el script sin modificar en el tiempo de ejecución cuando el servicio realice el control de seguridad.
Si los archivos de script de sesión son excesivamente grandes (más de 100 MB), esto puede ocasionar retrasos en el aprovisionamiento de instancias y sesiones, y el control de seguridad tardará más tiempo (dependiendo del tipo de instancia y de los recursos disponibles). Si su caso de uso requiere scripts de sesión de gran tamaño, considere la posibilidad de utilizar scripts más pequeños para redirigir la ejecución. Esto mejorará las experiencias de aprovisionamiento de instancias y sesiones.
Tenga en cuenta que el servicio solo comprueba el ejecutable definido en los scripts de sesión config.json, y esto es solo un mecanismo de fallback/best esfuerzo. Es su responsabilidad asegurarse de que todas las rutas de código de los archivos ejecutables de scripts de sesión sean seguras y que los usuarios finales no puedan modificarlas.