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

# `AWSSupport-ManageWindowsService`
<a name="automation-awssupport-managewindowsservice"></a>

 **Description** 

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

[執行此自動化 （主控台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-ManageWindowsService)

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Windows

**參數**
+ AutomationAssumeRole

  類型：字串

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

  類型：字串

  描述：（必要） 管理 服務的受管執行個體 ID。
+ ServiceAction

  類型：字串

  有效值：檢查 \$1 重新啟動 \$1 Force-Restart \$1 開始 \$1 停止 \$1 Force-Stop \$1 暫停

  預設：Check

  描述：（必要） 要套用至 Windows 服務的動作。請注意， `Force-Restart`和 `Force-Stop`可用來重新啟動和停止具有相依服務的 服務。
+ StartupType

  類型：字串

  有效值：檢查 \$1 自動 \$1 需求 \$1 停用 \$1 DelayedAutoStart

  預設：Check

  描述：（必要） 要套用至 Windows 服務的啟動類型。
+ WindowsServiceName

  類型：字串

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

**必要的 IAM 許可**

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

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

 **文件步驟** 

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

 **輸出** 

manageWindowsService.Output