

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 die neueste Version von EC2 Launch v2
<a name="ec2launch-v2-install"></a>

Sie können eine der folgenden Methoden verwenden, um den EC2Launch v2-Agenten auf Ihrer EC2-Instance zu installieren:
+ Laden Sie den Agenten von Amazon S3 herunter und installieren Sie ihn mit Windows PowerShell. Informationen zum Herunterladen URLs finden Sie unter[EC2Starten Sie v2-Downloads auf Amazon S3](#lv2-download-s3).
+ Installation mit SSM-Distributor.
+ Installation von einer EC2-Image-Builder-Komponente, wenn Sie ein benutzerdefiniertes Image erstellen.
+ Starten Sie Ihre Instance von einem AMI aus, auf dem EC2 Launch v2 vorinstalliert ist.

**Warnung**  
AmazonEC2Launch.msi deinstalliert frühere Versionen der EC2-Startdienste wie EC2 Launch (v1) und EC2 Config.

Wählen Sie für die Installationsschritte die Registerkarte aus, die Ihrer bevorzugten Methode entspricht.

------
#### [ PowerShell ]

Gehen Sie folgendermaßen vor, um die neueste Version des EC2 Launch v2-Agents mit Windows PowerShell zu installieren.

1. Erstellen Sie Ihr lokales Verzeichnis.

   ```
   New-Item -Path "$env:USERPROFILE\Desktop\EC2Launchv2" -ItemType Directory
   ```

1. Legen Sie die URL für Ihren Download-Speicherort fest. Führen Sie den folgenden Befehl mit der von Ihnen verwendeten Amazon-S3-URL aus. Den Download finden URLs Sie unter [EC2Starten Sie v2-Downloads auf Amazon S3](#lv2-download-s3)

   ```
   $Url = "Amazon S3 URL/AmazonEC2Launch.msi"
   ```

1. Verwenden Sie den folgenden zusammengesetzten Befehl, um den Agenten herunterzuladen und die Installation auszuführen 

   ```
   $DownloadFile = "$env:USERPROFILE\Desktop\EC2Launchv2\" + $(Split-Path -Path $Url -Leaf)
   Invoke-WebRequest -Uri $Url -OutFile $DownloadFile
   msiexec /i "$DownloadFile"
   ```
**Anmerkung**  
Wenn beim Herunterladen der Datei eine Fehlermeldung angezeigt wird und Sie Windows Server 2016 oder eine frühere Version verwenden, muss TLS 1.2 möglicherweise für Ihr PowerShell Terminal aktiviert werden. Sie können TLS 1.2 für die aktuelle PowerShell Sitzung mit dem folgenden Befehl aktivieren und es dann erneut versuchen:  

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

1. **msiexec**Mit dem Befehl wird EC2 Launch v2 auf Windows Server-Instanzen am folgenden Speicherort installiert:`%ProgramFiles%\Amazon\EC2Launch`. Um zu überprüfen, ob die Installation ausgeführt wurde, können Sie das lokale Dateisystem auf Ihrer Instance überprüfen.

------
#### [ AWS Systems Manager Distributor ]

Informationen zum Konfigurieren automatischer Updates für EC2 Launch v2 mit AWS Systems Manager Quick Setup finden Sie unter[Automatische Installation und Aktualisierung mit Distributor Quick Setup](#lv2-distributor-quick-setup). 

Sie können auch eine einmalige Installation des`AWSEC2Launch-Agent`-Pakets vom AWS Systems Manager -Distributor durchführen. Anweisungen zum Installieren eines Pakets vom Systems Manager Distributor finden Sie unter [Installieren oder Aktualisieren von Paketen](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) im *AWS Systems Manager -Benutzerhandbuch*.

------
#### [ EC2 Image Builder component ]

Sie können die Komponente `ec2launch-v2-windows` installieren, wenn Sie ein benutzerdefiniertes Image mit EC2 Image Builder erstellen. Anweisungen zum Erstellen eines benutzerdefinierten Image mit EC2 Image Builder finden Sie unter[Erstellen einer Image-Pipeline mithilfe des EC2-Image-Builder-Konsolenassistenten](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html) im *Benutzerhandbuch für EC2 Image Builder*.

------
#### [ AMI ]

EC2Launch v2 ist standardmäßig auf AMIs den Betriebssystemen Windows Server 2022 und höher vorinstalliert:
+ Windows\$1Server- -Englisch- Vollversion *version*
+ Windows\$1Server- *version* -Core-Base auf Englisch
+ Windows\$1Server- *version* -Englisch-Core-EKS\$1optimiert
+ Windows Server *version* AMIs mit allen anderen Sprachen
+ Windows Server *version* AMIs mit installiertem SQL

EC2Launch v2 ist ebenfalls auf den folgenden Windows-Server-AMIs vorinstalliert. Sie können diese AMIs über die Amazon-EC2-Konsole oder mithilfe des folgenden Suchpräfixes finden: `EC2LaunchV2-` in der  AWS CLI.
+ EC2Starten Sie v2-Windows\$1Server-2019-English-Core-Base
+ EC2Launchv2-Windows\$1Server-2019-Englisch — Vollversion
+ EC2Starten Sie v2-Windows\$1Server-2016-English-Core-Base
+ EC2Launchv2-Windows\$1Server-2016-Englisch — Vollversion

------

## Installieren und aktualisieren Sie Launch v2 automatisch mit Distributor Quick Setup EC2 AWS Systems Manager
<a name="lv2-distributor-quick-setup"></a>

Mit AWS Systems Manager Distributor Quick Setup können Sie automatische Updates für EC2 Launch v2 einrichten. Der folgende Prozess richtet eine Systems Manager Association auf Ihrer Instance ein, die den EC2 Launch v2-Agent automatisch mit einer von Ihnen angegebenen Frequenz aktualisiert. Die Zuordnung, die der Distributor Quick Setup erstellt, kann Instanzen innerhalb einer AWS-Konto UND-Region oder Instanzen innerhalb einer AWS Organisation umfassen. Weitere Informationen finden Sie unter [Anleitung: Erstellen und Konfigurieren einer Organisation](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tutorials_basic.html) im *Benutzerhandbuch für AWS Organizations *.

Stellen Sie vor Beginn sicher, dass Ihre Instances alle Voraussetzungen erfüllen.

### Voraussetzungen
<a name="lv2-distributor-quickset-prereq"></a>

Um automatische Updates mit Distributor Quick Setup einzurichten, müssen Ihre Instances die folgenden Voraussetzungen erfüllen.
+ Sie haben mindestens eine laufende Instance, die EC2 Launch v2 unterstützt. Sehen Sie unterstützte Betriebssysteme für [EC2Starten Sie v2](ec2launch-v2.md).
+ Sie haben die Systems-Manager-Einrichtungsaufgaben auf Ihren Instances ausgeführt. Weitere Informationen finden Sie unter [System Manager einrichten](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-ec2.html) im *AWS Systems Manager -Benutzerhandbuch*.
+ EC2Launch v2 muss der einzige Launch-Agent sein, der auf Ihrer Instance installiert ist. Wenn Sie mehr als einen Start-Agenten installiert haben, schlägt die Konfiguration der Distributor Quick Setup fehl. Bevor Sie EC2 Launch v2 mit einem Distributor Quick Setup konfigurieren, deinstallieren Sie EC2 Config- oder EC2 Launch v1-Startagenten, sofern sie vorhanden sind.

### Konfigurieren Sie Distributor Quick Setup für EC2 Launch v2
<a name="lv2-distributor-quickset-config"></a>

Um eine Konfiguration für EC2 Launch v2 mit Distributor Quick Setup zu erstellen, verwenden Sie die folgenden Einstellungen, wenn Sie die Schritte für die [Bereitstellung des Distributor-Pakets](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-distributor.html) abschließen:
+ **Softwarepakete:** Amazon EC2 Launch v2 Agent.
+ **Aktualisierungshäufigkeit:** Wählen Sie eine Frequenz aus der Liste aus.
+ **Ziele:** Wählen Sie aus den verfügbaren Bereitstellungsoptionen.

Um den Status Ihrer Konfiguration zu überprüfen, navigieren Sie zur Registerkarte **Konfigurationen** des Systems Manager Quick Setup in der AWS-Managementkonsole.

1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Wählen Sie im Navigationsbereich **Quick Setup** aus.

1. Wählen Sie auf der Registerkarte **Konfigurationen** die Zeile aus, die mit der von Ihnen erstellten Konfiguration verknüpft ist. Die Registerkarte **Konfigurationen** listet Ihre Konfigurationen auf und enthält eine Zusammenfassung der wichtigsten Details wie **Region**, **Bereitstellungsstatus** und **Zuordnungsstatus**.
**Anmerkung**  
Der Zuordnungsname für jede EC2 Launch v2 Distributor-Konfiguration beginnt mit dem folgenden Präfix:`AWS-QuickSetup-Distributor-EC2Launch-Agent-`.

1. Um Details anzuzeigen, wählen Sie die Konfiguration aus und klicken Sie auf Details **anzeigen**.

Weitere Informationen und Schritte zur Fehlerbehebung finden Sie unter [Problembehandlung bei Ergebnissen von Quick Setup](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-results-troubleshooting.html) im *AWS Systems Manager -Benutzerhandbuch*.

## EC2Starten Sie v2-Downloads auf Amazon S3
<a name="lv2-download-s3"></a>

Um die neueste Version von EC2 Launch v2 zu installieren, laden Sie das Installationsprogramm vom folgenden Ort herunter:
+ [https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi](https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi)

## Installationsoptionen konfigurieren
<a name="lv2-configure-install"></a>

Wenn Sie EC2 Launch v2 installieren oder aktualisieren, können Sie die Installationsoptionen mit dem EC2 Launch v2-Installationsdialogfeld oder mit dem **msiexec** Befehl in einer Befehlszeilenshell konfigurieren.

Wenn das EC2 Launch v2-Installationsprogramm zum ersten Mal auf einer Instance ausgeführt wird, initialisiert es die Launch-Agent-Einstellungen auf Ihrer Instance wie folgt:
+ Es erstellt den lokalen Pfad und schreibt die Datei des Startagenten dorthin. Dies wird manchmal als *Neuinstallation* bezeichnet.
+ Es erstellt die Umgebungsvariable `EC2LAUNCH_TELEMETRY`, sofern diese noch nicht vorhanden ist, und legt sie basierend auf Ihrer Konfiguration fest.

Wählen Sie für Konfigurationsdetails die Registerkarte aus, die der von Ihnen verwendeten Konfigurationsmethode entspricht.

------
#### [ Amazon EC2Launch Setup dialog ]

Wenn Sie EC2 Launch v2 installieren oder aktualisieren, können Sie im EC2 Launch v2-Installationsdialogfeld die folgenden Installationsoptionen konfigurieren.Optionen der **Grundlegende Installation**

**Telemetrie senden**  
Wenn Sie dieses Feature in den Einrichtungsdialog aufnehmen, legt das Installationsprogramm die Umgebungsvariable `EC2LAUNCH_TELEMETRY` auf einen Wert von `1` fest. Wenn Sie **Telemetrie senden** deaktivieren, legt das Installationsprogramm die Umgebungsvariable auf den Wert `0` fest.  
Wenn der EC2 Launch v2-Agent ausgeführt wird, liest er die `EC2LAUNCH_TELEMETRY` Umgebungsvariable, um zu bestimmen, ob Telemetriedaten hochgeladen werden sollen. Wenn der Wert gleich `1` ist, werden die Daten hochgeladen. Andernfalls wird der Upload nicht durchgeführt.

**Standardkonfiguration**  
Die Standardkonfiguration für EC2 Launch v2 besteht darin, den lokalen Launch-Agent zu überschreiben, falls er bereits vorhanden ist. Wenn Sie zum ersten Mal eine Installation auf einer Instance ausführen, wird in der Standardkonfiguration eine Neuinstallation durchgeführt. Wenn Sie die Standardkonfiguration bei der Erstinstallation deaktivieren, schlägt die Installation fehl.  
Wenn Sie die Installation auf der Instance erneut ausführen, können Sie die Standardkonfiguration deaktivieren, um ein Upgrade durchzuführen, bei dem die `%ProgramData%/Amazon/EC2Launch/config/agent-config.yml`-Datei nicht ersetzt wird.

**Beispiel: Führen Sie ein Upgrade von EC2 Launch v2 mit Telemetrie durch**  
Das folgende Beispiel zeigt den EC2 Launch v2-Setup-Dialog, der so konfiguriert ist, dass die aktuelle Installation aktualisiert und Telemetrie aktiviert wird. Diese Konfiguration führt eine Installation durch, ohne die Agent-Konfigurationsdatei zu ersetzen, und legt die Umgebungsvariable `EC2LAUNCH_TELEMETRY` auf den Wert `1` fest.

![\[EC2Starten Sie die v2-Upgrade-Konfiguration.\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/images/ec2launchv2-clean-default-config.png)


------
#### [ Command line ]

Wenn Sie EC2 Launch v2 installieren oder aktualisieren, können Sie die folgenden Installationsoptionen mit dem **msiexec** Befehl in einer Befehlszeilenshell konfigurieren.`ADDLOCAL`-Parameterwerte

**Grundlegend** (erforderlich)  
Installieren Sie den Start-Agenten. Wenn dieser Wert im `ADDLOCAL`-Parameter nicht vorhanden ist, wird die Installation beendet.

**Bereinigen**  
Wenn Sie den `Clean`-Wert in den `ADDLOCAL`-Parameter einbeziehen, schreibt das Installationsprogramm die Agent-Konfigurationsdatei an den folgenden Speicherort: `%ProgramData%/Amazon/EC2Launch/config/agent-config.yml`. Wenn die Agent-Konfigurationsdatei bereits vorhanden ist, wird die Datei überschrieben.  
Wenn Sie den `Clean`-Wert im `ADDLOCAL`-Parameter weglassen, führt das Installationsprogramm ein Upgrade durch, das die Agent-Konfigurationsdatei nicht ersetzt.

**Telemetrie**  
Wenn Sie den `Telemetry`-Wert in den `ADDLOCAL`-Parameter einbeziehen, legt das Installationsprogramm die Umgebungsvariable `EC2LAUNCH_TELEMETRY` auf den Wert `1` fest.  
Wenn Sie den `Telemetry`-Wert in den `ADDLOCAL`-Parameter einbeziehen, legt das Installationsprogramm die Umgebungsvariable auf den Wert `0` fest.  
Wenn der EC2 Launch v2-Agent ausgeführt wird, liest er die `EC2LAUNCH_TELEMETRY` Umgebungsvariable, um zu bestimmen, ob Telemetriedaten hochgeladen werden sollen. Wenn der Wert gleich `1` ist, werden die Daten hochgeladen. Andernfalls wird der Upload nicht durchgeführt.

**Beispiel: Installieren Sie EC2 Launch v2 mit Telemetrie**

```
& msiexec /i "C:\Users\Administrator\Desktop\EC2Launchv2\AmazonEC2Launch.msi" ADDLOCAL="Basic,Clean,Telemetry" /q
```

------

## Überprüfen Sie die EC2 Launch v2-Version
<a name="lv2-verify-version"></a>

Verwenden Sie eines der folgenden Verfahren, um die Version von EC2 Launch v2 zu überprüfen, die auf Ihren Instances installiert ist.



------
#### [ PowerShell ]

Überprüfen Sie die installierte Version von EC2 Launch v2 mit Windows PowerShell wie folgt.

1. Starten Sie eine Instance von Ihrem AMI und stellen Sie eine Verbindung damit her.

1. Führen Sie den folgenden Befehl aus PowerShell , um die installierte Version von EC2 Launch v2 zu überprüfen:

   ```
   & "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" version
   ```

------
#### [ Windows Control Panel ]

Überprüfen Sie die installierte Version von EC2 Launch v2 in der Windows-Systemsteuerung wie folgt.

1. Starten Sie eine Instance von Ihrem AMI und stellen Sie eine Verbindung damit her.

1. Öffnen Sie die Windows-Systemsteuerung und wählen Sie **Programme und Features**.

1. Suchen Sie in der Liste mit den installierten Programmen nach `Amazon EC2Launch`. Die Versionsnummer wird in der Spalte **Version** angegeben.

------

Die neuesten Updates für Windows finden Sie im AWS [Windows AMIs AMI-Versionsverlauf](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ec2-windows-ami-version-history.html) in der *AWS Windows AMI-Referenz*.

Die neueste Version von EC2 Launch v2 finden Sie unter[EC2Versionsverlauf für Version 2 starten](ec2launchv2-versions.md#ec2launchv2-version-history).

Sie können Benachrichtigungen erhalten, wenn neue Versionen des EC2 Launch v2-Dienstes veröffentlicht werden. Weitere Informationen finden Sie unter [Abonnieren Sie Benachrichtigungen für den EC2 Windows Launch Agent](launch-agents-subscribe-notifications.md).