AWSSupport-ManageWindowsService - AWS Systems Manager Referenz zum Automatisierungs-Runbook

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

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)

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 | Restart | Force-Restart | Start | Stop | Force-Stop | 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 | Auto | Demand | Disabled | 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