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

 **Beschreibung** 

Mit dem `AWSSupport-ManageWindowsService` Runbook können Sie jeden Windows-Dienst auf der Zielinstanz beenden, starten, neu starten, anhalten oder deaktivieren.

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

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

Windows

**Parameter**
+ 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.
+ InstanceId

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Die ID der verwalteten Instanz, für die die Dienste verwaltet werden sollen.
+ ServiceAction

  Typ: Zeichenfolge

  Gültige Werte: Check \$1 Restart \$1 Force-Restart \$1 Start \$1 Stop \$1 Force-Stop \$1 Pause

  Standard: Check

  Beschreibung: (Erforderlich) Eine Aktion, die auf den Windows-Dienst angewendet werden soll. Beachten Sie, dass `Force-Restart` und verwendet werden `Force-Stop` kann, um einen Dienst, der abhängige Dienste hat, neu zu starten und zu beenden. 
+ StartupType

  Typ: Zeichenfolge

  Gültige Werte: Check \$1 Auto \$1 Demand \$1 Disabled \$1 DelayedAutoStart

  Standard: Check

  Beschreibung: (Erforderlich) Ein Starttyp, der auf den Windows-Dienst angewendet werden soll.
+ WindowsServiceName

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Ein gültiger Windows-Service-Name.

**Erforderliche IAM-Berechtigungen**

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

Es wird empfohlen, dass die EC2 Instance, die den Befehl empfängt, über eine IAM-Rolle verfügt, der die von **SSMManagedInstanceCoreAmazon** verwaltete Richtlinie beigefügt ist. Der Benutzer muss mindestens über **ssm: StartAutomationExecution und **ssm:**** verfügen, 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.

 **Dokumentschritte** 

`aws:runCommand`- Führen Sie das PowerShell Skript aus, um die gewünschte Konfiguration auf den Windows-Dienst auf der Zielinstanz anzuwenden.

 **Ausgaben** 

manageWindowsService. Ausgabe