As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configurar instâncias PowerShell do Windows Lightsail com scripts em lote
<a name="create-powershell-script-that-runs-when-you-create-windows-based-instance-in-lightsail"></a>

Ao criar uma instância baseada no Windows, você pode configurá-la usando um PowerShell script do Windows ou qualquer outro script em lote. Esse é um script único que é executado logo após o início da sua instância. Este tópico mostra a sintaxe dos scripts e fornece um exemplo para você começar. Também mostramos como testar o script para ver se ele foi executado com êxito.

## Crie uma instância que inicie e execute um PowerShell script
<a name="windows-powershell-create-instance"></a>

O procedimento a seguir instala uma ferramenta denominada *chocolatey* em uma nova instância, logo após o início da instância.

1. No painel de navegação esquerdo, escolha **Criar instância**.

1. Escolha a zona Região da AWS de disponibilidade em que você deseja criar sua instância.

1. Em **Selecionar uma plataforma**, escolha **Microsoft Windows**.

1. Escolha **Somente SO** e, depois, **Windows Server 2022**, **Windows Server 2019** ou **Windows Server 2016**.

1. Selecione **Adicionar script de execução**.

1. Digite o seguinte:

   ```
   <powershell>
   iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
   </powershell>
   ```
**nota**  
Você deve sempre agrupar seus PowerShell scripts em `<powershell></powershell>` tags. Você pode inserir scripts que não sejam PowerShell comandos ou em lote usando `<script></script>` tags ou sem nenhuma tag.

1. Digite um nome para sua instância.

   Nomes de recurso:
   + Deve ser exclusivo Região da AWS em cada um em sua conta do Lightsail.
   + Deve conter de 2 a 255 caracteres.
   + Deve começar e terminar com um caractere alfanumérico ou com um número.
   + Pode conter caracteres alfanuméricos, números, pontos, traços e sublinhados.

1. (Opcional) Selecione **Adicionar nova tag** para adicionar uma tag à sua instância. Repita esta etapa quando necessário para adicionar mais tags. Para saber mais sobre a utilização de tags, consulte [Tags](amazon-lightsail-tags.md).

   1. Em **Chave**, insira a chave da tag.  
![Uma tag com somente a chave de tag especificada no fluxo de trabalho de criação de instâncias do Lightsail.](http://docs.aws.amazon.com/pt_br/lightsail/latest/userguide/images/amazon-lightsail-instance-key-name-only-tags.png)

   1. (Opcional) Em **Valor**, digite um valor para a tag.  
![Uma tag com a chave e o valor da tag especificados no fluxo de trabalho de criação de instâncias do Lightsail.](http://docs.aws.amazon.com/pt_br/lightsail/latest/userguide/images/amazon-lightsail-instance-key-name-and-value-tags.png)

1. Selecione **Criar instância**.

## Verificar se o script foi executado com êxito
<a name="windows-powershell-verify-script-ran-successfully"></a>

Você pode fazer login em sua instância para verificar se o script foi executado com êxito. Pode demorar até 15 minutos para uma instância baseada no Windows ficar pronta para aceitar conexões RDP. Quando ela estiver pronta, faça login usando o cliente RDP baseado em navegador ou configure seu próprio cliente RDP. Para obter mais informações, acesse [Conectar-se a sua instância baseada no Windows](connect-to-your-windows-based-instance-using-amazon-lightsail.md).

1. Depois de se conectar à sua instância do Lightsail, abra um prompt de comando (ou abra o Windows Explorer).

1. Altere para o diretório `Log` digitando:

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

1. Abra `UserdataExecution.log` em um editor de texto ou digite: `type UserdataExecution.log`.

   Você deve ver a página a seguir no arquivo de registro.

   ```
   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
   ```