本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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-Restart
和Force-Stop
可用來重新啟動和停止具有相依服務的 服務。 -
StartupType
類型:字串
有效值:檢查 | 自動 | 需求 | 停用 | DelayedAutoStart
預設:Check
描述:(必要) 要套用至 Windows 服務的啟動類型。
-
WindowsServiceName
類型:字串
描述:(必要) 有效的 Windows 服務名稱。
必要的 IAM 許可
AutomationAssumeRole
參數需要下列動作才能成功使用 Runbook。
建議接收命令的 EC2 執行個體具備連接 AmazonSSMManagedInstanceCore Amazon 受管政策的 IAM 角色。使用者必須至少有 ssm:StartAutomationExecution 和 ssm:SendCommand 來執行自動化並將命令傳送至執行個體,加上 ssm:GetAutomationExecution,才能讀取自動化輸出。
文件步驟
aws:runCommand
- 執行 PowerShell 指令碼,將所需的組態套用至目標執行個體上的 Windows 服務。
輸出
manageWindowsService.Output