

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.

# `AWSSupport-UpgradeWindowsAWSDrivers`
<a name="automation-awssupport-upgradewindowsawsdrivers"></a>

 **Beschreibung** 

Das `AWSSupport-UpgradeWindowsAWSDrivers` Runbook aktualisiert oder repariert Speicher- und AWS Netzwerktreiber auf der angegebenen EC2-Instance. Das Runbook versucht, die neuesten AWS Treiberversionen online zu installieren, indem es den SSM-Agenten aufruft. Wenn der SSM-Agent nicht erreichbar ist, kann das Runbook auf ausdrücklichen Wunsch eine Offline-Installation der AWS Treiber durchführen. 

 Dieses Runbook unterstützt die folgenden Betriebssysteme: 
+ Windows Server 2016
+ Windows Server 2019
+ Windows Server 2022
+ Windows Server 2025

**Anmerkung**  
Sowohl beim Online- als auch beim Offline-Upgrade wird vor dem Versuch, irgendwelche Operationen auszuführen, ein AMI erstellt, das auch nach Abschluss der Automatisierung fortbesteht. Es liegt in Ihrer Verantwortung, den Zugriff auf das AMI zu gewährleisten oder es zu löschen. Die Online-Methode startet die Instance als Teil des Upgrade-Prozesses neu, während die Offline-Methode erfordert, dass die bereitgestellte EC2-Instance angehalten und dann gestartet wird.

**Wichtig**  
Wenn Ihre Instances AWS Systems Manager mithilfe von VPC-Endpunkten eine Verbindung herstellen, schlägt dieses Runbook fehl, sofern es nicht in der Region us-east-1 verwendet wird. Dieses Runbook schlägt auch auf einem Domänencontroller fehl. Informationen zum Aktualisieren von AWS PV-Treibern auf einem Domänencontroller finden Sie unter [Upgrade eines Domänencontrollers (AWS PV-Upgrade)](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Upgrading_PV_drivers.html#aws-pv-upgrade-dc).

[Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-UpgradeWindowsAWSDrivers)

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

Windows

**Parameter**
+ AllowOffline

  Typ: Zeichenfolge

  Zulässige Werte: true \$1 false

  Standard: false

  Beschreibung: (Optional) Auf „true“ setzen, um eine Offline-Treiberaktualisierung zuzulassen, wenn die Online-Installation nicht durchgeführt werden kann. Hinweis: Die Offline-Methode erfordert, die bereitgestellte EC2-Instance anzuhalten und dann neu zu starten. Auf den Instance-Speichervolumes gespeicherte Daten gehen verloren. Die öffentliche IP-Adresse ändert sich, wenn Sie keine Elastic IP verwenden.
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
+ ForceUpgrade

  Typ: Zeichenfolge

  Zulässige Werte: true \$1 false

  Standard: false

  Beschreibung: (Optional) Nur Offline - Auf „true“ setzen, um zuzulassen, dass die Offline-Aktualisierung der Treiber fortgesetzt wird, auch wenn auf Ihrer Instance bereits die neuesten Treiber installiert sind.
+ InstanceId

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) ID Ihrer EC2-Instance für Windows Server.
+ SubnetId

  Typ: Zeichenfolge

  Standard: SelectedInstanceSubnet

  Beschreibung: (Optional) Nur offline — Die Subnetz-ID für die EC2 Rescue-Instanz, die für das Offline-Treiber-Upgrade verwendet wurde. Wenn keine Subnetz-ID angegeben ist, erstellt Systems Manager Automation eine neue VPC.
**Wichtig**  
Das Subnetz muss sich in derselben Availability Zone befinden wie InstanceId und es muss den Zugriff auf die SSM-Endpunkte ermöglichen.

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.

Die EC2-Instance, die den Befehl empfängt, muss mindestens über eine IAM-Rolle verfügen, die Berechtigungen für **ssm: StartAutomationExecution und **ssm:**** umfasst, SendCommand um die Automatisierung auszuführen und den Befehl an die Instance zu senden, sowie **ssm:, um die Automatisierungsausgabe GetAutomationExecution** lesen zu können. Sie können die von `AmazonSSMManagedInstanceCore` Amazon verwaltete Richtlinie an Ihre IAM-Rolle anhängen, um diese Berechtigungen bereitzustellen. Wir empfehlen jedoch, die Automation-IAM-Rolle `AmazonSSMAutomationRole` zu diesem Zweck zu verwenden. Weitere Informationen finden Sie unter [Verwenden von IAM](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-permissions.html) zur Konfiguration von Rollen für die Automatisierung.

Wenn Sie ein Offline-Upgrade durchführen, vgl. die für [`AWSSupport-StartEC2RescueWorkflow`](automation-awssupport-startec2rescueworkflow.md) erforderlichen Berechtigungen.

 **Dokumentschritte** 

1. `aws:assertAwsResourceProperty`— Überprüft, ob es sich bei der Eingabeinstanz um Windows handelt.

1. `aws:assertAwsResourceProperty`— Überprüft, ob es sich bei der Eingabeinstanz um eine verwaltete Instanz handelt. Wenn dies der Fall ist, beginnt das Online-Upgrade, oder das Offline-Upgrade wird evaluiert.

   1. (Online-Upgrade) Wenn die Input-Instance eine verwaltete Instance ist:

      1. `aws:createImage`- Erstellt ein AMI-Backup.

      1. `aws:createTags`- Markiert das AMI-Backup.

      1. `aws:runCommand`- Installiert den ENA-Netzwerktreiber.

      1. `aws:runCommand`- Installiert NVMe den Treiber.

      1. `aws:runCommand`- Installiert den AWS PV-Treiber.

   1. (Offline-Upgrade) Wenn die Input-Instance keine verwaltete Instance ist:

      1. `aws:assertAwsResourceProperty`- Überprüft, ob die AllowOffline Flagge auf `true` gesetzt ist. Wenn ja, wird das Offline-Upgrade gestartet, andernfalls endet die Automatisierung.

      1. `aws:changeInstanceState`- Stoppen Sie die Quellinstanz.

      1. `aws:changeInstanceState`- Erzwingen Sie das Stoppen der Quellinstanz.

      1. `aws:createImage`- Erstellen Sie ein AMI-Backup der Quell-Instance.

      1. `aws:createTags`- Kennzeichnen Sie das AMI-Backup der Quell-Instance.

      1. `aws:executeAwsApi`— Aktivieren Sie ENA für die Instanz

      1. `aws:assertAwsResourceProperty`— Bestätigen Sie die ForceUpgrade Flagge.

      1. Offline-Aktualisierung erzwingen) Wenn **ForceUpgrade = true**, dann ausführen`aws:executeAutomation`, um `AWSSupport-StartEC2RescueWorkflow` mit dem Treiber-Force-Upgrade-Skript aufzurufen. Dadurch werden Treiber unabhängig von der aktuellen Version installiert.

      1. (Offline-Upgrade) Wenn **ForceUpgrade = falsch**, dann ausführen, `aws:executeAutomation` um es `AWSSupport-StartEC2RescueWorkflow` mit dem Treiber-Upgrade-Skript aufzurufen.

 **Ausgaben** 

preUpgradeBackup.ImageId

preOfflineUpgradeBackup. ImageId

`installAwsEnaNetworkDriverOnInstance.Output`

`installAWSNVMeOnInstance.Output`

`installAWSPVDriverOnInstance.Output`

upgradeDriversOffline. Leistung

forceUpgradeDriversOffline. Ausgabe