# Usar o agente do EC2Launch v1 para realizar tarefas durante a execução da instância EC2 Windows
As AMIs gerenciadas pela Amazon para o Windows Server 2016 e 2019 incluem um conjunto de scripts do Windows PowerShell chamados EC2Launch. O EC2Launch executa tarefas durante a inicialização inicial da instância. Para obter informações sobre as versões do EC2Launch incluídas nas AMIs da AWS para o Windows, consulte [AWS Windows AMI Reference](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/windows-amis.html).
**nota**
O agente de inicialização mais recente para o Windows Server 2016 e versões posteriores do sistema operacional é o EC2Launch v2, que substitui tanto o EC2Config quanto o EC2Launch, e está pré-instalado nas AMIs da AWS para o Windows Server 2016 e 2019 com nomes que começam com `EC2LaunchV2-Windows_Server-*`. Você também instalar manualmente e configurar o agente no Windows Server 2016 e 2019. Para obter mais informações, consulte [Instalar o EC2Launch v2](ec2launch-v2-install.md).
Para usar o EC2Launch com IMDSv2, a versão deve ser a 1.3.2002730 ou posterior.
É possível usar o comando do Windows PowerShell a seguir para verificar a versão instalada do EC2Launch.
```
Test-ModuleManifest -Path "C:\ProgramData\Amazon\EC2-Windows\Launch\Module\Ec2Launch.psd1" | Select Version
```
## Tarefas do EC2Launch
Por padrão, o EC2Launch executa as seguintes tarefas durante a primeira inicialização da instância:
+ Configura novo papel de parede que produz informações sobre a instância.
+ Define o nome do computador para o endereço IPv4 privado da instância.
+ Envia informações da instância ao console do Amazon EC2.
+ Envia a impressão digital do certificado RDP ao console do EC2.
+ Define uma senha aleatória para a conta do administrador.
+ Adiciona sufixos DNS.
+ Estende dinamicamente a partição do sistema operacional para incluir qualquer espaço não particionado.
+ Executa dados do usuário (se especificado). Para obter mais informações sobre como especificar os dados do usuário, consulte [Executar comandos ao iniciar uma instância do EC2 com entrada de dados do usuário](user-data.md).
+ Define rotas estáticas persistentes para alcançar o serviço de metadados e os servidores AWS KMS.
**Importante**
Se uma AMI personalizada for criada a partir dessa instância, essas rotas serão capturadas como parte da configuração do sistema operacional e quaisquer novas instâncias iniciadas a partir da AMI manterão as mesmas rotas, independentemente do posicionamento da sub-rede. Para atualizar as rotas, consulte [Para atualizar rotas de metadados/KMS para o Server 2016 e posterior ao iniciar uma AMI personalizada](ec2launch-sysprep.md#update-metadata-KMS).
As seguintes tarefas ajudam a manter a compatibilidade com versões anteriores do serviço do EC2Config. Também é possível configurar o EC2Launch para executar essas tarefas durante o startup:
+ Inicializar volumes de EBS secundários.
+ Enviar logs de eventos do Windows aos logs do console do EC2.
+ Enviar a mensagem *O Windows está pronto para uso* ao console do EC2.
## Estrutura de diretório do EC2Launch
Por padrão, o EC2Launch é instalado nas AMIs do Windows Server 2016 e posterior no diretório raiz `C:\ProgramData\Amazon\EC2-Windows\Launch`.
**nota**
Por padrão, o Windows oculta os arquivos e as pastas sob `C:\ProgramData`. Para visualizar os diretórios e arquivos do EC2Launch, digite o caminho no Windows Explorer ou altere as propriedades da pasta para os arquivos e as pastas ocultos.
O diretório `Launch` contém os seguintes subdiretórios.
+ `Scripts` — contém os scripts do PowerShell que compõem o EC2Launch.
+ `Module` — contém o módulo para compilação dos scripts relacionados ao Amazon EC2.
+ `Config` — contém arquivos script de configuração que é possível personalizar.
+ `Sysprep` — contém recursos de Sysprep.
+ `Settings`: contém uma aplicação para a interface gráfica do usuário do Sysprep.
+ `Library` – Contém bibliotecas compartilhadas para agentes de inicialização do EC2.
+ `Log`: contém subdiretórios para scripts e os arquivos de log que são gerados pelos scripts.
## Telemetria
Telemetria é informação adicional que ajuda o AWS a entender melhor suas necessidades, diagnosticar problemas e fornecer recursos para melhorar sua experiência com os serviços da AWS.
O EC2Launch versão `1.3.2003498` e posteriores coleta telemetria, como métricas de uso e erros. Esses dados são coletados na instância do Amazon EC2 na qual o EC2Launch é executado. Isso inclui todas as AMIs do Windows de propriedade da AWS.
Os seguintes tipos de telemetria são coletados pelo EC2Launch:
+ **Informações de uso**: comandos do agente, método de instalação e frequência de execução programada.
+ **Erros e informações de diagnóstico**: instalação do agente e execução dos códigos de erro.
Exemplos de dados coletados pelo:
```
2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsUserDataScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandCode=1
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandErrorCode=5
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallCode=2
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallErrorCode=0
```
A telemetria está habilitada por padrão. É possível desativar a coleta de telemetria a qualquer momento. Se a telemetria estiver habilitada, o EC2Launch enviará dados de telemetria sem notificações adicionais do cliente.
Sua escolha de habilitar ou desabilitar a telemetria é coletada.
É possível optar por habilitar ou desabilitar a coleta de telemetria. Sua seleção de optar por habilitar ou desabilitar telemetria é coletada para garantir que atenderemos à sua opção de telemetria.
**Visibilidade de telemetria**
Quando a telemetria é ativada, ela aparece na saída do console do Amazon EC2 da seguinte maneira:
```
2021/07/15 21:44:12Z: Telemetry:
```
**Desativar telemetria em uma instância**
Para desativar a telemetria definindo uma variável de ambiente do sistema, execute o seguinte comando como administrador:
```
setx /M EC2LAUNCH_TELEMETRY 0
```
Para desabilitar a telemetria durante a instalação, execute `install.ps1` da seguinte forma:
```
. .\install.ps1 -EnableTelemetry:$false
```
**Topics**
+ [Tarefas do EC2Launch](#ec2launch-tasks)
+ [Estrutura de diretório do EC2Launch](#ec2launch-directories)
+ [Telemetria](#ec2launch-telemetry)
+ [Instalar a versão mais recente do EC2Launch](ec2launch-download.md)
+ [Configurar o agente do EC2Launch v1 na instância do Windows](ec2launch-config.md)
+ [Histórico de versões do EC2Launch](ec2launch-version-details.md)