Verwenden Sie den EC2 Launch v1-Agent, um Aufgaben während des Starts der EC2 Windows-Instanz auszuführen - Amazon Elastic Compute Cloud

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.

Verwenden Sie den EC2 Launch v1-Agent, um Aufgaben während des Starts der EC2 Windows-Instanz auszuführen

Amazon Managed AMIs for Windows Server 2016 und 2019 enthält eine Reihe von Windows Powershell-Skripts namens EC2 Launch. EC2Launch führt Aufgaben beim ersten Start der Instance aus. Informationen zu den EC2 Launch-Versionen, die in AWS Windows enthalten sind AMIs, finden Sie in der AWS Windows AMI-Referenz. Die Änderungen für die einzelnen Versionen von AWS Windows AMIs finden Sie im AWS Windows AMI-Versionsverlauf.

Anmerkung

Der neueste Startagent für Windows Server 2016 und spätere Betriebssystemversionen ist EC2 Launch v2, der sowohl EC2 Config als auch EC2 Launch ersetzt und auf AWS Windows Server 2016 und 2019 vorinstalliert ist, dessen Namen AMIs mit EC2LaunchV2-Windows_Server-* beginnen. Sie können auch Migrieren Sie zu EC2Launch v2 mit dem Migrationstool oder manuell auf Windows Server 2016 und 2019 installieren und konfigurieren.

Um EC2 Launch with verwenden zu können IMDSv2, muss die Version 1.3.2002730 oder höher sein.

Sie können den folgenden PowerShell Windows-Befehl verwenden, um die installierte Version von Launch zu überprüfen. EC2

Test-ModuleManifest -Path "C:\ProgramData\Amazon\EC2-Windows\Launch\Module\Ec2Launch.psd1" | Select Version

EC2Aufgaben starten

EC2Launch führt beim ersten Start der Instanz 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 Instanz.

  • Sendet Instance-Informationen an die EC2 Amazon-Konsole.

  • Sendet den Fingerabdruck des RDP-Zertifikats an die Konsole. EC2

  • 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.

  • Legt persistente statische Routen fest, um den Metadatendienst und die Server zu erreichen. AWS KMS

    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 EC2 Config-Dienst aufrechtzuerhalten. Sie können EC2 Launch auch so konfigurieren, dass diese Aufgaben beim Start ausgeführt werden:

  • Initialisieren von sekundären EBS-Volumes.

  • Senden Sie Windows-Ereignisprotokolle an die EC2 Konsolenprotokolle.

  • Senden Sie die Meldung „Windows ist einsatzbereit“ an die EC2 Konsole.

EC2Starten Sie die Verzeichnisstruktur

EC2Launch ist standardmäßig auf Windows Server 2016 und höher AMIs im Stammverzeichnis installiertC:\ProgramData\Amazon\EC2-Windows\Launch.

Anmerkung

Windows blendet Dateien und Ordner unter C:\ProgramData standardmäßig aus. Um EC2 Startverzeichnisse und Dateien anzuzeigen, müssen Sie entweder den Pfad in Windows Explorer eingeben oder die Ordnereigenschaften so ändern, dass versteckte Dateien und Ordner angezeigt werden.

Das Verzeichnis Launch enthält die folgenden Unterverzeichnisse.

  • Scripts— Enthält die PowerShell Skripts, aus denen EC2 Launch besteht.

  • Module— Enthält das Modul zum Erstellen von Skripten im Zusammenhang mit Amazon EC2.

  • 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 gemeinsam genutzte Bibliotheken für EC2 Launch-Agenten.

  • Logs — Enthält von Scripts generierte Protokolldateien.

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 denen Sie Ihre AWS Dienste noch besser nutzen können.

EC2Starten Sie die Version 1.3.2003498 und erfassen Sie später Telemetriedaten, z. B. Nutzungsmetriken und Fehler. Diese Daten werden von der EC2 Amazon-Instance gesammelt, auf der EC2 Launch ausgeführt wird. Dies schließt alle Windows ein, die AMIs Eigentum von sind AWS.

Die folgenden Telemetriearten werden von EC2 Launch erfasst:

  • 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=0

Die Telemetrie ist standardmäßig aktiviert. Sie können die Telemetriesammlung jederzeit deaktivieren. Wenn Telemetrie aktiviert ist, sendet EC2 Launch 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 EC2 Amazon-Konsolenausgabe 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