AWSSupport-ManageWindowsService - AWS Systems Manager 自動化 Runbook 參考

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

AWSSupport-ManageWindowsService

Description

AWSSupport-ManageWindowsService Runbook 可讓您停止、啟動、重新啟動、暫停或停用目標執行個體上的任何 Windows 服務。

執行此自動化 (主控台)

文件類型

 自動化

擁有者

Amazon

平台

Windows

參數

  • AutomationAssumeRole

    類型:字串

    描述:(選用) 允許 Systems Manager Automation 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。如果未指定角色,Systems Manager Automation 會使用啟動此 Runbook 的使用者許可。

  • InstanceId

    類型:字串

    描述:(必要) 管理 服務的受管執行個體 ID。

  • ServiceAction

    類型:字串

    有效值:檢查 | 重新啟動 | Force-Restart | 開始 | 停止 | Force-Stop | 暫停

    預設:Check

    描述:(必要) 要套用至 Windows 服務的動作。請注意, Force-RestartForce-Stop可用來重新啟動和停止具有相依服務的 服務。

  • StartupType

    類型:字串

    有效值:檢查 | 自動 | 需求 | 停用 | DelayedAutoStart

    預設:Check

    描述:(必要) 要套用至 Windows 服務的啟動類型。

  • WindowsServiceName

    類型:字串

    描述:(必要) 有效的 Windows 服務名稱。

必要的 IAM 許可

AutomationAssumeRole 參數需要下列動作才能成功使用 Runbook。

建議接收命令的 EC2 執行個體具備連接 AmazonSSMManagedInstanceCore Amazon 受管政策的 IAM 角色。使用者必須至少有 ssm:StartAutomationExecutionssm:SendCommand 來執行自動化並將命令傳送至執行個體,加上 ssm:GetAutomationExecution,才能讀取自動化輸出。

文件步驟

aws:runCommand - 執行 PowerShell 指令碼,將所需的組態套用至目標執行個體上的 Windows 服務。

輸出

manageWindowsService.Output