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.
# Den EC2Launch-v2-Agenten verwenden, um Aufgaben während des Starts einer EC2-Windows-Instance auszuführen
Alle unterstützten Instances von Amazon EC2, die von AWS Windows Server 2022 und Windows Server 2025 aus gestartet werden, AMIs enthalten standardmäßig den EC2 Launch v2-Startagent (`EC2Launch.exe`). Wir bieten auch Windows Server 2016 und 2019 an, AMIs bei denen EC2 Launch v2 als Standard-Launch-Agent installiert ist. Diese AMIs werden zusätzlich zu den Windows Server 2016 und 2019 bereitgestellt AMIs , die EC2 Launch v1 enthalten. Sie können nach Windows suchen AMIs , das standardmäßig EC2 Launch v2 enthält, indem Sie bei Ihrer Suche auf der **AMIs**Seite in der Amazon EC2 EC2-Konsole das folgende Präfix eingeben:`EC2LaunchV2-Windows_Server-*`.
Einen Vergleich der Feature der Start-Agent-Version finden Sie unter [Amazon EC2 Launch Agents vergleichen](configure-launch-agents.md#ec2launch-agent-compare).
EC2Launch v2 führt Aufgaben während des Instance-Starts aus und wird ausgeführt, wenn eine Instance gestoppt und später gestartet oder neu gestartet wird. EC2Launch v2 kann auch Aufgaben bei Bedarf ausführen. Einige dieser Aufgaben sind automatisch aktiviert, während andere manuell aktiviert werden müssen. Der EC2 Launch v2-Dienst unterstützt alle EC2 Config- und EC2 Launch-Funktionen.
Dieser Service verwendet eine Konfigurationsdatei zur Steuerung seines Betriebs. Sie können die Konfigurationsdatei entweder mit einem grafischen Tool aktualisieren oder direkt als einzelne .yml-Datei (`agent-config.yml`) bearbeiten. Weitere Informationen zu den Datei-Speicherorten finden Sie unter [EC2Starten Sie die v2-Verzeichnisstruktur](#ec2launch-v2-directory).
EC2Launch v2 veröffentlicht Windows-Ereignisprotokolle, um Ihnen bei der Behebung von Fehlern und beim Einrichten von Auslösern zu helfen. Weitere Informationen finden Sie unter [Windows-Ereignisprotokolle](ec2launchv2-troubleshooting.md#ec2launchv2-windows-event-logs).
**Unterstützte OS-Versionen**
Der EC2 Launch v2-Agent unterstützt die folgenden Versionen des Windows Server-Betriebssystems (OS):
+ Windows Server 2025
+ Windows Server 2022
+ Windows Server 2019 (Langzeitwartungskanal und halbjährlicher Kanal)
+ Windows Server 2016
**Aufgaben, die standardmäßig ausgeführt werden**
Der EC2 Launch v2-Agent führt die folgenden Aufgaben standardmäßig nur einmal beim ersten Start der Instance aus. Die Aufgaben werden in der Reihenfolge organisiert, in der sie in der Startphase ausgeführt werden.
`Boot`-Phase
+ extendRootPartition
`PreReady`-Phase
+ activateWindows
+ setDnsSuffix
+ setAdminAccount
+ setWallpaper
`PostReady`-Phase
+ startSsm
## EC2Konzepte der Version 2 starten
Es ist hilfreich, die folgenden Konzepte zu verstehen, wenn EC2 Sie Launch v2 in Betracht ziehen.
**Agent-Konfiguration**
`agent-config`ist eine Datei, die sich im Konfigurationsordner für EC2 Launch v2 befindet. Sie umfasst die Konfiguration für den Start, das Netzwerk und die PostReady Stufen. PreReady Diese Datei wird verwendet, um die Instance-Konfiguration für Aufgaben festzulegen, die beim ersten oder späteren Start des AMI ausgeführt werden sollen.
Standardmäßig installiert die EC2 Launch v2-Installation eine `agent-config` Datei, die empfohlene Konfigurationen enthält, die im standardmäßigen Amazon Windows verwendet werden AMIs. Sie können die Konfigurationsdatei aktualisieren, um das von EC2 Launch v2 angegebene Standardstartverhalten für Ihr AMI zu ändern. Weitere Informationen zu den Datei-Speicherorten finden Sie unter [EC2Starten Sie die v2-Verzeichnisstruktur](#ec2launch-v2-directory).
**Frequency (Frequenz)**
Die Frequenz der Aufgaben bestimmt, wann Aufgaben ausgeführt werden sollen, abhängig vom Startkontext. Die meisten Aufgaben haben nur eine zulässige Frequenz. Sie können eine Frequenz für `executeScript`-Aufgaben festlegen.
Sie können die folgenden Frequenzen in der [EC2Starten Sie die v2-Aufgabenkonfiguration](ec2launch-v2-settings.md#ec2launch-v2-task-configuration) anzeigen.
+ Einmal – Die Aufgabe wird einmal ausgeführt, wenn das AMI zum ersten Mal gestartet wurde (Sysprep abgeschlossen).
+ Immer – Die Aufgabe wird jedes Mal ausgeführt, wenn der Startagent ausgeführt wird. Der Launch-Agent wird ausgeführt, wenn:
+ eine Instance startet oder neu startet
+ der EC2 Launch-Dienst wird ausgeführt
+ `EC2Launch.exe run` wird aufgerufen
**Stage**
Eine Phase ist eine logische Gruppierung von Aufgaben, die der EC2 Launch v2-Agent ausführt. Einige Aufgaben können nur in einer bestimmten Phase ausgeführt werden. Andere können in mehreren Phasen ausgeführt werden. Bei der Verwendung von `agent-config.yml` müssen Sie eine Liste von Stufen und eine Liste von Aufgaben angeben, die innerhalb jeder Stufe ausgeführt werden sollen.
Der Service führt die Phasen in der folgenden Reihenfolge aus:
Phase 1: Boot
Phase 2: Netzwerk
Stufe 3: PreReady
Windows ist bereit
Nach Abschluss der PreReady Phase sendet der Service die `Windows is ready` Nachricht an die Amazon EC2 EC2-Konsole.
Stufe 4: PostReady
Benutzerdaten werden während der *PostReady*Phase ausgeführt. Einige Skriptversionen werden vor der `agent-config.yml` *PostReady*Dateiphase ausgeführt, andere danach, und zwar wie folgt:
Vor `agent-config.yml`
+ YAML-Benutzerdaten-Version 1.1
+ XML-Benutzerdaten
Nach `agent-config.yml`
+ YAML-Benutzerdatenversion 1.0 (Legacy-Version für Abwärtskompatibilität)
Beispiele für Phasen und Aufgaben finden Sie unter [Beispiel: `agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-example-agent-config).
Wenn Sie Benutzerdaten verwenden, müssen Sie eine Liste von Aufgaben angeben, die der Startagent ausführen soll. Die Phase ist impliziert. Beispiele für Aufgaben finden Sie unter [Beispiel: Benutzerdaten](ec2launch-v2-settings.md#ec2launch-v2-example-user-data).
EC2Launch v2 führt die Liste der Aufgaben in der Reihenfolge aus, die Sie in `agent-config.yml` und in den Benutzerdaten angegeben haben. Die Phasen werden der Reihe nach ausgeführt. Die nächste Phase beginnt, nachdem die vorherige Phase abgeschlossen ist. Aufgaben werden nacheinander ausgeführt.
**Aufgabe**
Sie können eine Aufgabe aufrufen, um eine Aktion für eine Instance durchzuführen. Sie können Aufgaben in der `agent-config.yml`-Datei oder über Benutzerdaten konfigurieren. Eine Liste der verfügbaren Aufgaben für EC2 Launch v2 finden Sie unter [EC2Launch v2-Aufgaben](#ec2launch-v2-tasks). Schemata und Einzelheiten zur Aufgabenkonfiguration finden Sie unter [EC2Starten Sie die v2-Aufgabenkonfiguration](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
**Benutzerdaten**
Benutzerdaten sind Daten, die beim Starten einer Instance konfiguriert werden können. Sie können Benutzerdaten aktualisieren, um dynamisch zu ändern, wie benutzerdefinierte Einstellungen AMIs oder Schnellstartkonfigurationen konfiguriert AMIs werden. EC2Launch v2 unterstützt eine Eingabelänge von 60 kB für Benutzerdaten. Benutzerdaten enthalten nur die UserData Phase und werden daher nach der `agent-config` Datei ausgeführt. Sie können Benutzerdaten eingeben, wenn Sie eine Instance mit dem Launch Instance Wizard starten oder Sie können Benutzerdaten über die EC2-Konsole ändern. Weitere Informationen zum Arbeiten mit Benutzerdaten finden Sie unter [So verarbeitet Amazon EC2 Benutzerdaten für Linux-Instances](user-data.md#ec2-windows-user-data).
## EC2Übersicht über die Launch v2-Aufgaben
EC2Launch v2 kann bei jedem Start die folgenden Aufgaben ausführen:
+ Einrichten eines neuen und optional angepassten Hintergrundbildes, das Informationen über die Instance wiedergibt.
+ Festlegen der Attribute für das Administratorkonto, das auf dem lokalen Computer erstellt wird.
+ Hinzufügen von DNS-Suffixen zur Liste der Suffixe. Nur Suffixe, die noch nicht vorhanden sind, werden der Liste hinzugefügt.
+ Festlegen von Laufwerkbuchstaben für zusätzliche Volumes und deren Erweiterung, um den verfügbaren Speicherplatz zu nutzen.
+ Schreiben Sie Dateien aus der Konfiguration auf die Festplatte.
+ Führen Sie die in der EC2 Launch v2-Konfigurationsdatei angegebenen Skripts aus oder von`user-data`. Skripts von `user-data` können Klartext oder gezippt sein und als Base64-Format bereitgestellt werden.
+ Führen Sie ein Programm mit angegebenen Argumenten aus.
+ Erstellen des Computer-Namens.
+ Senden von Instance-Informationen an die Amazon EC2-Konsole.
+ Senden Sie den Fingerabdruck des RDP-Zertifikats an die Amazon-EC2-Konsole.
+ Erweiterung der Betriebssystempartition, um den gesamten nicht partitionierten Speicherplatz mit einzuschließen.
+ Führen Sie Benutzerdaten aus. Weitere Informationen zur Angabe von Benutzerdaten finden Sie unter [EC2Starten Sie die v2-Aufgabenkonfiguration](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
+ Legen Sie nicht-persistente statische Routen fest, um den Metadatendienst und die AWS KMS -Server zu erreichen.
+ Festlegen von Nicht-Boot-Partitionen auf `mbr` oder `gpt`.
+ Starten Sie den Systems-Manager-Service nach Sysprep.
+ Optimieren der ENA-Einstellungen.
+ Aktivieren von OpenSSH für spätere Windows-Versionen.
+ Aktivieren von Jumbo-Frames.
+ Stellen Sie Sysprep so ein, dass es mit EC2 Launch v2 ausgeführt wird.
+ Veröffentlichen von Windows-Ereignisprotokollen.
## EC2Starten Sie die v2-Verzeichnisstruktur
EC2Launch v2 sollte in den folgenden Verzeichnissen installiert werden:
+ Service-Binärdateien: `%ProgramFiles%\Amazon\EC2Launch`
+ Servicedaten (Einstellungen, Protokolldateien und Statusdateien): `%ProgramData%\Amazon\EC2Launch`
**Anmerkung**
Windows blendet Dateien und Ordner unter `C:\ProgramData` standardmäßig aus. Um die Verzeichnisse und Dateien von EC2 Launch v2 anzuzeigen, müssen Sie entweder den Pfad im Windows Explorer eingeben oder die Ordnereigenschaften so ändern, dass versteckte Dateien und Ordner angezeigt werden.
Das `%ProgramFiles%\Amazon\EC2Launch`-Verzeichnis enthält Binärdateien und unterstützende Bibliotheken. Es enthält die folgenden Unterverzeichnisse:
+ `settings`
+ `EC2LaunchSettingsUI.exe` – Benutzeroberfläche zum Ändern der `agent-config.yml`-Datei
+ `YamlDotNet.dll` – DLL zur Unterstützung einiger Vorgänge in der Benutzeroberfläche
+ `tools`
+ `ebsnvme-id.exe` – Tool zum Überprüfen der Metadaten der EBS-Volumes auf der Instance
+ `AWSAcpiSpcrReader.exe` – Tool zur Bestimmung des korrekten zu verwendenden COM-Ports
+ `EC2LaunchEventMessage.dll`— DLL zur Unterstützung der Windows-Ereignisprotokollierung für EC2 Launch
+ `service`
+ `EC2LaunchService.exe` – Ausführbare Windows-Servicedatei, die gestartet wird, wenn der Launch-Agent als Service ausgeführt wird.
+ `EC2AgentTelemetry.dll` – DLL zur Unterstützung der EC2-Agenten-Telemetrie
+ `EC2Launch.exe`— Haupt-Programmdatei für EC2 den Start
+ `EC2LaunchAgentAttribution.txt` – Zuweisung für Code, der innerhalb von EC2 Launch verwendet wird
Das Verzeichnis `%ProgramData%\Amazon\EC2Launch` enthält die folgenden Unterverzeichnisse. Alle von dem Service erzeugten Daten, einschließlich Protokolle, Konfiguration und Status, werden in diesem Verzeichnis gespeichert.
+ `config` – Konfiguration
Die Servicekonfigurationsdatei wird in diesem Verzeichnis als `agent-config.yml` gespeichert. Diese Datei kann aktualisiert werden, um Standardaufgaben zu ändern, hinzuzufügen oder zu entfernen, die von dem Service ausgeführt werden. Die Berechtigung zum Erstellen von Dateien in diesem Verzeichnis ist auf das Administratorkonto beschränkt, um die Eskalation von Berechtigungen zu verhindern.
+ `log` – Instance-Protokolle
In diesem Verzeichnis werden Protokolle für den Dienst (`agent.log``bench.log`), die Leistung (`telemetry.log`) und die Telemetrie () gespeichert. Bei `agent.log` einer Größe von 1 MB wird es automatisch rotiert und es wird eine Sicherungsdatei mit einem Zeitstempelformat erstellt (z. B.`agent-2026-03-02T18-56-39.188.log`). Es wird jeweils nur eine Backup-Logdatei verwaltet.
+ `state` – Servicestatusdaten
Hier wird der Status gespeichert, mit dem der Service ermittelt wird, welche Aufgaben ausgeführt werden sollen. Es gibt eine `.run-once`-Datei, die angibt, ob der Service bereits nach Sysprep ausgeführt wurde (so dass Aufgaben mit der Häufigkeit "einmal" bei der nächsten Ausführung übersprungen werden). Dieses Unterverzeichnis enthält ein `state.json` und `previous-state.json`, um den Status jeder Aufgabe zu verfolgen.
+ `sysprep` – Sysprep
Dieses Verzeichnis enthält Dateien, die verwendet werden, um zu bestimmen, welche Operationen von Sysprep ausgeführt werden sollen, wenn ein angepasstes Windows-AMI erstellt wird, das wiederverwendet werden kann.
+ `wallpaper` – Hintergrundbild
Diese Hintergrundbilder werden in diesem Verzeichnis gespeichert.
## Telemetrie
Bei Telemetrie handelt es sich AWS um zusätzliche Informationen, die Ihnen helfen, Ihre Anforderungen besser zu verstehen, Probleme zu diagnostizieren und Funktionen bereitzustellen, mit AWS-Services denen Sie Ihr Benutzererlebnis verbessern können.
EC2Starten Sie die Version v2 `2.1.592` und erfassen Sie später Telemetriedaten wie Nutzungsmetriken und Fehler. Diese Daten werden von der Amazon EC2 EC2-Instance gesammelt, auf der EC2 Launch v2 ausgeführt wird. Dies schließt alle Windows ein, die AMIs Eigentum von AWS sind.
Die folgenden Telemetriearten werden von EC2 Launch v2 erfasst:
+ **Nutzungsinformationen** – Agent-Befehle, Installationsmethode und geplante Ausführungsfrequenz.
+ **Fehler und Diagnoseinformationen** – Agent-Installation-Fehlercodes, Ausführungs-Fehlercodes und Fehleraufrufstapel.
Beispiele für gesammelte Daten aus den Versionen 2.0.592 bis 2.1.1:
```
2025/07/18 22:38:52Z: EC2LaunchTelemetry: IsTelemetryEnabled=true
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AgentOsArch=windows_amd64
2025/07/18 22:38:52Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AgentCommandErrorCode=0
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AdminPasswordTypeCode=0
2025/07/18 22:38:52Z: EC2LaunchTelemetry: IpConflictDetectionCode=0
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AgentErrorLocation=addroutes.go:49
```
Ab Version 2.2.63 werden die Telemetriedaten des EC2-Agenten als JSON-Objekt formatiert:
```
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2" ... }
```
Die Telemetrie ist standardmäßig aktiviert. Sie können die Telemetriesammlung jederzeit deaktivieren.
**Deaktivieren der Telemetrie auf einer Instance**
Um die Telemetrie für eine einzelne Instance zu deaktivieren, können Sie entweder eine Systemumgebungsvariable festlegen oder die Installation mit dem MSI ändern.
Um Telemetrie durch Festlegen einer Systemumgebungsvariablen zu deaktivieren, führen Sie den folgenden Befehl als Administrator aus.
```
setx /M EC2LAUNCH_TELEMETRY 0
```
Um die Telemetrie mithilfe der MSI zu deaktivieren, führen Sie den folgenden Befehl aus, nachdem Sie [die MSI-Datei herunterladen](ec2launch-v2-install.md).
```
msiexec /i ".\AmazonEC2Launch.msi" Remove="Telemetry" /q
```
**Topics**
+ [EC2Konzepte der Version 2 starten](#ec2launch-v2-concepts)
+ [EC2Übersicht über die Launch v2-Aufgaben](#ec2launch-v2-tasks)
+ [EC2Starten Sie die v2-Verzeichnisstruktur](#ec2launch-v2-directory)
+ [Telemetrie](#ec2launch-v2-telemetry)
+ [Installieren Sie die neueste Version von EC2 Launch v2](ec2launch-v2-install.md)
+ [Konfigurieren Sie die EC2 Launch v2-Einstellungen für Windows-Instanzen](ec2launch-v2-settings.md)
+ [Aufgabendefinitionen für EC2 Startaufgaben von Launch v2](ec2launch-v2-task-definitions.md)
+ [Probleme mit dem EC2 Launch v2-Agenten beheben](ec2launchv2-troubleshooting.md)
+ [EC2Versionsverläufe von Launch v2](ec2launchv2-versions.md)
# Installieren Sie die neueste Version von EC2 Launch v2
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
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
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
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
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
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
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).
# Konfigurieren Sie die EC2 Launch v2-Einstellungen für Windows-Instanzen
Dieser Abschnitt enthält Informationen zur Konfiguration der Einstellungen für EC2 Launch v2.
**Topics**
+ [Ändern Sie die Einstellungen im Dialogfeld mit den EC2 Launch v2-Einstellungen](#ec2launch-v2-ui)
+ [EC2Launch v2 mit der CLI konfigurieren](#ec2launch-v2-cli)
+ [EC2Starten Sie die v2-Aufgabenkonfiguration](#ec2launch-v2-task-configuration)
+ [EC2Starten Sie v2-Exit-Codes und Neustarts](#ec2launch-v2-exit-codes-reboots)
+ [EC2Starten Sie v2 und Sysprep](#ec2launch-v2-sysprep)
## Ändern Sie die Einstellungen im Dialogfeld mit den EC2 Launch v2-Einstellungen
Im folgenden Verfahren wird beschrieben, wie Sie das Dialogfeld mit den EC2 Launch v2-Einstellungen verwenden, um Einstellungen zu aktivieren oder zu deaktivieren.
**Anmerkung**
Wenn Sie benutzerdefinierte Aufgaben in der Datei agent-config.yml falsch konfigurieren und versuchen, das Amazon EC2 Launch-Einstellungsdialogfeld zu öffnen, erhalten Sie eine Fehlermeldung. Ein Beispielschema finden Sie unter [Beispiel: `agent-config.yml`](#ec2launch-v2-example-agent-config).
1. Starten Sie die Windows-Instance und stellen Sie eine Verbindung zu ihr her.
1. **Wählen Sie im Startmenü **Alle Programme** und navigieren Sie dann zu den Starteinstellungen. EC2** Bevor Sie **Herunterfahren mit Sysprep** oder **Herunterfahren ohne Sysprep** wählen, stellen Sie sicher, dass Sie alle Änderungen speichern, die Sie während des Herunterfahrens übernehmen möchten.
![\[Anwendung der EC2-Starteinstellungen.\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/images/ec2launchv2-settings.png)
1. Auf der Registerkarte **Allgemein** des Dialogfelds **EC2Starteinstellungen** können Sie die folgenden Einstellungen aktivieren oder deaktivieren.
1. **Set Computer Name**
Wenn diese Einstellung aktiviert ist (standardmäßig deaktiviert), wird der aktuelle Hostname bei jedem Start mit dem gewünschten Host-Namen verglichen. Wenn die Host-Namen nicht übereinstimmen, wird der Host-Name zurückgesetzt, und das System wird optional neu gestartet, um den neuen Host-Namen aufzunehmen. Wenn kein benutzerdefinierter Hostname angegeben ist, wird er mithilfe der hexadezimalen IPv4 Privatadresse generiert, z. B. `ip-AC1F4E6` Um zu verhindern, dass Ihr bestehender Hostname geändert wird, aktivieren Sie diese Einstellung nicht.
1. **Extend Boot Volume (Erweitern des Start-Volumes)**
Diese Einstellung erweitert Festplatte `Disk 0`/`Volume 0` dynamisch so, dass der gesamte nicht partitionierte Speicherplatz eingeschlossen ist. Dies ist nützlich, wenn die Instance von einem Root-Volume gestartet wird, das eine benutzerdefinierte Größe hat.
1. **Set Administrator Account (Festlegen des Administratorkontos)**
Wenn diese Option aktiviert ist, können Sie die Attribute „Username (Benutzername)“ und „Password (Passwort)“ für das Administratorkonto festlegen, das auf Ihrem lokalen Computer erstellt wird. Wenn dieses Feature nicht aktiviert ist, wird auf dem System nach Sysprep kein Administratorkonto erstellt. Geben Sie in `adminPassword` nur dann ein Passwort an, wenn `adminPasswordtype` `Specify` ist.
Die Passworttypen sind wie folgt definiert:
1. `Random`
EC2Launch generiert ein Passwort und verschlüsselt es mit dem Schlüssel des Benutzers. Die Einstellung wird vom System nach dem Start der Instance deaktiviert, so dass das Passwort weiterhin gilt, wenn die Instance neu gestartet bzw. angehalten und gestartet wird.
1. `Specify`
EC2Launch verwendet das Passwort, das Sie unter angeben. `adminPassword` Wenn das Passwort nicht den Systemanforderungen entspricht, generiert EC2 Launch stattdessen ein zufälliges Passwort. Das Passwort wird in `agent-config.yml` im Klartext gespeichert und gelöscht, wenn Sysprep das Administratorpasswort einstellt. EC2Launch verschlüsselt das Passwort mit dem Schlüssel des Benutzers.
1. `Do not set`
EC2Launch verwendet das Passwort, das Sie in der Datei unattend.xml angeben. Wenn Sie in der Datei unattend.xml kein Passwort angeben, ist das Administratorkonto deaktiviert.
1. **Start SSM Service (Starten des SSM-Services)**
Wenn diese Option ausgewählt ist, ist der Systems Manager Manager-Dienst so aktiviert, dass er Sysprep folgt. EC2Launch v2 führt alle [zuvor](ec2launch-v2.md#ec2launch-v2-tasks) beschriebenen Aufgaben aus, und der SSM-Agent verarbeitet Anfragen für Systems Manager Manager-Funktionen wie Run Command und State Manager.
Sie können Run Command verwenden, um Ihre vorhandenen Instances auf die neueste Version des EC2 Launch v2-Dienstes und des SSM-Agenten zu aktualisieren. Weitere Informationen finden Sie unter [Aktualisieren des SSM-Agent mit Run Command](https://docs.aws.amazon.com/systems-manager/latest/userguide/run-command-tutorial-update-software.html) im *Benutzerhandbuch für AWS Systems Manager*.
1. **Optimize ENA (Optimieren von ENA)**
Wenn diese Option ausgewählt ist, werden die ENA-Einstellungen so konfiguriert, dass die ENA-Einstellungen für AWS Receive Side Scaling und Receive Queue Depth optimiert sind. Weitere Informationen finden Sie unter [Konfiguration der CPU-Affinität für empfangsseitige Skalierung](enhanced-networking-os.md#windows-rss-cpu-affinity).
1. **Enable SSH (Aktivieren von SSH)**
Diese Einstellung aktiviert OpenSSH für spätere Windows-Versionen, um die Remote-Systemverwaltung zu ermöglichen.
1. **Enable Jumbo Frames (Aktivieren von Jumbo Frames)**
Wählen Sie diese Option aus, um Jumbo Frames zu aktivieren. Jumbo Frames können unbeabsichtigte Auswirkungen auf Ihre Netzwerkkommunikation haben. Stellen Sie also sicher, dass Sie wissen, wie sich Jumbo Frames auf Ihr System auswirken, bevor Sie diese aktivieren. Weitere Informationen zu Jumbo Frames finden Sie unter [Jumbo-Frames (9001 MTU)](network_mtu.md#jumbo_frame_instances).
1. **Prepare for Imaging (Vorbereitung zum Imaging)**
Wählen Sie aus, ob Ihre EC2-Instance mit oder ohne Sysprep heruntergefahren werden soll. Wenn Sie Sysprep mit EC2 Launch v2 ausführen möchten, wählen Sie **Shutdown with** Sysprep.
1. Auf der Registerkarte **DNS Suffix** (DNS-Suffix) können Sie auswählen, ob Sie eine DNS-Suffixliste für die DNS-Auflösung von Servern mit EC2 hinzufügen möchten, ohne den vollqualifizierten Domain-Namen anzugeben. DNS-Suffixe können die Variablen `$REGION` und `$AZ` enthalten. Nur Suffixe, die noch nicht vorhanden sind, werden der Liste hinzugefügt.
![\[Anwendung der EC2-Starteinstellungen.\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/images/ec2launchv2-dns.png)
1. Auf der Registerkarte **Hintergrundbild** können Sie Ihr Instance-Hintergrundbild mit einem Hintergrundbild konfigurieren und Instance-Details für das anzuzeigende Hintergrundbild angeben. Amazon EC2 generiert die Details bei jeder Anmeldung.
Sie können Ihr Hintergrundbild mit den folgenden Steuerelementen konfigurieren.
+ **Instance-Details auf dem Hintergrundbild anzeigen** – Dieses Kontrollkästchen aktiviert oder deaktiviert die Anzeige von Instance-Details auf dem Hintergrundbild.
+ **Image-Pfad (.jpg)** – Geben Sie den Pfad zu dem Image an, das als Hintergrundhintergrund verwendet werden soll.
+ **Auf Hintergrund anzuzeigende Attribute auswählen** – Aktivieren Sie die Kontrollkästchen für die Instance-Details, die auf dem Hintergrund angezeigt werden sollen. Deaktivieren Sie die Kontrollkästchen für zuvor ausgewählte Instance-Details, die Sie aus dem Hintergrundbild entfernen möchten.
+ **Instance-Tags auf Hintergrundbild anzeigen** – Wählen Sie eine der folgenden Einstellungen aus, um Instance-Tags auf dem Hintergrundbild anzuzeigen:
+ **Keine** – Keine Instance-Tags auf dem Hintergrundbild anzeigen.
+ **Alles anzeigen** – Alle Instance-Tags auf dem Hintergrund anzeigen.
+ **Gefiltert anzeigen** – Angegebene Instance-Tags auf dem Hintergrundbild anzeigen. Wenn Sie diese Einstellung wählen, können Sie die Instance-Tags, die Sie auf Ihrem Hintergrundbild anzeigen möchten, zum Feld **Instance-Tag-Filter** hinzufügem.
**Anmerkung**
Sie müssen Tags in Metadaten aktivieren, um Tags auf dem Hintergrundbild anzuzeigen. Weitere Informationen zu Instance-Tags und Metadaten finden Sie unter [Tags für Ihre EC2-Instances mithilfe von Instance-Metadaten anzeigen](work-with-tags-in-IMDS.md).
![\[EC2-Starteinstellungen, Registerkarte „Hintergrundbild“.\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/images/ec2launchv2-wallpaper-02.png)
1. Wählen Sie auf der Registerkarte **Volumes** aus, ob Sie die Volumes initialisieren möchten, die der Instance angefügt sind. Durch die Aktivierung werden Laufwerkbuchstaben für zusätzliche Volumes festgelegt und diese erweitert, um verfügbaren Speicherplatz zu nutzen. Wenn Sie **All (Alle)** auswählen, werden alle Speicher-Volumes initialisiert. Wenn Sie **Devices (Geräte)** auswählen, werden nur Geräte initialisiert, die in der Liste angegeben sind. Sie müssen jedes zu initialisierende Gerät eingeben. Verwenden Sie beispielsweise die Geräte, die auf der EC2-Konsole aufgeführt sind, `xvdb` oder `/dev/nvme0n1`. In der Dropdown-Liste werden die Speicher-Volumes angezeigt, die der Instance zugeordnet sind. Um ein Gerät einzugeben, das nicht an die Instance angefügt ist, geben Sie es in das Textfeld ein.
**Name**, **Letter (Buchstabe)** und **Partition** sind optionale Felder. Wenn für **Partition** kein Wert angegeben wird, werden Speichermedien, die größer als 2 TB sind, mit dem Partitionstyp `gpt` initialisiert, und solche, die kleiner als 2 TB sind, mit dem Partitionstyp `mbr` initialisiert. Wenn Geräte konfiguriert sind und ein Nicht-NTFS-Gerät entweder eine Partitionstabelle enthält oder die ersten 4 KB des Datenträgers Daten enthalten, wird der Datenträger übersprungen und die Aktion protokolliert.
![\[Anwendung der EC2-Starteinstellungen.\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/images/ec2launchv2-volumes.png)
## EC2Launch v2 mit der CLI konfigurieren
Sie können die Befehlszeilenschnittstelle (CLI) verwenden, um Ihre EC2 Starteinstellungen zu konfigurieren und den Dienst zu verwalten. Der folgende Abschnitt enthält Beschreibungen und Nutzungsinformationen für die CLI-Befehle, mit denen Sie EC2 Launch v2 verwalten können.
**Topics**
+ [collect-logs](#ec2launch-v2-collect-logs)
+ [get-agent-config](#ec2launch-v2-get-agent-config)
+ [list-Volumes](#ec2launch-v2-list-volumes)
+ [reset](#ec2launch-v2-reset)
+ [run](#ec2launch-v2-run)
+ [Status](#ec2launch-v2-settings-status)
+ [sysprep](#ec2launch-v2-settings-sysprep)
+ [validieren](#ec2launch-v2-validate)
+ [version](#ec2launch-v2-version)
+ [Hintergrundbild](#ec2launch-v2-wallpaper)
### collect-logs
Sammelt Protokolldateien für EC2 Launch, komprimiert die Dateien und platziert sie in einem angegebenen Verzeichnis.
**Beispiel**
```
ec2launch collect-logs -o C:\Mylogs.zip
```
**Usage**
`ec2launch collect-logs [flags]`
**Flags**
`-h`, `--help`
Hilfe für `collect-logs`
`-o`, `--output string`
Pfad zu komprimierten Ausgabe-Protokolldateien
### get-agent-config
Druckt `agent-config.yml` im angegebenen Format (JSON oder YAML). Wenn kein Format angegeben ist, wird `agent-config.yml` in dem zuvor angegebenen Format gedruckt.
**Beispiel**
```
ec2launch get-agent-config -f json
```
**Usage**
`ec2launch get-agent-config [flags]`
**Flags**
`-h`, `--help`
Hilfe für `get-agent-config`
`-f`, `--format string`
Ausgabeformat der `agent-config`-Datei: `json`, `yaml`
### list-Volumes
Listet alle Speicher-Volumes auf, die der Instance zugeordnet sind, einschließlich flüchtiger und EBS-Volumes.
**Beispiel**
```
ec2launch list-volumes
```
**Usage**
`ec2launch list-volumes`
**Flags**
`-h`, `--help`
Hilfe für `list-volumes`
### reset
Das Hauptziel dieser Aufgabe besteht darin, den Agenten für die nächste Ausführung zurückzusetzen. Zu diesem Zweck löscht der **reset** Befehl alle Agentenstatusdaten für EC2 Launch v2 aus dem lokalen `EC2Launch` Verzeichnis (siehe[EC2Starten Sie die v2-Verzeichnisstruktur](ec2launch-v2.md#ec2launch-v2-directory)). Beim Zurücksetzen werden optional die Service- und Sysprep-Protokolle gelöscht.
Das Verhalten des Skripts hängt davon ab, in welchem Modus der Agent die Skripte ausführt – inline oder getrennt.
Inline (Standard)
Der EC2 Launch v2-Agent führt die Skripts nacheinander aus (`detach: false`). Dies ist die Standardeinstellung.
Wenn Ihr Inline-Skript einen **reset**- oder **sysprep**-Befehl ausgibt, wird es sofort ausgeführt und setzt den Agenten zurück. Die aktuelle Aufgabe wird beendet, dann wird der Agent heruntergefahren, ohne weitere Aufgaben auszuführen.
Wenn beispielsweise auf die Aufgabe, die den Befehl ausgibt, eine `startSsm`-Aufgabe folgen würde (die standardmäßig nach der Ausführung der Benutzerdaten enthalten ist), wird die Aufgabe nicht ausgeführt und der Systems-Manager-Service nicht gestartet.
Detached (Getrennt)
Der EC2 Launch v2-Agent führt Skripts gleichzeitig mit anderen Aufgaben aus (`detach: true`).
Wenn Ihr abgetrenntes Skript einen **reset**- oder **sysprep**-Befehl ausgibt, warten diese Befehle, bis der Agent fertig ist, bevor sie ausgeführt werden. Aufgaben nach dem executeScript werden weiterhin ausgeführt.
**Beispiel**
```
ec2launch reset -c
```
**Usage**
`ec2launch reset [flags]`
**Flags**
`-c`, `--clean`
bereinigt Instance-Protokolle vor `reset`
`-h`, `--help`
Hilfe für `reset`
### run
Führt EC2 Launch v2 aus.
**Beispiel**
```
ec2launch run
```
**Usage**
`ec2launch run [flags]`
**Flags**
`-h`, `--help`
Hilfe für `run`
### Status
Ruft den Status des EC2 Launch v2-Agenten ab. Blockiert optional den Prozess, bis der Agent beendet ist. Der Prozess-Beendigungscode bestimmt den Agentenstatus:
+ `0` – der Agent wurde ausgeführt und war erfolgreich.
+ `1` – der Agent wurde ausgeführt und ist fehlgeschlagen.
+ `2` – der Agent wird noch ausgeführt.
+ `3` – der Agent befindet sich in einem unbekannten Status. Der Agentenstatus wird nicht ausgeführt oder ist beendet.
+ `4` – beim Versuch, den Agentenstatus abzurufen, ist ein Fehler aufgetreten.
+ `5` – der Agent wird nicht ausgeführt und der Status der letzten bekannten Ausführung ist unbekannt. Dies könnte eines der folgenden bedeuten:
+ Sowohl `state.json` und `previous-state.json` werden gelöscht.
+ `previous-state.json` ist beschädigt.
Dies ist der Agentenstatus nach dem Ausführen des [`reset`](#ec2launch-v2-reset)-Befehls.
**Beispiel:**
```
ec2launch status -b
```
**Usage**
`ec2launch status [flags]`
**Flags**
`-b`,`--block`
blockiert den Prozess, bis die Ausführung des Agenten beendet ist
`-h`,`--help`
Hilfe für `status`
### sysprep
Das Hauptziel dieser Aufgabe besteht darin, den Agenten für die nächste Ausführung zurückzusetzen. Dazu setzt der **sysprep**-Befehl den Agentenstatus zurück, aktualisiert die `unattend.xml`-Datei, deaktiviert RDP und führt Sysprep aus.
Das Verhalten des Skripts hängt davon ab, in welchem Modus der Agent die Skripte ausführt – inline oder getrennt.
Inline (Standard)
Der EC2 Launch v2-Agent führt Skripts nacheinander aus (`detach: false`). Dies ist die Standardeinstellung.
Wenn Ihr Inline-Skript einen **reset**- oder **sysprep**-Befehl ausgibt, wird es sofort ausgeführt und setzt den Agenten zurück. Die aktuelle Aufgabe wird beendet, dann wird der Agent heruntergefahren, ohne weitere Aufgaben auszuführen.
Wenn beispielsweise auf die Aufgabe, die den Befehl ausgibt, eine `startSsm`-Aufgabe folgen würde (die standardmäßig nach der Ausführung der Benutzerdaten enthalten ist), wird die Aufgabe nicht ausgeführt und der Systems-Manager-Service nicht gestartet.
Detached (Getrennt)
Der EC2 Launch v2-Agent führt Skripts gleichzeitig mit anderen Aufgaben aus (`detach: true`).
Wenn Ihr abgetrenntes Skript einen **reset**- oder **sysprep**-Befehl ausgibt, warten diese Befehle, bis der Agent fertig ist, bevor sie ausgeführt werden. Aufgaben nach dem executeScript werden weiterhin ausgeführt.
**Beispiel:**
```
ec2launch sysprep
```
**Usage**
`ec2launch sysprep [flags]`
**Flags**
`-c`,`--clean`
bereinigt Instance-Protokolle vor `sysprep`
`-h`,`--help`
Hilfe für Sysprep
`-s`,`--shutdown`
fährt die Instance nach `sysprep` herunter
### validieren
Validiert die `agent-config`-Datei `C:\ProgramData\Amazon\EC2Launch\config\agent-config.yml`.
**Beispiel**
```
ec2launch validate
```
**Usage**
`ec2launch validate [flags]`
**Flags**
-h` `, `--help`
Hilfe für `validate`
### version
Ruft die ausführbare Version ab.
**Beispiel**
```
ec2launch version
```
**Usage**
`ec2launch version [flags]`
**Flags**
`-h`, `--help`
Hilfe für `version`
### Hintergrundbild
Legt das bereitgestellte Hintergrundbild für den Hintergrundbildpfad fest (JPG-Datei) und zeigt die ausgewählten Instance-Details an.
#### Syntax
```
ec2launch wallpaper ^
--path="C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg" ^
--all-tags ^
--attributes=hostName,instanceId,privateIpAddress,publicIpAddress,ipv6Address,instanceSize,availabilityZone,architecture
```
#### Eingaben
Parameters
**--allowed-tags [,] *tag-name-1* *tag-name-n***
(Optional) Base64-codiertes JSON-Array von Instance-Tag-Namen zur Anzeige auf dem Hintergrundbild. Sie können dieses Tag oder das `--all-tags` verwenden, aber nicht beides.
**--Attribute*attribute-string-1*, *attribute-string-n***
(Optional) Eine durch Kommas getrennte Liste von `wallpaper`-Attributzeichenfolgen zum Anwenden von Einstellungen auf das Hintergrundbild.
**[--Pfad \$1 -p] *path-string***
(Erforderlich) Gibt den `wallpaper`-Dateipfad für das Hintergrundbild an.Flags
**--all-tags**
(Optional) Zeigt alle Instance-Tags auf dem Hintergrund an. Sie können dieses Tag oder das `--allowed-tags` verwenden, aber nicht beides.
**[--help \$1 -h]**
Zeigt Hilfe für den **wallpaper**-Befehl an.
## EC2Starten Sie die v2-Aufgabenkonfiguration
Dieser Abschnitt enthält das Konfigurationsschema, Aufgaben, Details und Beispiele für `agent-config.yml` und Benutzerdaten.
**Topics**
+ [Schema: `agent-config.yml`](#ec2launch-v2-schema-agent-config)
+ [Konfigurieren Sie EC2 Launch v2-Benutzerdatenskripts, die beim Start oder Neustart ausgeführt werden](#ec2launch-v2-schema-user-data)
### Schema: `agent-config.yml`
Die Struktur der `agent-config.yml`-Datei wird unten gezeigt. Beachten Sie, dass eine Aufgabe nicht in derselben Phase wiederholt werden kann. Informationen zu den Aufgabeneigenschaften finden Sie in den folgenden Aufgabenbeschreibungen.
#### Dokumentstruktur: agent-config.yml
**JSON**
```
{
"version": "1.1",
"config": [
{
"stage": "string",
"tasks": [
{
"task": "string",
"inputs": {
...
}
},
...
]
},
...
]
}
```
**YAML**
```
version: 1.1
config:
- stage: string
tasks:
- task: string
inputs:
...
...
...
```
#### Beispiel: `agent-config.yml`
Das folgende Beispiel zeigt die Einstellungen für die `agent-config.yml`-Konfigurationsdatei.
```
version: 1.1
config:
- stage: boot
tasks:
- task: extendRootPartition
- stage: preReady
tasks:
- task: activateWindows
inputs:
activation:
type: amazon
- task: setDnsSuffix
inputs:
suffixes:
- $REGION.ec2-utilities.amazonaws.com
- task: setAdminAccount
inputs:
password:
type: random
- task: setWallpaper
inputs:
path: C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg
attributes:
- hostName
- instanceId
- privateIpAddress
- publicIpAddress
- instanceSize
- availabilityZone
- architecture
- stage: postReady
tasks:
- task: startSsm
```
### Konfigurieren Sie EC2 Launch v2-Benutzerdatenskripts, die beim Start oder Neustart ausgeführt werden
Die folgenden JSON- und YAML-Beispiele zeigen die Dokumentstruktur für Benutzerdaten. Amazon EC2 analysiert jede Aufgabe, die im `tasks`-Array genannt wird, das Sie im Dokument angeben. Jede Aufgabe hat ihre eigenen Eigenschaften und Anforderungen. Einzelheiten finden Sie im [Aufgabendefinitionen für EC2 Startaufgaben von Launch v2](ec2launch-v2-task-definitions.md).
**Anmerkung**
Eine Aufgabe darf nur einmal im Array mit Benutzerdatenaufgaben vorkommen.
#### Dokumentenstruktur: Benutzerdaten
**JSON**
```
{
"version": "1.1",
"tasks": [
{
"task": "string",
"inputs": {
...
},
},
...
]
}
```
**YAML**
```
version: 1.1
tasks:
- task: string
inputs:
...
...
```
#### Beispiel: Benutzerdaten
Weitere Informationen zu Benutzerrollen finden Sie unter [So verarbeitet Amazon EC2 Benutzerdaten für Linux-Instances](user-data.md#ec2-windows-user-data).
Das folgende Beispiel für ein YAML-Dokument zeigt ein PowerShell Skript, das EC2 Launch v2 als Benutzerdaten ausführt, um eine Datei zu erstellen.
```
version: 1.1
tasks:
- task: executeScript
inputs:
- frequency: always
type: powershell
runAs: localSystem
content: |-
New-Item -Path 'C:\PowerShellTest.txt' -ItemType File
```
Sie können ein XML-Format für die Benutzerdaten verwenden, das mit früheren Versionen des Launch-Agents kompatibel ist. EC2Launch v2 führt das Skript als `executeScript` Aufgabe in der `UserData` Phase aus. Um dem Verhalten von EC2 Launch v1 und EC2 Config zu entsprechen, wird das Benutzerdatenskript standardmäßig als attached/inline Prozess ausgeführt.
Sie können optionale Tags hinzufügen, um die Ausführung Ihres Skripts anzupassen. Um beispielsweise das Benutzerdatenskript beim Neustart der Instance zusätzlich zum einmaligen Starten der Instance auszuführen, können Sie das folgende Tag verwenden:
`true`
**Beispiel:**
```
$file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
true
```
Sie können ein oder mehrere PowerShell Argumente mit dem `` Tag angeben. Wenn keine Argumente übergeben werden, fügt EC2 Launch v2 standardmäßig das folgende Argument hinzu:`-ExecutionPolicy Unrestricted`.
**Beispiel:**
```
$file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
-ExecutionPolicy Unrestricted -NoProfile -NonInteractive
```
Um ein XML-Benutzerdatenskript als getrennten Prozess auszuführen, fügen Sie Ihren Benutzerdaten das folgende Tag hinzu.
`true`
**Beispiel:**
```
$file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
true
```
**Anmerkung**
Das Abtrennungs-Tag wird auf früheren Startagenten nicht unterstützt.
#### Änderungsprotokoll: Benutzerdaten
In der folgenden Tabelle sind die Änderungen an den Benutzerdaten aufgeführt und sie werden mit der jeweils geltenden EC2 Launch v2-Agentenversion verglichen.
| Benutzerdatenversion | Details | Eingeführt in |
| --- | --- | --- |
| 1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launch-v2-settings.html) | EC2Starten Sie v2-Version 2.0.1245 |
| 1,0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launch-v2-settings.html) | EC2Starten Sie Version 2.0.0 der Version v2 |
\$1 Bei Verwendung mit der `agent-config.yml`-Standarddatei.
## EC2Starten Sie v2-Exit-Codes und Neustarts
Sie können EC2 Launch v2 verwenden, um zu definieren, wie Exit-Codes von Ihren Skripten behandelt werden. Standardmäßig wird der Beendigungscode des letzten in einem Skript ausgeführten Befehls als Beendigungscode für das gesamte Skript gemeldet. Wenn ein Skript beispielsweise drei Befehle enthält und der erste Befehl fehlschlägt, aber die folgenden erfolgreich sind, wird der Ausführungsstatus als `success` gemeldet, da der endgültige Befehl erfolgreich war.
Wenn Sie möchten, dass ein Skript eine Instanz neu startet, müssen Sie dies `exit 3010` in Ihrem Skript angeben, auch wenn der Neustart der letzte Schritt in Ihrem Skript ist. `exit 3010`weist EC2 Launch v2 an, die Instanz neu zu starten und das Skript erneut aufzurufen, bis es einen Exit-Code zurückgibt, der dies nicht ist`3010`, oder bis die maximale Anzahl von Neustarts erreicht ist. EC2Launch v2 erlaubt maximal 5 Neustarts pro Aufgabe. Wenn Sie versuchen, eine Instance aus einem Skript mit einem anderen Mechanismus wie `Restart-Computer` neu zu starten, ist der Skriptausführungsstatus inkonsistent. Er kann beispielsweise in einer Neustartschleife stecken bleiben oder den Neustart nicht durchführen.
Wenn Sie ein XML-Benutzerdatenformat verwenden, das mit älteren Agenten kompatibel ist, werden die Benutzerdaten möglicherweise öfter ausgeführt, als Sie beabsichtigen. Weitere Informationen finden Sie im Abschnitt zur Fehlerbehebung unter [Der Service führt Benutzerdaten mehr als einmal aus](ec2launchv2-troubleshooting.md#ec2launchv2-troubleshooting-user-data-more-than-once).
## EC2Starten Sie v2 und Sysprep
Der EC2 Launch v2-Dienst führt Sysprep aus, ein Microsoft-Tool, mit dem Sie ein benutzerdefiniertes Windows-AMI erstellen können, das wiederverwendet werden kann. Wenn EC2 Launch v2 Sysprep aufruft, bestimmt er anhand der Dateien, welche Operationen ausgeführt `%ProgramData%\Amazon\EC2Launch` werden sollen. Sie können diese Dateien indirekt über das Dialogfeld mit den **EC2Starteinstellungen** oder direkt mit einem YAML-Editor oder einem Texteditor bearbeiten. Es gibt jedoch einige erweiterte Einstellungen, die im Dialogfeld mit den **EC2Starteinstellungen** nicht verfügbar sind, sodass Sie diese Einträge direkt bearbeiten müssen.
Wenn Sie ein AMI aus einer Instance erstellen, nachdem Sie deren Einstellungen aktualisiert haben, werden die neuen Einstellungen auf alle Instances angewandt, die von diesem AMI gestartet werden. Weitere Informationen über die Erstellung eines AMI finden Sie unter [Ein Amazon-EBS-gestütztes AMI erstellen](creating-an-ami-ebs.md).
# Aufgabendefinitionen für EC2 Startaufgaben von Launch v2
Jede Aufgabe, die EC2 Launch v2 während des Starts oder Starts ausführt, hat ihre eigenen Eigenschaften und Anforderungen. Zu den Aufgabendetails gehören Einstellungen dafür, wie oft eine Aufgabe ausgeführt wird – einmal oder immer – , in welcher Phase des Startvorgangs des Agenten sie ausgeführt wird, Syntax und Beispiele für YAML-Dokumente. Weitere Informationen finden Sie in den Aufgabendetails in dieser Referenz.
**Topics**
+ [activateWindows](#ec2launch-v2-activatewindows)
+ [enableJumboFrames](#ec2launch-v2-enablejumboframes)
+ [enableOpenSsh](#ec2launch-v2-enableopenssh)
+ [executeProgram](#ec2launch-v2-executeprogram)
+ [executeScript](#ec2launch-v2-executescript)
+ [extendRootPartition](#ec2launch-v2-extendrootpartition)
+ [initializeVolume](#ec2launch-v2-initializevolume)
+ [optimizeEna](#ec2launch-v2-optimizeena)
+ [setAdminAccount](#ec2launch-v2-setadminaccount)
+ [setDnsSuffix](#ec2launch-v2-setdnssuffix)
+ [setHostName](#ec2launch-v2-sethostname)
+ [setWallpaper](#ec2launch-v2-setwallpaper)
+ [startSsm](#ec2launch-v2-startssm)
+ [sysprep](#ec2launch-v2-task-sysprep)
+ [writeFile](#ec2-launch-v2-writefile)
## activateWindows
Aktiviert Windows für eine Reihe von AWS KMS Servern. Die Aktivierung wird übersprungen, wenn die Instanz als Bring-Your-Own-License (BYOL) erkannt wird.
*Häufigkeit* - einmal
*AllowedStages* — `[PreReady]`
*Eingaben* —
`activation`: (Zuordnung)
`type`: (Zeichenfolge) Aktivierungstyp, der verwendet werden soll, auf `amazon` gesetzt
*Beispiel*
```
task: activateWindows
inputs:
activation:
type: amazon
```
## enableJumboFrames
Aktiviert Jumbo Frames, die die Maximum Transmission Unit (MTU) des Netzwerkadapters erhöhen. Weitere Informationen finden Sie unter [Jumbo-Frames (9001 MTU)](network_mtu.md#jumbo_frame_instances).
*Häufigkeit* — immer
*AllowedStages* — `[PostReady, UserData]`
*Eingaben* — keine
*Beispiel*
```
task: enableJumboFrames
```
## enableOpenSsh
Aktiviert Windows OpenSSH und fügt den öffentlichen Schlüssel für die Instance dem Ordner für autorisierte Schlüssel hinzu.
*Häufigkeit* - einmal
*AllowedStages* — `[PreReady, UserData]`
*Eingaben* — keine
*Beispiel*
Im folgenden Beispiel wird gezeigt, wie OpenSSH für eine Instance aktiviert und der öffentliche Schlüssel für die Instance dem Ordner für autorisierte Schlüssel hinzugefügt wird. Diese Konfiguration funktioniert nur auf Instances, auf denen Windows Server 2019 ausgeführt wird.
```
task: enableOpenSsh
```
## executeProgram
Führt ein Programm mit optionalen Argumenten und einer angegebenen Häufigkeit aus.
**Phasen:** Sie können die Aufgabe `executeProgram` während der Phasen `PreReady`, `PostReady` und `UserData` ausführen.
**Frequenz:** konfigurierbar, siehe *Eingänge*.
**Eingaben**
Dieser Abschnitt enthält ein oder mehrere Programme, mit denen die **executeProgram**-Aufgabe ausgeführt werden kann (Eingaben). Jede Eingabe kann die folgenden konfigurierbaren Einstellungen enthalten:
**Frequenz (Zeichenfolge)**
(Erforderlich) Geben Sie genau einen der folgenden Werte an:
+ `once`
+ `always`
**Pfad (Zeichenfolge)**
(Erforderlich) Der Dateipfad für die auszuführende Datei.
**Argumente (Liste von Zeichenfolgen)**
(Optional) Eine durch Kommas getrennte Liste von Argumenten, die dem Programm als Eingabe zur Verfügung gestellt werden sollen.
**runAs (Zeichenfolge)**
(Erforderlich) Muss auf `localSystem` gesetzt sein
**Ausgabe**
Alle Aufgaben schreiben Logfile-Einträge in die `agent.log`-Datei. Zusätzliche Ausgaben der Aufgabe `executeProgram` werden wie folgt separat in einem dynamisch benannten Ordner gespeichert:
`%LocalAppData%\Temp\EC2Launch#########\outputfilename.tmp`
Der genaue Pfad zu den Ausgabedateien ist in der `agent.log`-Datei enthalten, zum Beispiel:
```
Program file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\ExecuteProgramInputs.tmp
Output file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Output.tmp
Error file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Err.tmp
```
**Ausgabedateien für die Aufgabe `executeProgram`**
`ExecuteProgramInputs.tmp`
Enthält den Pfad für die ausführbare Datei und alle Eingabeparameter, die die Aufgabe `executeProgram` bei der Ausführung an sie übergibt.
`Output.tmp`
Enthält die Laufzeitausgabe des Programms, das die Aufgabe `executeProgram` ausführt.
`Err.tmp`
Enthält die Laufzeit-Fehlermeldungen des Programms, das die Aufgabe `executeProgram` ausführt.
**Beispiele**
Die folgenden Beispiele zeigen, wie eine ausführbare Datei aus einem lokalen Verzeichnis auf einer Instance mit der Aufgabe `executeProgram` ausgeführt wird.
**Beispiel 1: Setup Executable mit einem Argument**
Dieses Beispiel zeigt eine `executeProgram`-Aufgabe, die eine Setup Executable im Modus „Quiet“ ausführt.
```
task: executeProgram
inputs:
- frequency: always
path: C:\Users\Administrator\Desktop\setup.exe
arguments: ['-quiet']
```
**Beispiel 2: VLC-Executable mit zwei Argumenten**
Dieses Beispiel zeigt eine `executeProgram`-Aufgabe, die eine VLC-Executable-Datei mit zwei als Eingabeparameter übergebenen Argumenten ausführt.
```
task: executeProgram
inputs:
- frequency: always
path: C:\vlc-3.0.11-win64.exe
arguments: ['/L=1033','/S']
runAs: localSystem
```
## executeScript
Führt ein Skript mit optionalen Argumenten und einer angegebenen Häufigkeit aus. Das Verhalten des Skripts hängt davon ab, in welchem Modus der Agent die Skripte ausführt – inline oder getrennt.
Inline (Standard)
Der EC2 Launch v2-Agent führt die Skripts nacheinander aus ()`detach: false`. Dies ist die Standardeinstellung.
Wenn Ihr Inline-Skript einen **reset**- oder **sysprep**-Befehl ausgibt, wird es sofort ausgeführt und setzt den Agenten zurück. Die aktuelle Aufgabe wird beendet, dann wird der Agent heruntergefahren, ohne weitere Aufgaben auszuführen.
Wenn beispielsweise auf die Aufgabe, die den Befehl ausgibt, eine `startSsm`-Aufgabe folgen würde (die standardmäßig nach der Ausführung der Benutzerdaten enthalten ist), wird die Aufgabe nicht ausgeführt und der Systems-Manager-Service nicht gestartet.
Detached (Getrennt)
Der EC2 Launch v2-Agent führt Skripts gleichzeitig mit anderen Aufgaben aus (`detach: true`).
Wenn Ihr abgetrenntes Skript einen **reset**- oder **sysprep**-Befehl ausgibt, warten diese Befehle, bis der Agent fertig ist, bevor sie ausgeführt werden. Aufgaben nach dem executeScript werden weiterhin ausgeführt.
**Phasen:** Sie können die Aufgabe `executeScript` während der Phasen `PreReady`, `PostReady` und `UserData` ausführen.
**Frequenz:** konfigurierbar, siehe *Eingänge*.
**Eingaben**
Dieser Abschnitt enthält ein oder mehrere Skripte, mit denen die **executeScript**-Aufgabe ausgeführt werden kann (Eingaben). Jede Eingabe kann die folgenden konfigurierbaren Einstellungen enthalten:
**Frequenz (Zeichenfolge)**
(Erforderlich) Geben Sie genau einen der folgenden Werte an:
+ `once`
+ `always`
**Typ (Zeichenfolge)**
(Erforderlich) Geben Sie genau einen der folgenden Werte an:
+ `batch`
+ `powershell`
**Argumente (Liste von Zeichenfolgen)**
(Optional) Eine Liste von Zeichenkettenargumenten, die an die Shell (nicht an das PowerShell Skript) übergeben werden sollen. Dieser Parameter wird nicht für `type: batch` unterstützt. Wenn keine Argumente übergeben werden, fügt EC2 Launch v2 standardmäßig das folgende Argument hinzu:`-ExecutionPolicy Unrestricted`.
**Inhalt (Zeichenfolge)**
(Erforderlich) Skriptinhalt.
**runAs (Zeichenfolge)**
(Erforderlich) Geben Sie genau einen der folgenden Werte an:
+ `admin`
+ `localSystem`
**trennen (Boolean)**
(Optional) Der EC2 Launch v2-Agent führt standardmäßig Skripts nacheinander aus (`detach: false`). Um das Skript gleichzeitig mit anderen Aufgaben auszuführen, setzen Sie den Wert auf `true` (`detach: true`).
Skript-Exitcodes (einschließlich `3010`) haben keine Wirkung, wenn `detach` auf `true` festgelegt wird.
**Ausgabe**
Alle Aufgaben schreiben Logfile-Einträge in die `agent.log`-Datei. Zusätzliche Ausgaben von Skripten, die die Aufgabe `executeScript` ausführt, werden wie folgt separat in einem dynamisch benannten Ordner gespeichert:
`%LocalAppData%\Temp\EC2Launch#########\outputfilename.ext`
Der genaue Pfad zu den Ausgabedateien ist in der `agent.log`-Datei enthalten, zum Beispiel:
```
Program file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\UserScript.ps1
Output file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Output.tmp
Error file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Err.tmp
```
**Ausgabedateien für die Aufgabe `executeScript`**
`UserScript.ext`
Enthält das Skript, das die Aufgabe `executeScript` ausgeführt hat. Die Dateierweiterung hängt wie folgt von der Art des Skripts ab, das Sie im `type`-Parameter für die `executeScript`-Aufgabe angegeben haben:
+ Wenn der Typ `batch` ist, dann ist die Dateierweiterung `.bat`.
+ Wenn der Typ `powershell` ist, dann ist die Dateierweiterung `.ps1`.
`Output.tmp`
Enthält die Laufzeitausgabe des Skripts, das die Aufgabe `executeScript` ausführt.
`Err.tmp`
Enthält die Laufzeit-Fehlermeldungen des Skripts, das die Aufgabe `executeScript` ausführt.
**Beispiele**
Die folgenden Beispiele zeigen, wie Sie ein Inline-Skript mit der Aufgabe `executeScript` ausführen.
**Beispiel 1: Hello World Ausgabetextdatei**
Dieses Beispiel zeigt eine `executeScript` Aufgabe, die ein PowerShell Skript ausführt, um eine „Hello World“ -Textdatei auf dem `C:` Laufwerk zu erstellen.
```
task: executeScript
inputs:
- frequency: always
type: powershell
runAs: admin
content: |-
New-Item -Path 'C:\PowerShellTest.txt' -ItemType File
Set-Content 'C:\PowerShellTest.txt' "Hello world"
```
**Beispiel 2: Zwei Skripts ausführen**
Dieses Beispiel zeigt, dass die Aufgabe `executeScript` mehr als ein Skript ausführen kann und der Skripttyp nicht unbedingt übereinstimmen muss.
Das erste Skript (`type: powershell`) schreibt eine Zusammenfassung der Prozesse, die derzeit auf der Instance ausgeführt werden, in eine Textdatei auf dem `C:`-Laufwerk.
Das zweite Skript (`batch`) schreibt die Systeminformationen in die `Output.tmp`-Datei.
```
task: executeScript
inputs:
- frequency: always
type: powershell
runAs: localSystem
content: |
Get-Process | Out-File -FilePath C:\Process.txt
- frequency: always
type: batch
runAs: localSystem
content: |
systeminfo
```
**Beispiel 3: Idempotenz-Systemkonfiguration mit Neustarts**
Dieses Beispiel zeigt eine Aufgabe `executeScript`, die ein idempotentes Skript ausführt, um die folgende Systemkonfiguration mit einem Neustart zwischen den einzelnen Schritten durchzuführen:
+ Den Computer umbenennen.
+ Den Computer mit der Domain verbinden.
+ Aktivieren von Telnet.
Das Skript stellt sicher, dass jede Operation nur einmal ausgeführt wird. Dies verhindert eine Neustartschleife und macht das Skript idempotent.
```
task: executeScript
inputs:
- frequency: always
type: powershell
runAs: localSystem
content: |-
$name = $env:ComputerName
if ($name -ne $desiredName) {
Rename-Computer -NewName $desiredName
exit 3010
}
$domain = Get-ADDomain
if ($domain -ne $desiredDomain)
{
Add-Computer -DomainName $desiredDomain
exit 3010
}
$telnet = Get-WindowsFeature -Name Telnet-Client
if (-not $telnet.Installed)
{
Install-WindowsFeature -Name "Telnet-Client"
exit 3010
}
```
## extendRootPartition
Erweitert das Stammvolume, um den gesamten verfügbaren Speicherplatz auf der Festplatte zu nutzen.
*Häufigkeit* - einmal
*AllowedStages* — `[Boot]`
*Eingaben* — keine
*Beispiel*
```
task: extendRootPartition
```
## initializeVolume
Initialisiert leere Volumes, die an die Instance angefügt sind, sodass diese aktiviert und partitioniert werden. Der Startagent überspringt die Initialisierung, wenn er erkennt, dass das Volume nicht leer ist. Ein Volume gilt als leer, wenn die ersten 4 KiB des Volumes leer sind oder wenn das Volume kein [von Windows erkennbares Laufwerkslayout](https://learn.microsoft.com/en-us/windows/win32/api/winioctl/ns-winioctl-drive_layout_information_ex) aufweist.
Der Eingabeparameter wird `letter` immer angewendet, wenn diese Aufgabe ausgeführt wird, unabhängig davon, ob das Laufwerk bereits initialisiert ist.
Das `initializeVolume` führt die folgenden Aktionen aus.
+ Setzen Sie die Festplattenattribute `offline` und `readonly` auf false.
+ Erstellen Sie eine Partition. Wenn im Eingabeparameter `partition` kein Partitionstyp angegeben ist, gelten die folgenden Standardwerte:
+ Wenn die Festplattengröße kleiner als 2 TB ist, legen Sie den Partitionstyp auf `mbr` fest.
+ Wenn die Festplattengröße 2 TB oder größer ist, legen Sie den Partitionstyp auf `gpt` fest.
+ Formatieren Sie das Volume als NTFS.
+ Legen Sie die Volume-Bezeichnung wie folgt fest:
+ Verwenden Sie den Wert des Eingabeparameters `name`, falls angegeben.
+ Wenn es sich um ein kurzlebiges Volume handelt und kein Name angegeben wurde, legen Sie die Volume-Bezeichnung auf `Temporary Storage Z` fest.
+ Wenn das Volume kurzlebig ist (SSD oder HDD – nicht Amazon EBS), erstellen Sie im Stammverzeichnis des Volumes eine `Important.txt`-Datei mit dem folgenden Inhalt:
```
This is an 'Instance Store' disk and is provided at no additional charge.
*This disk offers increased performance since it is local to the host
*The number of Instance Store disks available to an instance vary by instance type
*DATA ON THIS DRIVE WILL BE LOST IN CASES OF IMPAIRMENT OR STOPPING THE INSTANCE. PLEASE ENSURE THAT ANY IMPORTANT DATA IS BACKED UP FREQUENTLY
For more information, please refer to: Instance-Speicher temporärer Speicher auf Blockebene für EC2-Instances.
```
+ Legen Sie den Laufwerkbuchstaben auf den im Eingabeparameter `letter` angegebenen Wert fest.
**Phasen:** Sie können die Aufgabe `initializeVolume` während der Phasen `PostReady` und `UserData` ausführen.
**Häufigkeit:** immer.
**Eingaben**
Sie können Laufzeitparameter wie folgt konfigurieren:
**Geräte (Liste der Zuordnungen)**
(Bedingt) Konfiguration für jedes Gerät, das vom Startagenten initialisiert wird. Dies ist erforderlich, wenn der Eingabeparameter `initialize` auf `devices` festgelegt ist.
+ **Gerät (Zeichenfolge, erforderlich)** – Identifiziert das Gerät während der Instance-Erstellung. Beispiel: `xvdb`, `xvdf` oder `\dev\nvme0n1`.
+ **Buchstabe (Zeichenfolge, optional)** – Ein Zeichen. Der Laufwerkbuchstabe, der zugewiesen werden soll.
+ **Name (Zeichenfolge, optional)** – Der zuzuweisende Volume-Name.
+ **Partition (Zeichenfolge, optional)** – Geben Sie einen der folgenden Werte für den Typ der zu erstellenden Partition an oder lassen Sie den Startagenten basierend auf der Volume-Größe als Standard festlegen:
+ mbr
+ gpt
**initialisieren (Zeichenfolge)**
(Erforderlich) Geben Sie genau einen der folgenden Werte an:
+ `all`
+ `devices`
**Beispiele**
Die folgenden Beispiele zeigen Beispiele für Eingabekonfigurationen für die `initializeVolume`-Aufgabe.
**Beispiel 1: Initialisieren von zwei Volumes auf einer Instance**
Dieses Beispiel zeigt eine `initializeVolume`-Aufgabe, die zwei sekundäre Volumes auf einer Instance initialisiert. Das Gerät mit dem Namen `DataVolume2` im Beispiel ist kurzlebig.
```
task: initializeVolume
inputs:
initialize: devices
devices:
- device: xvdb
name: DataVolume1
letter: D
partition: mbr
- device: /dev/nvme0n1
name: DataVolume2
letter: E
partition: gpt
```
**Beispiel 2: Initialisieren von EBS-Volumes, die an eine Instance angefügt sind**
Dieses Beispiel zeigt eine `initializeVolume`-Aufgabe, die alle leeren EBS-Volumes initialisiert, die an die Instance angefügt sind.
```
task: initializeVolume
inputs:
initialize: all
```
## optimizeEna
Optimiert ENA-Einstellungen basierend auf dem aktuellen Instance-Typ. Möglicherweise wird die Instance neu gestartet.
*Häufigkeit* — immer
*AllowedStages* — `[PostReady, UserData]`
*Eingaben* — keine
*Beispiel*
```
task: optimizeEna
```
## setAdminAccount
Legt Attribute für das Standardadministratorkonto fest, das auf dem lokalen Computer erstellt wird.
*Häufigkeit* - einmal
*AllowedStages* — `[PreReady]`
*Eingaben* —
`name`: (Zeichenfolge) Name des Administratorkontos
`password`: (Zuordnung)
`type`: (Zeichenfolge) Strategie zum Setzen des Passworts, entweder als `static`, `random` oder `doNothing`
`data`: (Zeichenfolge) speichert Daten, wenn das Feld `type` statisch ist
*Beispiel*
```
task: setAdminAccount
inputs:
name: Administrator
password:
type: random
```
## setDnsSuffix
Fügt DNS-Suffixe zur Liste der Suchsuffixe hinzu. Nur Suffixe, die noch nicht vorhanden sind, werden der Liste hinzugefügt. Weitere Informationen zur Einrichtung von DNS-Suffixen durch Start-Agenten finden Sie unter [Konfigurieren Sie das DNS-Suffix für EC2 Windows-Startagenten](launch-agents-set-dns.md).
*Häufigkeit* — immer
*AllowedStages* — `[PreReady]`
*Eingaben* —
`suffixes`: (Liste von Zeichenfolgen) Liste mit einem oder mehreren gültigen DNS-Suffixen; gültige Substitutionsvariablen sind `$REGION` und `$AZ`
*Beispiel*
```
task: setDnsSuffix
inputs:
suffixes:
- $REGION.ec2-utilities.amazonaws.com
```
## setHostName
Legt den Hostnamen des Computers auf eine benutzerdefinierte Zeichenfolge oder, falls nicht `hostName` angegeben, auf die private IPv4 Adresse fest.
*Häufigkeit* — immer
*AllowedStages* — `[PostReady, UserData]`
*Eingaben* —
`hostName`: (Zeichenfolge) optionaler Host-Name, der wie folgt formatiert werden muss.
+ Muss 15 Zeichen oder weniger haben
+ Muss nur alphanumerische (a-z, A-Z, 0-9) und Bindestriche (-) enthalten.
+ Darf nicht ausschließlich aus numerischen Zeichen bestehen.
`reboot`: (boolescher Wert) gibt an, ob ein Neustart zulässig ist, wenn der Hostname geändert wird
*Beispiel*
```
task: setHostName
inputs:
reboot: true
```
## setWallpaper
Erstellt die Verknüpfungsdatei `setwallpaper.lnk` im Startup-Ordner jedes vorhandenen Benutzers, mit Ausnahme von `Default User`. Diese Verknüpfungsdatei wird ausgeführt, wenn sich der Benutzer nach dem Start der Instance zum ersten Mal anmeldet. Hiermit wird die Instance mit einem benutzerdefinierten Hintergrundbild eingerichtet, auf dem die Instance-Attribute zu sehen sind.
Der Pfad der Verknüpfungsdatei lautet:
```
$env:SystemDrive/Users//AppData/Roaming/Microsoft/Windows/Start Menu/Programs/Startup/setwallpaper.lnk
```
**Anmerkung**
Wenn Sie die `setWallpaper`-Aufgabe entfernen, wird diese Verknüpfungsdatei nicht gelöscht. Weitere Informationen finden Sie unter [Die Aufgabe `setWallpaper` ist nicht aktiviert, aber das Hintergrundbild wird beim Neustart zurückgesetzt](ec2launchv2-troubleshooting.md#ec2launchv2-troubleshooting-wallpaper-resets).
**Phasen:** Sie können das Hintergrundbild während der Phasen `PreReady` und `UserData` konfigurieren.
**Häufigkeit:** `always`
**Konfiguration des Hintergrundbilds**
Sie können Ihr Hintergrundbild mit den folgenden Steuerelementen konfigurieren.
**Eingaben**
Von Ihnen bereitgestellte Eingabeparameter und Attribute, die Sie zum Konfigurieren Ihres Hintergrundbilds festlegen können:
**Pfad (Zeichenfolge)**
(Erforderlich) Der Dateinamenspfad der lokalen Bilddatei im .jpg-Format, die für Ihr Hintergrundbild verwendet werden soll.
**Attribute (Liste von Zeichenfolgen)**
(Optional) Sie können Ihrem Hintergrundbild eines oder mehrere der folgenden Attribute hinzufügen:
+ `architecture`
+ `availabilityZone`
+ `hostName`
+ `instanceId`
+ `instanceSize`
+ `privateIpAddress`
+ `publicIpAddress`
+ `ipv6Address`
**instanceTags**
(Optional) Sie können genau eine der folgenden Optionen für diese Einstellung verwenden.
+ **AllTags**(string) — Fügt alle Instanz-Tags zu Ihrem Hintergrundbild hinzu.
```
instanceTags: AllTags
```
+ **instanceTags** (Liste von Zeichenfolgen) – Geben Sie eine Liste mit Instance-Tag-Namen an, die Ihrem Hintergrundbild hinzugefügt werden sollen. Beispiel:
```
instanceTags:
- Tag 1
- Tag 2
```
**Beispiel**
Das folgende Beispiel zeigt Hintergrundkonfigurationseingaben, die den Dateipfad für das Hintergrundbild festlegen, zusammen mit Instance-Tags mit den Namen `Tag 1` und `Tag 2` und Attributen, die den Hostnamen, die Instance-ID und die privaten und öffentlichen IP-Adressen für die Instance enthalten.
```
task: setWallpaper
inputs:
path: C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg
attributes:
- hostName
- instanceId
- privateIpAddress
- publicIpAddress
instanceTags:
- Tag 1
- Tag 2
```
**Anmerkung**
Sie müssen Tags in Metadaten aktivieren, um Tags auf dem Hintergrundbild anzuzeigen. Weitere Informationen zu Instance-Tags und Metadaten finden Sie unter [Tags für Ihre EC2-Instances mithilfe von Instance-Metadaten anzeigen](work-with-tags-in-IMDS.md).
## startSsm
Starten des Systems Manager-Services (SSM) nach Sysprep.
*Häufigkeit* — immer
*AllowedStages* — `[PostReady, UserData]`
*Eingaben* — keine
*Beispiel*
```
task: startSsm
```
## sysprep
Setzt den Servicestatus zurück, aktualisiert `unattend.xml`, deaktiviert RDP und führt Sysprep aus. Diese Aufgabe wird erst ausgeführt, wenn alle anderen Aufgaben abgeschlossen sind.
*Häufigkeit* - einmal
*AllowedStages* — `[UserData]`
*Eingaben* —
`clean`: (boolescher Wert) bereinigt Instance-Protokolle vor dem Ausführen von Sysprep
`shutdown`: (boolescher Wert) fährt die Instance nach dem Ausführen von Sysprep herunter
*Beispiel*
```
task: sysprep
inputs:
clean: true
shutdown: true
```
## writeFile
Schreibt eine Datei in ein Ziel.
*Häufigkeit * — siehe *Eingaben*
*AllowedStages* — `[PostReady, UserData]`
*Eingaben* —
`frequency`: (Zeichenfolge) `once` oder `always`
`destination`: (Zeichenfolge) Pfad, in den der Inhalt geschrieben werden soll
`content`: (Zeichenfolge) Text, der an das Ziel geschrieben werden soll
*Beispiel*
```
task: writeFile
inputs:
- frequency: once
destination: C:\Users\Administrator\Desktop\booted.txt
content: Windows Has Booted
```
# Probleme mit dem EC2 Launch v2-Agenten beheben
In diesem Abschnitt werden allgemeine Problembehandlungsszenarien für EC2 Launch v2, Informationen zum Anzeigen von Windows-Ereignisprotokollen sowie Ausgaben und Meldungen in Konsolenprotokollen beschrieben.
**Topics**
+ [Gängige Szenarien](#ec2launchv2-troubleshooting-scenarios)
+ [Windows-Ereignisprotokolle](#ec2launchv2-windows-event-logs)
+ [EC2Starten Sie die Protokollausgabe der v2-Konsole](#ec2launchv2-console-output)
## Allgemeine Problembehandlungsszenarien
In diesem Abschnitt werden allgemeine Problembehandlungsszenarien und Lösungsschritte aufgeführt.
**Topics**
+ [Der Service kann das Hintergrundbild nicht festlegen](#ec2launchv2-troubleshooting-wallpaper)
+ [Service kann Benutzerdaten nicht ausführen](#ec2launchv2-troubleshooting-user-data)
+ [Der Service führt eine Aufgabe nur einmal aus](#ec2launchv2-troubleshooting-task-once)
+ [Service kann eine Aufgabe nicht ausführen](#ec2launchv2-troubleshooting-task-failed)
+ [Der Service führt Benutzerdaten mehr als einmal aus](#ec2launchv2-troubleshooting-user-data-more-than-once)
+ [Geplante Aufgaben von EC2 Launch v1 können nach der Migration zu EC2 Launch v2 nicht ausgeführt werden](#ec2launchv2-troubleshooting-scheduled-tasks-migration)
+ [Der Service initialisiert ein EBS-Volume, das nicht leer ist](#ec2launchv2-troubleshooting-ebs-initialize)
+ [Die Aufgabe `setWallpaper` ist nicht aktiviert, aber das Hintergrundbild wird beim Neustart zurückgesetzt](#ec2launchv2-troubleshooting-wallpaper-resets)
+ [Der Dienst hängt im laufenden Status fest](#ec2launchv2-troubleshooting-service-stuck-running)
+ [Ungültig `agent-config.yml` verhindert das Öffnen des Dialogfelds mit den EC2 Launch v2-Einstellungen](#ec2launchv2-troubleshooting-invalid-agent-config)
+ [`task:executeScript should be unique and only invoked once`](#ec2launchv2-troubleshooting-executescript)
### Der Service kann das Hintergrundbild nicht festlegen
**Auflösung**
1. Überprüfen Sie, ob `%AppData%\Roaming\Microsoft\Windows\Start Menu\Programs\Startup\setwallpaper.lnk` vorhanden ist.
1. Überprüfen Sie `%ProgramData%\Amazon\EC2Launch\log\agent.log` darauf, ob Fehler aufgetreten sind.
### Service kann Benutzerdaten nicht ausführen
**Mögliche Ursache**: Der Service ist möglicherweise fehlgeschlagen, bevor Benutzerdaten ausgeführt werden konnten.
**Auflösung**
1. Überprüfen Sie `%ProgramData%\Amazon\EC2Launch\state\previous-state.json`.
1. Sehen Sie nach, ob `boot`, `network`, `preReady` und `postReadyLocalData` wurden alle als erfolgreich markiert wurden.
1. Wenn eine der Phasen fehlgeschlagen ist, überprüfen Sie `%ProgramData%\Amazon\EC2Launch\log\agent.log` auf bestimmte Fehler.
### Der Service führt eine Aufgabe nur einmal aus
**Auflösung**
1. Überprüfen Sie die Häufigkeit der Aufgabe.
1. Wenn der Service bereits nach Sysprep ausgeführt wurde und die Aufgabenhäufigkeit auf `once` festgelegt ist, wird die Aufgabe nicht erneut ausgeführt.
1. Stellen Sie die Häufigkeit der Aufgabe auf ein, `always` wenn die Aufgabe bei jeder Ausführung von EC2 Launch v2 ausgeführt werden soll.
### Service kann eine Aufgabe nicht ausführen
**Auflösung**
1. Überprüfen Sie die neuesten Einträge in `%ProgramData%\Amazon\EC2Launch\log\agent.log`.
1. Wenn keine Fehler aufgetreten sind, versuchen Sie, den Service manuell von `"%ProgramFiles%\Amazon\EC2Launch\EC2Launch.exe" run` auszuführen, um festzustellen, ob die Aufgaben ausgeführt werden.
### Der Service führt Benutzerdaten mehr als einmal aus
**Auflösung**
Benutzerdaten werden zwischen EC2 Launch v1 und EC2 Launch v2 unterschiedlich behandelt. EC2Launch v1 führt Benutzerdaten als geplante Aufgabe auf der Instance aus, wenn `persist` dies auf eingestellt ist`true`. Wenn `persist` auf `false` festgelegt ist, wird die Aufgabe nicht geplant, selbst wenn sie mit einem Neustart beendet wird oder während der Ausführung unterbrochen wird.
EC2Launch v2 führt Benutzerdaten als Agententask aus und verfolgt deren Ausführungsstatus. Wenn Benutzerdaten einen Neustart des Computers ausstellen oder Benutzerdaten während der Ausführung unterbrochen wurden, bleibt der Ausführungsstatus als `pending` bestehen und die Benutzerdaten werden beim nächsten Instance-Start erneut ausgeführt. Wenn Sie verhindern möchten, dass das Benutzerdatenskript mehr als einmal ausgeführt wird, machen Sie das Skript idempotent.
Das folgende Beispiel für ein idempotentes Skript legt den Computer-Namen fest und schließt sich einer Domain an.
```
$name = $env:computername
if ($name -ne $desiredName) {
Rename-Computer -NewName $desiredName
}
$domain = Get-ADDomain
if ($domain -ne $desiredDomain)
{
Add-Computer -DomainName $desiredDomain
}
$telnet = Get-WindowsFeature -Name Telnet-Client
if (-not $telnet.Installed)
{
Install-WindowsFeature -Name "Telnet-Client"
}
false
```
### Geplante Aufgaben von EC2 Launch v1 können nach der Migration zu EC2 Launch v2 nicht ausgeführt werden
**Auflösung**
Das Migrationstool erkennt keine geplanten Aufgaben, die mit EC2 Launch v1-Skripts verknüpft sind. Daher werden diese Aufgaben nicht automatisch in EC2 Launch v2 eingerichtet. Um diese Aufgaben zu konfigurieren, bearbeiten Sie die [`agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-task-configuration)Datei oder verwenden Sie das [Dialogfeld mit den EC2 Launch v2-Einstellungen](ec2launch-v2-settings.md#ec2launch-v2-ui). Wenn für eine Instance beispielsweise eine geplante Aufgabe ausgeführt wird`InitializeDisks.ps1`, müssen Sie nach der Ausführung des Migrationstools die Volumes, die Sie initialisieren möchten, im Dialogfeld mit den EC2 Launch v2-Einstellungen angeben. Siehe Schritt 6 des Verfahrens zu [Ändern Sie die Einstellungen im Dialogfeld mit den EC2 Launch v2-Einstellungen](ec2launch-v2-settings.md#ec2launch-v2-ui).
### Der Service initialisiert ein EBS-Volume, das nicht leer ist
**Auflösung**
Bevor ein Volume initialisiert wird, versucht EC2 Launch v2 zu ermitteln, ob es leer ist. Wenn ein Volume nicht leer ist, überspringt es die Initialisierung. Alle Volumes, die als nicht leer erkannt werden, werden nicht initialisiert. Ein Volume gilt als leer, wenn die ersten 4 KiB eines Volumes leer sind oder wenn ein Volume kein [Windows-erkennbares Laufwerkslayout](https://learn.microsoft.com/en-us/windows/win32/api/winioctl/ns-winioctl-drive_layout_information_ex) hat. Ein Volume, das auf einem Linux-System initialisiert und formatiert wurde, hat kein Windows-erkennbares Laufwerkslayout, zum Beispiel MBR oder GPT. Daher wird es als leer und initialisiert betrachtet. Wenn Sie diese Daten beibehalten möchten, verlassen Sie sich nicht auf die Erkennung leerer Laufwerke in EC2 Launch v2. Geben Sie stattdessen die Volumes an, die Sie initialisieren möchten, im [Dialogfeld mit den EC2 Launch v2-Einstellungen](ec2launch-v2-settings.md#ec2launch-v2-ui) (siehe Schritt 6) oder im [`agent-config.yml`](ec2launch-v2-task-definitions.md#ec2launch-v2-initializevolume).
### Die Aufgabe `setWallpaper` ist nicht aktiviert, aber das Hintergrundbild wird beim Neustart zurückgesetzt
Die Aufgabe `setWallpaper` erstellt die Verknüpfungsdatei `setwallpaper.lnk` im Startup-Ordner jedes vorhandenen Benutzers. Diese Verknüpfungsdatei wird ausgeführt, wenn sich der Benutzer nach dem Start der Instance zum ersten Mal anmeldet. Hiermit wird die Instance mit einem benutzerdefinierten Hintergrundbild eingerichtet, auf dem die Instance-Attribute zu sehen sind. Durch das Entfernen der Aufgabe `setWallpaper` wird diese Verknüpfungsdatei nicht gelöscht. Sie müssen die Datei manuell oder mithilfe eines Skripts löschen.
Der Verknüpfungspfad lautet:
`$env:SystemDrive/Users//AppData/Roaming/Microsoft/Windows/Start Menu/Programs/Startup/setwallpaper.lnk`
**Auflösung**
Löschen Sie die Datei manuell oder mithilfe eines Skripts.
** PowerShell Beispielskript zum Löschen der Shortcut-Datei**
```
foreach ($userDir in (Get-ChildItem "C:\Users" -Force -Directory).FullName)
{
$startupPath = Join-Path $userDir -ChildPath "AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup"
if (Test-Path $startupPath)
{
$wallpaperSetupPath = Join-Path $startupPath -ChildPath "setwallpaper.lnk"
if (Test-Path $wallpaperSetupPath)
{
Remove-Item $wallpaperSetupPath -Force -Confirm:$false
}
}
}
```
### Der Dienst hängt im laufenden Status fest
**Beschreibung**
EC2Launch v2 ist blockiert, mit Protokollmeldungen (`agent.log`), die den folgenden ähneln:
```
2022-02-24 08:08:58 Info: *****************************************************************************************
2022-02-24 08:08:58 Info: EC2Launch Service starting
2022-02-24 08:08:58 Info: Windows event custom log exists: Amazon EC2Launch
2022-02-24 08:08:58 Info: ACPI SPCR table not supported. Bailing Out
2022-02-24 08:08:58 Info: Serial port is in use. Waiting for Serial Port...
2022-02-24 08:09:00 Info: ACPI SPCR table not supported. Use default console port.
2022-02-24 08:09:02 Info: ACPI SPCR table not supported. Use default console port.
2022-02-24 08:09:04 Info: ACPI SPCR table not supported. Use default console port.
2022-02-24 08:09:06 Info: ACPI SPCR table not supported. Use default console port.
```
**Mögliche Ursache**
SAC ist aktiviert und verwendet die serielle Schnittstelle. Weitere Informationen finden Sie unter [SAC zur Fehlerbehhebung von Windows-Instances verwenden](troubleshoot-using-serial-console.md#troubleshooting-sac).
**Auflösung**
Versuchen Sie, das Problem wie folgt zu beheben:
+ Deaktivieren Sie den Dienst, der den seriellen Port verwendet.
+ Wenn Sie möchten, dass der Dienst weiterhin den seriellen Port verwendet, schreiben Sie benutzerdefinierte Skripte, um Launch-Agent-Aufgaben auszuführen, und rufen Sie diese als geplante Aufgaben auf.
### Ungültig `agent-config.yml` verhindert das Öffnen des Dialogfelds mit den EC2 Launch v2-Einstellungen
**Description**
EC2Launch v2-Einstellungen versucht, die `agent-config.yml` Datei zu analysieren, bevor das Dialogfeld geöffnet wird. Wenn die YAML-Konfigurationsdatei nicht dem unterstützten Schema folgt, zeigt das Dialogfeld den folgenden Fehler an:
`Unable to parse configuration file agent-config.yml. Review configuration file. Exiting application.`
**Auflösung**
1. Stellen Sie sicher, dass die Konfigurationsdatei dem [unterstützten Schema](ec2launch-v2-settings.md#ec2launch-v2-schema-agent-config) entspricht.
1. Wenn Sie von vorne anfangen möchten, kopieren Sie die Standardkonfigurationsdatei in `agent-config.yml`. Sie können das [Beispiel`agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-example-agent-config) im Abschnitt „Aufgabenkonfiguration“ verwenden.
1. Sie können auch von vorne beginnen, indem Sie `agent-config.yml` löschen. EC2Launch v2 settings generiert eine leere Konfigurationsdatei.
### `task:executeScript should be unique and only invoked once`
**Description**
Eine Aufgabe nicht in derselben Phase wiederholt werden kann.
**Auflösung**
Einige Aufgaben müssen als Array eingegeben werden, z. B. [**executeScript**](ec2launch-v2-task-definitions.md#ec2launch-v2-executescript) und [**executeProgram**](ec2launch-v2-task-definitions.md#ec2launch-v2-executeprogram). Ein Beispiel für das Schreiben des Skripts als Array finden Sie unter [**executeScript**](ec2launch-v2-task-definitions.md#ec2launch-v2-executescript).
## Windows-Ereignisprotokolle
EC2Launch v2 veröffentlicht Windows-Ereignisprotokolle für wichtige Ereignisse wie den Start des Dienstes, die Bereitschaft von Windows sowie erfolgreiche und fehlgeschlagene Aufgaben. Ereignis-IDs identifizieren eindeutig ein bestimmtes Ereignis. Jedes Ereignis enthält Informationen zu Phase, Aufgabe und Ebene sowie eine Beschreibung. Sie können mithilfe der Ereignis-ID Auslöser für bestimmte Ereignisse festlegen.
Ereignisse IDs stellen Informationen zu einem Ereignis bereit und identifizieren bestimmte Ereignisse eindeutig. Die am wenigsten signifikante Ziffer einer Ereignis-ID gibt den Schweregrad eines Ereignisses an.
| Veranstaltung | Am wenigsten bedeutende Ziffer |
| --- | --- |
| Success | . . .0 |
| Informational | . . .1 |
| Warning | . . .2 |
| Error | . . .3 |
Dienstbezogene Ereignisse, die beim Start oder Ende des Dienstes generiert werden, enthalten eine einstellige Ereigniskennung.
| Veranstaltung | Einstellige ID |
| --- | --- |
| Success | 0 |
| Informational | 1 |
| Warning | 2 |
| Error | 3 |
Die Ereignisnachrichten für `EC2LaunchService.exe`-Ereignisse beginnen mit `Service:`. Die Ereignisnachrichten für `EC2Launch.exe`-Ereignisse beginnen nicht mit `Service:`.
Ein vierstelliges Ereignis IDs enthält Informationen über das Stadium, die Aufgabe und den Schweregrad eines Ereignisses.
**Topics**
+ [Format der Ereignis-ID](#ec2launchv2-windows-event-logs-format)
+ [Beispiele für Ereignis-IDs](#ec2launchv2-windows-event-logs-id-examples)
+ [Windows-Ereignisprotokollschema](#ec2launch-v2-windows-event-logs-schema)
### Format der Ereignis-ID
Die folgende Tabelle zeigt das Format einer EC2 Launch v2-Ereignis-ID.
| 3 | 2 1 | 0 |
| --- | --- | --- |
| S | T | L |
Die Buchstaben und Zahlen in der Tabelle stehen für die folgenden Ereignistypen und Definitionen.
| Ereignistyp | Definition |
| --- | --- |
| S (Stage) | 0 - Nachricht auf Service-Ebene 1 - Boot 2 - Netzwerk 3 - PreReady 5 - Windows ist bereit 6 - PostReady 7 - Benutzerdaten |
| T (Aufgabe) | Die Aufgaben, die durch die entsprechenden beiden Werte dargestellt werden, sind für jede Phase unterschiedlich. Informationen zur vollständigen Liste der Ereignisse finden Sie unter [Windows-Ereignisprotokollschema](#ec2launch-v2-windows-event-logs-schema). |
| L (Ebene des Ereignisses) | 0 - Erfolg 1 - Informativ 2 - Warnung 3 - Fehler |
### Beispiele für Ereignis-IDs
Im Folgenden finden Sie ein Beispielereignis IDs.
+ `5000` - Windows ist einsatzbereit
+ `3010`- Die Windows-Aufgabe in der PreReady Phase aktivieren war erfolgreich
+ `6013`- Bei der Aufgabe „Hintergrundbild festlegen“ ist in der Phase „ PostReady Lokale Daten“ ein Fehler aufgetreten
### Windows-Ereignisprotokollschema
| MessageId/Ereignis-ID | Ereignismeldung |
| --- | --- |
| . . .0 | Success |
| . . .1 | Informational |
| . . .2 | Warning |
| . . .3 | Error |
| x | EC2Launch service-level logs |
| 0 | EC2Launch service exited successfully |
| 1 | EC2Launch service informational logs |
| 2 | EC2Launch service warning logs |
| 3 | EC2Launch service error logs |
| 10 | Replace state.json with previous-state.json |
| 100 | Serial Port |
| 200 | Sysprep |
| 300 | PrimaryNic |
| 400 | Metadata |
| x000 | Stage (1 digit), Task (2 digits), Status (1 digit) |
| 1000 | Boot |
| 1010 | Boot - extend\$1root\$1partition |
| 2000 | Network |
| 2010 | Network - add\$1routes |
| 3000 | PreReady |
| 3010 | PreReady - activate\$1windows |
| 3020 | PreReady - install\$1egpu\$1manager |
| 3030 | PreReady - set\$1monitor\$1on |
| 3040 | PreReady - set\$1hibernation |
| 3050 | PreReady - set\$1admin\$1account |
| 3060 | PreReady - set\$1dns\$1suffix |
| 3070 | PreReady - set\$1wallpaper |
| 3080 | PreReady - set\$1update\$1schedule |
| 3090 | PreReady - output\$1log |
| 3100 | PreReady - enable\$1open\$1ssh |
| 5000 | Windows is Ready to use |
| 6000 | PostReadyLocalData |
| 7000 | PostReadyUserData |
| 6010/7010 | PostReadyLocal/UserData - set\$1wallpaper |
| 6020/7020 | PostReadyLocal/UserData - set\$1update\$1schedule |
| 6030/7030 | PostReadyLocal/UserData - set\$1hostname |
| 6040/7040 | PostReadyLocal/UserData - execute\$1program |
| 6050/7050 | PostReadyLocal/UserData - execute\$1script |
| 6060/7060 | PostReadyLocal/UserData - manage\$1package |
| 6070/7070 | PostReadyLocal/UserData - initialize\$1volume |
| 6080/7080 | PostReadyLocal/UserData - write\$1file |
| 6090/7090 | PostReadyLocal/UserData - start\$1ssm |
| 7100 | PostReadyUserData - enable\$1open\$1ssh |
| 6110/7110 | PostReadyLocal/UserData - enable\$1jumbo\$1frames |
## EC2Starten Sie die Protokollausgabe der v2-Konsole
Dieser Abschnitt enthält Beispiele für die Konsolenprotokollausgabe für EC2 Launch v2 und listet alle Fehlermeldungen des EC2 Launch v2-Konsolenprotokolls auf, um Ihnen bei der Behebung von Problemen zu helfen. Weitere Informationen über die Ausgabe der Instance-Konsole und wie Sie darauf zugreifen können, finden Sie unter [Instance-Konsolenausgabe](troubleshoot-unreachable-instance.md#instance-console-console-output).
**Topics**
+ [EC2Protokollausgabe der Launch v2-Konsole](#ec2launchv2-console-log-output)
+ [EC2Protokollmeldungen der Launch v2-Konsole](#ec2launchv2-console-log-messages)
### EC2Protokollausgabe der Launch v2-Konsole
Im Folgenden finden Sie ein Beispiel für die Konsolenprotokollausgabe für EC2 Launch v2. Einige Werte in diesem Beispiel werden durch repräsentativen Text ersetzt, der von geschweiften Klammern umgeben ist.
```
2025/07/22 21:26:53Z: Windows sysprep configuration complete.
2025/07/22 21:26:53Z: Message: Waiting for access to metadata...
2025/07/22 21:26:53Z: Message: Meta-data is now available.
2025/07/22 21:26:53Z: AMI Origin Version: 2024.12.13
2025/07/22 21:26:53Z: AMI Origin Name: Windows_Server-2022-English-Full-Base
2025/07/22 21:26:53Z: OS: Microsoft Windows NT 10.0.20348
2025/07/22 21:26:53Z: OsVersion: 10.0
2025/07/22 21:26:53Z: OsProductName: Windows Server 2022 Datacenter
2025/07/22 21:26:53Z: OsBuildLabEx: 20348.1.amd64fre.fe_release.210507-1500
2025/07/22 21:26:53Z: OsCurrentBuild: 20348
2025/07/22 21:26:53Z: OsReleaseId: 2009
2025/07/22 21:26:53Z: Language: en-US
2025/07/22 21:26:53Z: TimeZone: UTC
2025/07/22 21:26:53Z: Offset: UTC +0000
2025/07/22 21:26:53Z: Launch: EC2 Launch v2.2.63
2025/07/22 21:26:53Z: AMI-ID: ami-1234567890abcdef1
2025/07/22 21:26:53Z: Instance-ID: i-1234567890abcdef0
2025/07/22 21:26:54Z: Instance Type: t3.xlarge
2025/07/22 21:26:54Z: Driver: AWS NVMe Driver v1.6.0.35
2025/07/22 21:26:54Z: SubComponent: 1.6.0.35; EnableSCSIPersistentReservations: 0
2025/07/22 21:26:54Z: Driver: AWS PV Driver Package v8.5.0
2025/07/22 21:26:55Z: Driver: Amazon Elastic Network Adapter v2.8.0.0
2025/07/22 21:26:55Z: HOSTNAME: EC2AMAZ-9FJG5CC
2025/07/22 21:26:55Z: RDPCERTIFICATE-SUBJECTNAME: {certificate subject name}
2025/07/22 21:26:55Z: RDPCERTIFICATE-THUMBPRINT: {thumbprint hash}
2025/07/22 21:26:56Z: SSM: Amazon SSM Agent v3.3.2746.0
2025/07/22 21:26:57Z: User data format: no_user_data
2025/07/22 21:26:57Z: EC2LaunchTelemetry: IsTelemetryEnabled=true
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AgentOsArch=windows_amd64
2025/07/22 21:26:57Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AgentCommandErrorCode=1
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AdminPasswordTypeCode=0
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AgentErrorLocation=execute_windows.go:410
2025/07/22 21:26:57Z: EC2LaunchTelemetry: IpConflictDetectionCode=0
2025/07/22 21:26:57Z: Message: Windows is Ready to use
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2", ...}
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2", ...}
```
### EC2Protokollmeldungen der Launch v2-Konsole
Im Folgenden finden Sie eine Liste aller Protokollmeldungen der EC2 Launch v2-Konsole.
```
Error EC2Launch service is stopping. {error message}
```
Einzelheiten zum Fehler beim Beenden des Services:
+ `Error setting up EC2Launch agent folders`
+ `See instance logs for detail`
+ `Error stopping service`
+ `Error initializing service`
```
Windows sysprep configuration complete
```
```
Invalid administrator username: {invalid username}
```
```
Invalid administrator password
Username: {username}
Password: {encrypted password}
```
Die folgende Nachricht ist ein Informationsblock, der AMI-Details enthält:
```
AMI Origin Version: {amiVersion}
AMI Origin Name: {amiName}
Microsoft Windows NT {currentVersion}.{currentBuildNumber}
OsVersion: {currentVersion}
OsProductName: {productName}
OsBuildLabEx: {buildLabEx}
OsCurrentBuild: {currentBuild}
OsReleaseId: {releaseId}
Language: {language}
TimeZone: {timeZone}
Offset: UTC {offset}
Launch agent: EC2Launch {BuildVersion}
AMI-ID: {amiId}
Instance-ID: {instanceId}
Instance Type: {instanceType}
HOSTNAME: {computer name}
RDPCERTIFICATE-SUBJECTNAME: {certificate subject name}
RDPCERTIFICATE-THUMBPRINT: {thumbprint hash}
SqlServerBilling: {sql billing}
SqlServerInstall: {sql patch leve, edition type}
Driver: AWS NVMe Driver {version}
Driver: Inbox NVMe Driver {version}
Driver: AWS PV Driver Package {version}
SSM: Amazon SSM Agent {version}
AWS VSS Version: {version}
```
```
Windows sysprep configuration complete.
Windows is being configured. 'SysprepState is {state}'
Windows is still being configured. 'SysprepState is {state}'
Windows is Ready to use
Waiting for access to metadata...
Meta-data is now available.
Metadata is not available for this instance.
Timed out waiting for access to metadata.
User data format: {format}
```
Telemetriemeldungen von EC2Launch v2 enthalten die Eigenschaftswerte der Starttelemetrie. Ab Version 2.2.63 werden die Telemetriedaten des EC2-Agenten als JSON-Objekt formatiert.
```
EC2LaunchTelemetry: {telemetry property}
```
```
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2" ... }
```
# EC2Versionsverläufe von Launch v2
**Topics**
+ [EC2Versionsverlauf für Version 2 starten](#ec2launchv2-version-history)
## EC2Versionsverlauf für Version 2 starten
Informationen dazu, wie Sie sicherstellen können, dass Sie den neuesten Startagenten installiert haben, finden Sie unter [Installieren Sie die neueste Version von EC2 Launch v2](ec2launch-v2-install.md). Sie können Benachrichtigungen erhalten, wenn neue Versionen des EC2 Launch v2-Agents veröffentlicht werden. Weitere Informationen finden Sie unter [Abonnieren Sie Benachrichtigungen für den EC2 Windows Launch Agent](launch-agents-subscribe-notifications.md).
In der folgenden Tabelle werden die veröffentlichten Versionen von EC2 Launch v2 beschrieben.
| Version | Details | Datum der Veröffentlichung |
| --- | --- | --- |
| 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 5. März 2026 |
| 2.3.237 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 25. Februar 2026 |
| 2.3.108 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 29. Dezember 2025 |
| 2.3.56 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4. November 2025 |
| 2.3.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 15. September 2025 |
| 2.2.63 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 29. Juli 2025 |
| 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 14. Mai 2025 |
| 2.0.2107 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 27. März 2025 |
| 2.0.2081 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4. Februar 2025 |
| 2.0.2046 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 3. Oktober 2024 |
| 2.0.1981 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6. August 2024 |
| 2.0.1948 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 1. Juli 2024 |
| 2.0.1924 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 10. Juni 2024 |
| 2.0.1914 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 5. Juni 2024 |
| 2.0.1881 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8. Mai 2024 |
| 2.0.1815 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6. März 2024 |
| 2.0.1739 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 17. Januar 2024 |
| 2.0.1702 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 04. Januar 2024 |
| 2.0.1643 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 04. Oktober 2023 |
| 2.0.1580 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 5. September 2023 |
| 2.0.1521 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 03. Juli 2023 |
| 2.0.1303 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 3. Mai 2023 |
| 2.0.1245 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 08. März 2023 |
| 2.0.1173 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 06. Februar 2023 |
| 2.0.1121 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4. Januar 2023 |
| 2.0.1082 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 7. Dezember 2022 |
| 2.0.1011 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 11. November 2022 |
| 2.0.1009 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8. November 2022 |
| 2.0.982 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 31. Oktober 2022 |
| 2.0.863 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6. Juli 2022 |
| 2.0.698 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 30. Januar 2022 |
| 2.0.674 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 15. November 2021 |
| 2.0.651 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 7. Oktober 2021 |
| 2.0.592 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 31. August 2021 |
| 2.0.548 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4. August 2021 |
| 2.0.470 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 20. Juli 2021 |
| 2.0.285 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8. März 2021 |
| 2.0.207 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 2. Februar 2021 |
| 2.0.160 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4. Dezember 2020 |
| 2.0.153 | Fügt Sysprep-Funktionalität hinzu. UserData | 3. November 2020 |
| 2.0.146 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6. Oktober 2020 |
| 2.0.124 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 10. September 2020 |
| 2.0.104 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 12. August 2020 |
| 2.0.0 | Erstversion. | 30. Juni 2020 |