# Instalar a versão mais recente do EC2Config
<a name="UsingConfig_Install"></a>

**nota**  
O agente de inicialização mais recente do Windows Server 2022 e versões posteriores do sistema operacional é o [EC2Launch v2](ec2launch-v2.md), que substitui o EC2Config e o EC2Launch. O EC2Launch v2 vem pré-instalado nas AMIs Windows Server 2022 e 2025 da AWS. 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 obter informações sobre como receber notificações para atualizações do EC2Config, consulte [Assinar as notificações do agente de execução do EC2 Windows](launch-agents-subscribe-notifications.md). Para obter informações sobre alterações em cada versão, consulte [Histórico de versões do EC2Config](ec2config-version-details.md).

## Antes de começar
<a name="ec2config-prereqs"></a>
+ Verifique que você tem .NET framework 3.5 SP1 ou posterior.
+ Por padrão, a configuração substitui os arquivos de configuração durante a instalação e reinicia o serviço EC2Config quando a instalação é concluída. Se você tiver alterado as configurações do serviço EC2Config, copie o arquivo `config.xml` do diretório `%Program Files%\Amazon\Ec2ConfigService\Settings`. Após atualizar o serviço EC2Config, será possível restaurar esse arquivo para reter as alterações nas configurações.

## Verificar a versão do EC2Config
<a name="ec2config-verify-version"></a>

Use o procedimento a seguir para verificar a versão do EC2Config que está instalada em suas instâncias.

**Para verificar a versão instalada do EC2Config**

1. Execute uma instância pela AMI e conecte-se a ela.

1. No Painel de Controle, selecione **Programas e Recursos**.

1. Na lista de programas instalados, procure `Ec2ConfigService`. O número da versão aparece na coluna **Versão**.

## Atualizar o EC2Config
<a name="ec2config-update-version"></a>

Use o seguinte procedimento para fazer download e instalar a versão mais recente do EC2Config em suas instâncias.

**Para fazer download e instalar a versão mais recente do EC2Config**

1. Faça download e descompacte o [instalador do EC2Config](https://s3.amazonaws.com/ec2-downloads-windows/EC2Config/EC2Install.zip).

1. Execute `EC2Install.exe`. Para uma lista completa de opções, execute `EC2Install` com a opção `/?`. Por padrão, a configuração exibe os prompts. Para executar o comando sem prompts, use a opção `/quiet`.
**Importante**  
Para manter as configurações personalizadas do arquivo `config.xml` que você salvou, execute `EC2Install` com a opção `/norestart`, restaure as configurações e reinicie o serviço EC2Config manualmente.

1. Se você estiver executando o EC2Config versão 4.0 ou superior, reinicie o SSM Agent na instância do snap-in do Microsoft Services.
**nota**  
As informações da versão atualizada do EC2Config não serão exibidas no log do sistema da instância ou na verificação do Trusted Advisor até que você reinicialize ou interrompa e inicie a instância.

**Para baixar e instalar a versão mais recente do EC2Config usando o PowerShell**  
Para baixar, descompactar e instalar a versão mais recente do EC2Config usando o PowerShell, execute os seguintes comandos em uma janela do PowerShell:

```
$Url = "https://s3.amazonaws.com/ec2-downloads-windows/EC2Config/EC2Install.zip"
$DownloadZipFile = "$env:USERPROFILE\Desktop\" + $(Split-Path -Path $Url -Leaf)
$ExtractPath = "$env:USERPROFILE\Desktop\"
Invoke-WebRequest -Uri $Url -OutFile $DownloadZipFile
$ExtractShell = New-Object -ComObject Shell.Application 
$ExtractFiles = $ExtractShell.Namespace($DownloadZipFile).Items() 
$ExtractShell.NameSpace($ExtractPath).CopyHere($ExtractFiles) 
Start-Process $ExtractPath
Start-Process `
    -FilePath $env:USERPROFILE\Desktop\EC2Install.exe `
    -ArgumentList "/S"
```

**nota**  
Se você receber um erro ao baixar o arquivo e estiver usando o Windows Server 2016 ou anterior, talvez seja necessário habilitar o TLS 1.2 para seu terminal PowerShell. É possível habilitar o TLS 1.2 para a sessão atual do PowerShell com o comando a seguir e tentar novamente:  

```
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
```

Verifique a instalação conferindo `C:\Program Files\Amazon\` para o diretório do `Ec2ConfigService`.