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.

# Configurar instancias PowerShell de Windows Lightsail con scripts por lotes
<a name="create-powershell-script-that-runs-when-you-create-windows-based-instance-in-lightsail"></a>

Al crear una instancia basada en Windows, puede configurarla mediante un script de Windows o cualquier otro PowerShell script por lotes. Se trata de un script que se ejecuta una vez justo después de que se lanza la instancia. En este tema se muestra la sintaxis de los scripts y se proporciona un ejemplo para que pueda comenzar. También mostraremos cómo probar su script para ver si se ejecutó correctamente.

## Cree una instancia que lance y ejecute un script PowerShell
<a name="windows-powershell-create-instance"></a>

El siguiente procedimiento instala una herramienta llamada *chocolatey* en una instancia nueva, justo después de que se lanza la instancia.

1. En el panel de navegación izquierdo, elija **Crear instancia**.

1. Elija la zona de disponibilidad Región de AWS y la zona de disponibilidad en las que desee crear la instancia.

1. En **Seleccione una plataforma**, elija **Microsoft Windows**.

1. Seleccione **Solo SO** y luego elija entre **Windows Server 2022**, **Windows Server 2019** y **Windows Server 2016**.

1. Elija **Añadir script de lanzamiento**.

1. Escriba lo siguiente:

   ```
   <powershell>
   iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
   </powershell>
   ```
**nota**  
Siempre debes incluir tus PowerShell scripts en `<powershell></powershell>` etiquetas. Puede introducir scripts por lotes o que no sean PowerShell comandos utilizando `<script></script>` etiquetas o sin ninguna etiqueta.

1. Ingrese un nombre para la instancia.

   Nombres de recursos:
   + Debe ser único Región de AWS en cada uno de los componentes de su cuenta de Lightsail.
   + Debe contener de 2 a 255 caracteres.
   + Debe comenzar y terminar con un carácter alfanumérico o un número.
   + Puede incluir caracteres alfanuméricos, números, puntos, guiones y guiones bajos.

1. (Opcional) Seleccione **Agregar nueva etiqueta** para agregar una etiqueta a la instancia. Repita este paso según sea necesario para agregar etiquetas adicionales. Para obtener más información sobre el uso de etiquetas, consulte [Etiquetas](amazon-lightsail-tags.md).

   1. En **Clave**, introduzca la clave de la etiqueta.  
![Una etiqueta con solo la clave de etiqueta especificada en el flujo de trabajo de creación de instancias de Lightsail.](http://docs.aws.amazon.com/es_es/lightsail/latest/userguide/images/amazon-lightsail-instance-key-name-only-tags.png)

   1. (Opcional) En **Valor**, introduzca el valor de la etiqueta.  
![Una etiqueta con la clave y el valor de etiqueta especificados en el flujo de trabajo de creación de instancias de Lightsail.](http://docs.aws.amazon.com/es_es/lightsail/latest/userguide/images/amazon-lightsail-instance-key-name-and-value-tags.png)

1. Elija **Crear instancia**.

## Compruebe que el script se ha ejecutado correctamente
<a name="windows-powershell-verify-script-ran-successfully"></a>

Puede iniciar sesión en la instancia para verificar que el script se ha ejecutado correctamente. Una instancia basada en Windows puede tardar hasta 15 minutos en aceptar conexiones RDP. Una vez que esté listo, inicie sesión con el cliente de RDP basado en navegador o configure su propio cliente de RDP. Para obtener más información, consulte [Conectarse a la instancia basada en Windows](connect-to-your-windows-based-instance-using-amazon-lightsail.md).

1. Cuando pueda conectarse a su instancia de Lightsail, abra una línea de comandos (o abra el Explorador de Windows).

1. Cambie al directorio `Log` escribiendo lo siguiente:

   ```
   cd C:\ProgramData\Amazon\EC2-Windows\Launch\Log
   ```

1. Abra `UserdataExecution.log` en un editor de texto o escriba lo siguiente: `type UserdataExecution.log`.

   Debería ver lo siguiente en el archivo de log.

   ```
   2017/10/11 20:32:12Z: <powershell> tag was provided.. running powershell content
   2017/10/11 20:32:13Z: Message: The output from user scripts: iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
   
   2017/10/11 20:32:13Z: Userdata execution done
   ```