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á.

# Instale o CodeDeploy agente para Windows Server
<a name="codedeploy-agent-operations-install-windows"></a>

Nas instâncias do Windows Server, você pode usar um desses métodos para baixar e instalar o CodeDeploy agente:
+ Uso AWS Systems Manager (recomendado)
+ Execute uma série de PowerShell comandos do Windows.
+ Escolha um link de download direto.
+ Execute um comando de cópia do Amazon S3.

**nota**  
A pasta na qual o CodeDeploy agente está instalado é`C:\Program Data\Amazon\CodeDeploy`. Certifique-se de que não haja junções de diretórios ou links simbólicos nesse caminho.

**Topics**
+ [Usar o Systems Manager](#codedeploy-agent-operations-install-system-manager)
+ [Use o Windows PowerShell](#codedeploy-agent-operations-install-windows-powershell)
+ [Usar um link direto](#codedeploy-agent-operations-install-windows-direct-link)
+ [Usar um comando de cópia do Amazon S3](#codedeploy-agent-operations-install-windows-s3-copy)

## Usar o Systems Manager
<a name="codedeploy-agent-operations-install-system-manager"></a>

Siga as instruções [Instale o CodeDeploy agente usando AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) para instalar o CodeDeploy agente.

## Use o Windows PowerShell
<a name="codedeploy-agent-operations-install-windows-powershell"></a>

Faça login na instância e execute os seguintes comandos no Windows PowerShell:

1.  Exija que todos os scripts e arquivos de configuração baixados da Internet sejam assinados por um editor confiável. Se você precisar alterar a política de execução, digite "**Y**". 

   ```
    Set-ExecutionPolicy RemoteSigned
   ```

1.  Carregue AWS Tools for Windows PowerShell o. 

   ```
   Import-Module AWSPowerShell
   ```

1.  Crie um diretório no qual o arquivo de instalação do CodeDeploy agente é baixado. 

   ```
   New-Item -Path "c:\temp" -ItemType "directory" -Force
   ```

1. Configure AWS as credenciais usando os `Initialize-AWSDefaultConfiguration` comandos `Set-AWSCredential` e. Para obter mais informações, consulte [Usando AWS credenciais](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html) nas *AWS ferramentas do Guia PowerShell do Usuário*.

1.  Baixe o arquivo de instalação do CodeDeploy agente. 
**nota**  
AWS suporta a versão secundária mais recente do CodeDeploy agente. Atualmente, a versão secundária mais recente é 1.7.x.

   Para instalar a versão mais recente do CodeDeploy agente:
   + 

     ```
     powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi
     ```

   Para instalar uma versão específica do CodeDeploy agente:
   + 

     ```
     powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi
     ```

   *bucket-name*é o nome do bucket do Amazon S3 que contém os arquivos do CodeDeploy Resource Kit para sua região. Por exemplo, para a região Leste dos EUA (Ohio), *bucket-name* substitua por`aws-codedeploy-us-east-2`. Para obter uma lista de nomes de buckets, consulte [Nomes de bucket do kit de recursos por região](resource-kit.md#resource-kit-bucket-names).

1.  Execute o arquivo de instalação do CodeDeploy agente. 

   ```
   c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt
   ```

Para verificar se o serviço está em execução, execute o seguinte comando:

```
powershell.exe -Command Get-Service -Name codedeployagent
```

 Se o CodeDeploy agente acabou de ser instalado e não foi iniciado, depois de executar o **Get-Service** comando, em **Status**, você deverá ver**Start...**:

```
Status     Name                DisplayName
------     ----                -----------
Start...   codedeployagent    CodeDeploy Host Agent Service
```

Se o CodeDeploy agente já estiver em execução, depois de executar o **Get-Service** comando, em **Status**, você deverá ver**Running**:

```
Status     Name                DisplayName
------     ----                -----------
Running    codedeployagent    CodeDeploy Host Agent Service
```

## Usar um link direto
<a name="codedeploy-agent-operations-install-windows-direct-link"></a>

Se as configurações de segurança do navegador na instância do Windows Server fornecerem as permissões (por exemplo, para`https://s3.*.amazonaws.com`), você poderá usar um link direto para sua região para baixar o CodeDeploy agente e executar o instalador manualmente.

O link é:

```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi
```

... onde *region* está a AWS região em que você está implantando seu aplicativo.

Por exemplo:

```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi
```

**Importante**  
Obtenha o `.msi` arquivo da mesma região do seu CodeDeploy aplicativo. Escolher uma região diferente pode causar falhas de `inconsistent region` no arquivo `codedeploy-agent-log` quando você executar o arquivo `.msi`.

## Usar um comando de cópia do Amazon S3
<a name="codedeploy-agent-operations-install-windows-s3-copy"></a>

Se o AWS CLI estiver instalado na instância, você poderá usar o comando [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) do Amazon S3 para baixar o CodeDeploy agente e, em seguida, executar o instalador manualmente. Para obter informações, consulte [Instalar o AWS Command Line Interface no Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html). 

O comando do Amazon S3 é:

```
aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region
```

... onde *region* está a AWS região em que você está implantando seu aplicativo.

Por exemplo:

```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1
```