Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Installation de l' CodeDeploy agent pour Windows Server
Sur les instances Windows Server, vous pouvez utiliser l'une des méthodes suivantes pour télécharger et installer l' CodeDeploy agent :
+ Utilisation AWS Systems Manager (recommandée)
+ Exécutez une série de PowerShell commandes Windows.
+ Choisissez un lien de téléchargement direct.
+ Exécutez une commande de copie Amazon S3.
**Note**
Le dossier dans lequel l' CodeDeploy agent est installé est`C:\Program Data\Amazon\CodeDeploy`. Assurez-vous qu'il n'y a pas de jonctions de répertoires ou de liens symboliques sur ce chemin.
**Topics**
+ [Utiliser Systems Manager](#codedeploy-agent-operations-install-system-manager)
+ [Utiliser Windows PowerShell](#codedeploy-agent-operations-install-windows-powershell)
+ [Utilisation d'un lien direct](#codedeploy-agent-operations-install-windows-direct-link)
+ [Utiliser une commande de copie Amazon S3](#codedeploy-agent-operations-install-windows-s3-copy)
## Utiliser Systems Manager
Suivez les instructions [Installez l' CodeDeploy agent à l'aide de AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) pour installer l' CodeDeployagent.
## Utiliser Windows PowerShell
Connectez-vous à l'instance et exécutez les commandes suivantes sous Windows PowerShell :
1. Exigez que tous les scripts et les fichiers de configuration téléchargés depuis Internet soient signées par un éditeur de confiance. Si vous êtes invité à modifier la stratégie d'exécution, tapez « **Y** ».
```
Set-ExecutionPolicy RemoteSigned
```
1. Chargez le AWS Tools for Windows PowerShell.
```
Import-Module AWSPowerShell
```
1. Créez un répertoire dans lequel le fichier d'installation de l' CodeDeploy agent est téléchargé.
```
New-Item -Path "c:\temp" -ItemType "directory" -Force
```
1. Configurez AWS les informations d'identification à l'aide `Set-AWSCredential` des `Initialize-AWSDefaultConfiguration` commandes et. Pour plus d'informations, consultez la section [Utilisation des AWS informations d'identification](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html) dans les *AWS outils du Guide de PowerShell l'utilisateur*.
1. Téléchargez le fichier d'installation de l' CodeDeploy agent.
**Note**
AWS prend en charge la dernière version mineure de l' CodeDeploy agent. Actuellement, la dernière version mineure est 1.7.x.
Pour installer la dernière version de l' CodeDeployagent :
+
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi
```
Pour installer une version spécifique de l' CodeDeployagent :
+
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi
```
*bucket-name*est le nom du compartiment Amazon S3 qui contient les fichiers du kit de CodeDeploy ressources pour votre région. Par exemple, pour la région USA Est (Ohio), remplacez *bucket-name* par`aws-codedeploy-us-east-2`. Pour obtenir la liste des noms de compartiments, consultez[Noms des compartiments du kit de ressources par région](resource-kit.md#resource-kit-bucket-names).
1. Exécutez le fichier d'installation de l' CodeDeploy agent.
```
c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt
```
Pour vérifier que le service est en cours d'exécution, exécutez la commande suivante :
```
powershell.exe -Command Get-Service -Name codedeployagent
```
Si l' CodeDeploy agent vient d'être installé et n'a pas été démarré, après avoir exécuté la **Get-Service** commande, sous **État**, vous devriez voir **Start...** :
```
Status Name DisplayName
------ ---- -----------
Start... codedeployagent CodeDeploy Host Agent Service
```
Si l' CodeDeploy agent est déjà en cours d'exécution, après avoir exécuté la **Get-Service** commande, sous **État**, vous devriez voir **Running** :
```
Status Name DisplayName
------ ---- -----------
Running codedeployagent CodeDeploy Host Agent Service
```
## Utilisation d'un lien direct
Si les paramètres de sécurité du navigateur de l'instance Windows Server fournissent les autorisations (par exemple, pour`https://s3.*.amazonaws.com`), vous pouvez utiliser un lien direct vers votre région pour télécharger l' CodeDeploy agent, puis exécuter le programme d'installation manuellement.
Le lien est le suivant :
```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi
```
... où se *region* trouve la AWS région dans laquelle vous déployez votre application.
Par exemple :
```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi
```
**Important**
Procurez-vous le `.msi` fichier auprès de la même région que votre CodeDeploy demande. Le choix d'une autre région peut entraîner `inconsistent region` des défaillances dans le `codedeploy-agent-log` fichier lorsque vous l'`.msi`exécutez.
## Utiliser une commande de copie Amazon S3
S'il AWS CLI est installé sur l'instance, vous pouvez utiliser la commande Amazon S3 [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) pour télécharger l' CodeDeploy agent, puis exécuter le programme d'installation manuellement. Pour plus d'informations, voir [Installer AWS Command Line Interface le sous Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html).
La commande Amazon S3 est la suivante :
```
aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region
```
... où se *region* trouve la AWS région dans laquelle vous déployez votre application.
Par exemple :
```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1
```