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

Das AWSSupport-ManageWindowsService Runbook ermöglicht es Ihnen, jeden Windows-Dienst auf der Zielinstanz zu beenden, zu starten, neu zu starten, anzuhalten oder zu deaktivieren.

Diese Automatisierung ausführen (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, die es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen auszuführen. 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, von der 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 wird. Beachten Sie, dass Force-Restart und verwendet werden Force-Stop kann, um einen Dienst neu zu starten und zu beenden, der abhängige Dienste hat.

  • StartupType

    Typ: Zeichenfolge

    Gültige Werte: Prüfen | Automatisch | Nachfrage | Deaktiviert | 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, an die die von ManagedInstanceCore Amazon verwaltete AmazonSSM-Richtlinie angehängt ist. Der Benutzer muss mindestens über ssm: StartAutomationExecution und ssm: verfügen, SendCommand um die Automatisierung auszuführen und den Befehl an die Instanz 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.Ausgang