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-v1-Agenten verwenden, um Aufgaben während des Starts einer EC2-Windows-Instance auszuführen
Amazon-verwaltete AMIs für Windows Server 2016 und 2019 enthalten eine Reihe von Windows-Powershell-Skripts mit der Bezeichnung EC2Launch. EC2Launch führt während des ersten Starts der Instance einige Aktionen durch. Informationen zu den EC2Launch-Versionen, die in AWS-Windows-AMIs enthalten sind, finden Sie in der AMI–Referenz für AWS Windows.
Anmerkung
Der neueste Start-Agent für Windows Server 2016 und spätere Betriebssystem-Versionen ist EC2Launch v2, der sowohl EC2Config als auch EC2Launch ersetzt und auf AMIs von AWS Windows Server 2016 und 2019 mit Namen, die mit EC2LaunchV2-Windows_Server-* beginnen, vorinstalliert ist. Sie können den Agent auch manuell auf Windows Server 2016 und 2019 installieren und konfigurieren. Weitere Informationen finden Sie unter EC2Launch v2 installieren.
Zur Verwendung von EC2Launch mit IMDSv2 muss die Version 1.3.2002730 oder höher vorhanden sein.
Sie können den folgenden Windows-PowerShell-Befehl verwenden, um die installierte Version von EC2Launch zu überprüfen.
Test-ModuleManifest -Path "C:\ProgramData\Amazon\EC2-Windows\Launch\Module\Ec2Launch.psd1" | Select Version
EC2Launch-Aufgaben
EC2Launch führt beim ersten Starten einer Instance standardmäßig die folgenden Aufgaben aus:
-
Richtet einen neuen Bildschirmhintergrund ein, der Informationen über die Instance gibt.
-
Setzt den Computernamen auf die private IPv4-Adresse der Instance.
-
Sendet Instance-Informationen an die Amazon EC2-Konsole.
-
Sendet den RDP-Zertifikat-Thumbprint an die EC2-Konsole.
-
Richtet ein zufälliges Passwort für das Administratorkonto ein.
-
Fügt DNS-Suffixe hinzu.
-
Erweitert die Betriebssystempartition dynamisch mit nicht partitioniertem Speicherplatz.
-
Führt Benutzerdaten aus (falls angegeben). Weitere Informationen zur Angabe von Benutzerdaten finden Sie unter Befehle ausführen, wenn Sie eine EC2 Instance mit Benutzerdateneingabe starten.
-
Stellt persistente statische Routen so ein, dass sie den Metadaten-Service und AWS KMS-Server erreichen.
Wichtig
Wenn aus dieser Instance ein benutzerdefiniertes AMI erstellt wird, werden diese Routen als Teil der OS-Konfiguration erfasst. Alle neuen Instances, die über dieses AMI gestartet werden, übernehmen ungeachtet der Subnetz-Platzierung dieselben Routen. Informationen zum Aktualisieren dieser Routen finden Sie unter Aktualisieren von Metadaten/KMS-Routen für Server 2016 und höher beim Starten eines benutzerdefinierten AMI.
Die folgenden Aufgaben tragen dazu bei, die Abwärtskompatibilität mit dem EC2Config-Service zu erhalten. Sie können EC2Launch auch zur Ausführung dieser Aufgaben beim Startup konfigurieren:
-
Initialisieren von sekundären EBS-Volumes.
-
Senden von Windows-Ereignisprotokollen an die EC2-Konsolenprotokolle.
-
Senden der Windows ist einsatzbereit-Meldung an die EC2-Konsole.
EC2Launch-Verzeichnisstruktur
EC2Launch wird bei AMIs mit Windows Server 2016 und höher standardmäßig im Stammverzeichnis installier C:\ProgramData\Amazon\EC2-Windows\Launch.
Anmerkung
Windows blendet Dateien und Ordner unter standardmäßig au C:\ProgramData. Um die EC2Launch-Verzeichnisse und -Dateien anzuzeigen, müssen Sie entweder den Pfad im Windows Explorer eingeben oder die Ordnereigenschaften so ändern, dass ausgeblendete Dateien und Ordner angezeigt werden.
Das Verzeichnis Launch enthält die folgenden Unterverzeichnisse.
-
Scripts— Enthält die PowerShell-Scripts, aus denen EC2Launch besteht. -
Module— Enthält das Modul zum Aufbau von Amazon EC2-Scripts. -
Config— Enthält Script-Konfigurationsdateien, die Sie anpassen können. -
Sysprep— Enthält Sysprep-Ressourcen. -
Settings— Enthält eine Anwendung für die grafische Benutzeroberfläche von Sysprep. -
Library: Enthält freigegebene Bibliotheken für EC2-Startagenten. -
Log– Enthält Unterverzeichnisse für Skripts und die Protokolldateien, die von den Skripten generiert werden.
Telemetrie
Telemetrie ist zusätzliche Information, die AWS hilft, Ihre Anforderungen besser zu verstehen, Probleme zu diagnostizieren und Features bereitzustellen, um Ihre Erfahrung mit AWS-Services zu verbessern.
EC2Launch-Version 1.3.2003498 und später erfassen Telemetriedaten wie Nutzungsmetriken und Fehler. Diese Daten werden von der Amazon-EC2-Instance erfasst, auf der EC2Launch ausgeführt wird. Dies umfasst alle Windows-AMIs, die gehören AWS.
EC2Launch erfasst folgende Telemetrie-Typen:
-
Nutzungsinformationen – Agent-Befehle, Installationsmethode und geplante Ausführungsfrequenz.
-
Fehler und Diagnoseinformationen – Agent-Installation und Ausführen von Fehlercodes.
Beispiele für die gesammelten Daten:
2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsUserDataScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandCode=1
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandErrorCode=5
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallCode=2
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallErrorCode=0Die Telemetrie ist standardmäßig aktiviert. Sie können die Telemetriesammlung jederzeit deaktivieren. Wenn Telemetrie aktiviert ist, sendet EC2Launch Telemetriedaten ohne zusätzliche Kundenbenachrichtigungen.
Ihre Entscheidung, Telemetrie zu aktivieren oder zu deaktivieren, wird erfasst.
Sie können die Telemetriesammlung aktivieren oder deaktivieren. Ihre Auswahl zur Aktivierung bzw. Deaktivierung von Telemetrie wird erfasst, um sicherzustellen, dass wir die festgelegte Option einhalten.
Telemetrie-Sichtbarkeit
Wenn Telemetrie aktiviert ist, wird sie in der Ausgabe der Amazon-EC2-Konsole wie folgt angezeigt:
2021/07/15 21:44:12Z: Telemetry: <Data>
Deaktivieren der Telemetrie auf einer Instance
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 während der Installation zu deaktivieren, führen Sie install.ps1 wie folgt aus:
. .\install.ps1 -EnableTelemetry:$false
Weitere Themen für EC2Launch
