

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.

# Cree el script de configuración para el VHD en Amazon Applications WorkSpaces
<a name="create-setup-script"></a>

WorkSpaces Las aplicaciones utilizan un script de configuración que usted proporciona para montar el VHD antes de que se inicie la aplicación. También puede usar el script de configuración para completar otras tareas necesarias para que la aplicación funcione. Por ejemplo, puede configurar las claves de registro, registrar DLLs, gestionar los requisitos previos o modificar el perfil de usuario desde el script de configuración. WorkSpaces Applications proporciona ejemplos de scripts que puede utilizar para montar su VHD. Deberá modificar estos scripts para adaptarlos a las necesidades de sus aplicaciones y su VHD.

**nota**  
Los scripts de configuración no son necesarios para los bloques de WorkSpaces aplicaciones con el paquete Applications. Sin embargo, puede proporcionar scripts opcionales posteriores a la configuración para personalizar la instalación de la aplicación.

Utilice los siguientes enlaces para descargar los scripts de ejemplo:
+ [Ubuntu Pro 24.04 LTS y script bash de Amazon Linux 2](samples/Linux-mount-vhd-script2.zip)
+ [Script de Microsoft Windows Powershell](samples/Windows-mount-vhd-script3.zip)
**nota**  
WorkSpaces Las aplicaciones y el sistema operativo Microsoft Windows reservan las letras de unidad A a E. No monte VHDs ni utilice recursos compartidos de red en estas letras de unidad.

WorkSpaces Las aplicaciones descargan el script de configuración y el VHD a un directorio de la instancia de streaming de fleet y, a continuación, ejecutan el script de configuración. El script de configuración se ejecuta en el sistema operativo con todos los derechos de administrador. El script de configuración se ejecuta en el `SYSTEM` contexto de Microsoft Windows y como `root` usuario en Amazon Linux 2 o Ubuntu Pro 24.04 LTS.

Ubicación del sistema de archivos para el VHD y el script de configuración:
+ Ubuntu Pro 24.04 LTS: 

  `/opt/appstream/AppBlocks/appblock-name/`  
**`appblock-name` **  
El nombre del bloque de aplicaciones al que corresponden el VHD y el script de configuración.
+ Amazon Linux 2: 

  `/opt/appstream/AppBlocks/appblock-name/`  
**`appblock-name` **  
El nombre del bloque de aplicaciones al que corresponden el VHD y el script de configuración.
+ Microsoft Windows:

  `C:\AppStream\AppBlocks\appblock-name\`  
**`appblock-name` **  
El nombre del bloque de aplicaciones al que corresponden el VHD y el script de configuración.

WorkSpaces Las aplicaciones mantienen el nombre del archivo tal como están en el objeto. Por ejemplo, si el bloque de aplicaciones se llama `MyApps`, con un VHD denominado `apps.vhd` y un script de configuración denominado `mount-apps.ps1`, la ruta completa de una instancia de streaming de Windows es:
+ VHD

  `C:\AppStream\AppBlocks\MyApps\apps.vhd`
+ Script de configuración

  `C:\AppStream\AppBlocks\MyApps\mount-apps.ps1`

WorkSpaces Applications captura el error estándar y el resultado estándar del script de configuración cuando se ejecuta en una instancia de streaming de flota y carga el resultado en un bucket de Amazon S3 de su cuenta. Puede usar estos registros para identificar y resolver los problemas que pueda tener con su script de configuración. 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 flota elástica.

**`account-id-without-hyphens` **  
El identificador AWS de su cuenta. 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 crea una flota elástica en 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 en 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
```

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/fleet-name/instance-id/appblock-name/
```

**`bucket-name` **  
El nombre del bucket de Amazon S3 en el que se almacenan los registros del script de sesión. El formato del nombre se describe anteriormente en esta sección.

**`Instance-id` **  
El identificador único de la instancia de streaming en la que se ejecutó el script de configuración.

**`appblock-name` **  
El nombre del appblock al que corresponde el script de configuración. 

La siguiente estructura de carpetas de ejemplo se aplica a una sesión de streaming que se inicia desde `test-fleet`. La sesión tiene un Cuenta de AWS identificador 123456789012 y el nombre de appblock es testappblock en la región EE.UU. Oeste (Oregón) (us-west-2):

`appstream-logs-us-west-2-1234567890123-abcdefg/test-fleet/i-084427ab4a1cff7f5/testappblock/`

La estructura de carpetas de este ejemplo contiene un archivo de registro para el resultado estándar y un archivo de registro para el error estándar.

**Topics**
+ [Ejecución del script de configuración de bloques de aplicaciones en Amazon WorkSpaces Applications](script-execution.md)

# Ejecución del script de configuración de bloques de aplicaciones en Amazon WorkSpaces Applications
<a name="script-execution"></a>

Los siguientes diagramas indican en qué parte del proceso se ejecuta el script de configuración. El orden de ejecución depende de si está habilitada la persistencia de configuración de la aplicación en la pila asociada a la flota elástica.

**nota**  
WorkSpaces Applications utiliza los detalles de su VPC para descargar el VHD y el script de configuración del bucket de Amazon S3. 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).

Persistencia de configuración de la aplicación habilitada:

![\[La persistencia de configuración de la aplicación está habilitada.\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/images/app-settings-enabled.png)


Persistencia de configuración de la aplicación deshabilitada:

![\[La persistencia de configuración de la aplicación está deshabilitada.\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/images/app-settings-disabled.png)
