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-ActivateWindowsWithAmazonLicense`
<a name="automation-awssupport-activatewindowswithamazonlicense"></a>

 **Beschreibung** 

Das `AWSSupport-ActivateWindowsWithAmazonLicense` Runbook aktiviert eine Amazon Elastic Compute Cloud (Amazon EC2) -Instance für Windows Server mit einer von Amazon bereitgestellten Lizenz. Die Automatisierung überprüft und konfiguriert die erforderlichen Betriebssystemeinstellungen des Schlüsselverwaltungsdienstes und versucht die Aktivierung. Dazu gehören Betriebssystemrouten zu den Schlüsselverwaltungsservern von Amazon und die Betriebssystemeinstellungen des Schlüsselverwaltungsdienstes. Wenn der `AllowOffline` Parameter auf gesetzt wird, `true` kann die Automatisierung erfolgreich auf Instances abzielen, die nicht von der Instance verwaltet werden AWS Systems Manager, sondern die einen Stopp und Start der Instance erfordern.

**Anmerkung**  
Dieses Runbook kann nicht für das Modell Bring Your Own License (BYOL) verwendet werden Windows Server Instanzen. Informationen zur Verwendung Ihrer eigenen Lizenz finden Sie unter [Microsoft-Lizenzierung in AWS](https://aws.amazon.com/windows/resources/licensing/). 

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

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

Windows

**Parameter**
+ AllowOffline

  Typ: Zeichenfolge

  Zulässige Werte: true \$1 false

  Standard: false

  Beschreibung: (Optional) Legen Sie diese Option fest, `true` wenn Sie eine Wiederherstellung der Windows-Aktivierung im Offlinemodus zulassen, falls die Online-Problembehandlung fehlschlägt oder wenn es sich bei der bereitgestellten Instanz nicht um eine verwaltete Instanz handelt.
**Wichtig**  
Die Offline-Methode erfordert, dass die bereitgestellte EC2 Instanz gestoppt und dann gestartet wird. 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.
+ ForceActivation

  Typ: Zeichenfolge

  Zulässige Werte: true \$1 false

  Standard: false

  Beschreibung: (Optional) Stellen Sie diese Option ein, `true` wenn Sie fortfahren möchten, auch wenn Windows bereits aktiviert ist.
+ InstanceId

  Typ: Zeichenfolge

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

  Typ: Zeichenfolge

  Standard: CreateNew VPC

  Beschreibung: (Optional) Nur offline — Die Subnetz-ID für die EC2 Rescue-Instanz, die zur Durchführung der Offline-Fehlerbehebung verwendet wurde. Verwenden Sie `SelectedInstanceSubnet` es, um dasselbe Subnetz wie Ihre Instance zu verwenden, oder verwenden Sie es, `CreateNewVPC` um eine neue VPC zu erstellen. 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.

Wir empfehlen, dass die EC2 Instance, die den Befehl empfängt, über eine IAM-Rolle verfügt, der die von **SSMManagedInstanceCoreAmazon** verwaltete Richtlinie beigefügt ist. Sie benötigen mindestens **ssm: StartAutomationExecution und **ssm:****, SendCommand um die Automatisierung auszuführen und den Befehl an die Instance zu senden, sowie über **ssm:**, GetAutomationExecution um die Automatisierungsausgabe lesen zu können. Informationen zur Offline-Behebung finden Sie unter den erforderlichen Berechtigungen von. `AWSSupport-StartEC2RescueWorkflow`

 **Dokumentschritte** 

1. `aws:assertAwsResourceProperty`— Vergewissern Sie sich, dass die Plattform der bereitgestellten Instanz Windows ist.

1. `aws:assertAwsResourceProperty`- Vergewissern Sie sich, dass es sich bei der bereitgestellten Instanz um eine verwaltete Instanz handelt:

   1. (Korrektur der Online-Aktivierung) Wenn es sich bei der Eingabeinstanz `aws:runCommand` um eine verwaltete Instanz handelt, führen Sie das PowerShell Skript aus, um zu versuchen, die Windows-Aktivierung zu korrigieren.

   1. (Offline-Aktivierungsreparatur) Wenn die Eingabe-Instance keine verwaltete Instance ist:

      1. `aws:assertAwsResourceProperty`— Überprüft, ob die `AllowOffline` Markierung auf `true` gesetzt ist. Wenn ja, wird der Offline-Fix gestartet; andernfalls endet die Automatisierung.

      1. `aws:executeAutomation`- Rufen Sie es `AWSSupport-StartEC2RescueWorkflow` mit dem Offline-Fix-Skript für die Windows-Aktivierung auf. Das Skript verwendet je nach Betriebssystemversion entweder EC2 Config oder EC2 Launch.

      1. `aws:executeAwsApi`- Lesen Sie das Ergebnis von`AWSSupport-StartEC2RescueWorkflow`.

 **Ausgaben** 

activateWindows.Output

getActivateWindowsOfflineResult. Ausgabe