Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Installieren Sie den CodeDeploy Agenten für Windows Server
Auf Windows Server-Instanzen können Sie eine der folgenden Methoden verwenden, um den CodeDeploy Agenten herunterzuladen und zu installieren:
+ Verwenden Sie AWS Systems Manager (empfohlen)
+ Führen Sie eine Reihe von PowerShell Windows-Befehlen aus.
+ Wählen eines direkten Download-Links
+ Führen Sie einen Amazon S3-Kopierbefehl aus.
**Anmerkung**
Der Ordner, in dem der CodeDeploy Agent installiert ist, ist`C:\ProgramData\Amazon\CodeDeploy`. Platzieren Sie keine Verzeichnisverbindungen oder symbolischen Links auf diesem Pfad. Für Version 2.0.x und höher setzt der Agent diese Anforderung durch und weigert sich, zu starten, wenn die Dienst-Binärdatei nicht unter ist. `C:\ProgramData\Amazon\CodeDeploy\`
**Topics**
+ [Verwenden von Systems Manager](#codedeploy-agent-operations-install-system-manager)
+ [Verwenden Sie Windows PowerShell](#codedeploy-agent-operations-install-windows-powershell)
+ [Verwenden eines Direkt-Links](#codedeploy-agent-operations-install-windows-direct-link)
+ [Verwenden Sie einen Amazon S3-Befehl zum Kopieren](#codedeploy-agent-operations-install-windows-s3-copy)
## Verwenden von Systems Manager
Folgen Sie den Anweisungen unter[Installieren Sie den CodeDeploy Agenten mit AWS Systems Manager](codedeploy-agent-operations-install-ssm.md), um den Agenten zu installieren. CodeDeploy
## Verwenden Sie Windows PowerShell
Melden Sie sich bei der Instanz an und führen Sie die folgenden Befehle in Windows aus PowerShell:
1. Fordern Sie an, dass nur Skripte und Konfigurationsdateien von vertrauenswürdigen Anbietern aus dem Internet heruntergeladen werden. Wenn Sie dazu aufgefordert werden, die Ausführungsrichtlinie zu ändern, geben Sie "**Y**" ein.
```
Set-ExecutionPolicy RemoteSigned
```
1. Laden Sie die AWS Tools for Windows PowerShell.
```
Import-Module AWSPowerShell
```
1. Erstellen Sie ein Verzeichnis, in das die CodeDeploy Agenteninstallationsdatei heruntergeladen wird.
```
New-Item -Path "c:\temp" -ItemType "directory" -Force
```
1. Konfigurieren Sie die AWS Anmeldeinformationen mithilfe der `Initialize-AWSDefaultConfiguration` Befehle `Set-AWSCredential` und. Weitere Informationen finden Sie unter [ Verwenden von AWS Anmeldeinformationen ](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html) in den *AWS Tools für das PowerShell Benutzerhandbuch*.
1. Laden Sie die CodeDeploy Agenteninstallationsdatei herunter.
**Anmerkung**
Die neueste veröffentlichte Version finden Sie unter[Versionsverlauf des Agenten CodeDeploy](codedeploy-agent.md#codedeploy-agent-version-history).
So installieren Sie die neueste Version des CodeDeploy Agenten:
+
```
powershell.exe -Command Read-S3Object -BucketName {{bucket-name}} -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi
```
Um eine bestimmte Version des CodeDeploy Agenten zu installieren:
+
```
powershell.exe -Command Read-S3Object -BucketName {{bucket-name}} -Key releases/codedeploy-agent-{{###}}.msi -File c:\temp\codedeploy-agent.msi
```
{{bucket-name}}ist der Name des Amazon S3-Buckets, der die CodeDeploy Resource Kit-Dateien für Ihre Region enthält. Ersetzen Sie beispielsweise für die Region USA Ost (Ohio) {{bucket-name}} durch`aws-codedeploy-us-east-2`. Eine Liste der Bucket-Namen finden Sie unter[Bucket-Namen für das Resource Kit nach Regionen](resource-kit.md#resource-kit-bucket-names).
1. Führen Sie die CodeDeploy Agenten-Installationsdatei aus.
```
c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt
```
Führen Sie den folgenden Befehl aus, um zu prüfen, ob der Dienst ausgeführt wird:
```
powershell.exe -Command Get-Service -Name codedeployagent
```
Wenn der CodeDeploy Agent gerade installiert und noch nicht gestartet wurde, sollten Sie nach dem Ausführen des **Get-Service** Befehls unter ** Status ** Folgendes sehen**Start...**:
```
Status Name DisplayName
------ ---- -----------
Start... codedeployagent CodeDeploy Host Agent Service
```
Wenn der CodeDeploy Agent bereits läuft, sollten Sie nach dem Ausführen des **Get-Service** Befehls ** unter ** Status Folgendes sehen**Running**:
```
Status Name DisplayName
------ ---- -----------
Running codedeployagent CodeDeploy Host Agent Service
```
## Verwenden eines Direkt-Links
Wenn die Sicherheitseinstellungen des Browsers auf der Windows Server-Instanz die entsprechenden Berechtigungen enthalten (z. B. für`https://s3.*.amazonaws.com`), können Sie einen direkten Link für Ihre Region verwenden, um den CodeDeploy Agenten herunterzuladen und das Installationsprogramm anschließend manuell auszuführen.
Der Link lautet:
```
https://s3.{{region}}.amazonaws.com/aws-codedeploy-{{region}}/latest/codedeploy-agent.msi
```
... wo {{region}} ist die AWS Region, in der Sie Ihre Anwendung bereitstellen.
Beispiel:
```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi
```
**Wichtig**
Besorgen Sie sich die `.msi` Datei aus derselben Region wie Ihre CodeDeploy Anwendung. Die Auswahl einer anderen Region kann zu `inconsistent region` Fehlern in der `codedeploy-agent-log` Datei führen, wenn Sie die `.msi` Datei ausführen.
## Verwenden Sie einen Amazon S3-Befehl zum Kopieren
Wenn der auf der Instance installiert AWS CLI ist, können Sie den Amazon [ S3-Befehl ](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) cp verwenden, um den CodeDeploy Agenten herunterzuladen und das Installationsprogramm dann manuell auszuführen. Weitere Informationen finden [ Sie unter Installieren von AWS Command Line Interface unter Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html).
Der Amazon S3-Befehl lautet:
```
aws s3 cp s3://aws-codedeploy-{{region}}/latest/codedeploy-agent.msi codedeploy-agent.msi --region {{region}}
```
... wo {{region}} ist die AWS Region, in der Sie Ihre Anwendung bereitstellen.
Beispiel:
```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1
```