AWS Systems Manager
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWSSupport-ManageWindowsService

描述

AWSSupport-ManageWindowsService Automation 文档能够让用户在目标实例上停止、启动、重启、暂停或禁用任何 Windows 服务。

文档类型

Automation

所有者

Amazon

平台

Windows

参数

  • 实例 ID

    类型:字符串

    说明:(必需)要管理其 RDP 设置的托管实例的 ID。

  • WindowsServiceName

    类型:字符串

    说明:(必需)有效的 Windows 服务名称。

  • StartupType

    类型:字符串

    允许的值:Check、Auto、Demand、Disabled、DelayedAutoStart

    默认值:Check

    说明:(必需)要应用于 Windows 服务的启动类型:Auto、Demand (Manual)、Disabled、DelayAutoStart、Check。

  • ServiceAction

    类型:字符串

    允许的值:Check、Restart、Force-Restart、Start、Stop、Force-Stop、Pause

    默认值:Check

    说明:(必需)要应用于 Windows 服务的操作:Restart、Force-Restart、Start、Stop、Force-Stop、Pause、Check。注意:Force-Restart 和 Force-Stop 可用于重启和停止具有从属服务的服务。

  • AutomationAssumeRole

    类型:字符串

    说明:(可选)此执行的 IAM 角色。如果未指定任何角色,则 AWS Systems Manager Automation 将使用运行此文档的用户的权限。

示例

检查 RDP 设置

aws ssm start-automation-execution --document-name "AWSSupport-ManageWindowsService" --parameters "InstanceId=i-1234567890abcdef0, WindowsServiceName=TermService"

将 TermService 的启动类型更改为 Auto,并将服务操作更改为 Start

aws ssm start-automation-execution --document-name "AWSSupport-ManageWindowsService" --parameters "InstanceId=i-1234567890abcdef0, WindowsServiceName=TermService, StartupType=Auto, ServiceAction=Start"

检索执行输出

aws ssm get-automation-execution --automation-execution-id EXECUTIONID --output text --query 'AutomationExecution.Output'

所需的 IAM 权限

建议接收命令的 EC2 实例具有一个附加了 AmazonSSMManagedInstanceCore Amazon 托管策略的 IAM 角色。用户必须至少具有 ssm:ExecuteAutomationssm:SendCommand 才能运行此 Automation 并将命令发送到实例,并且需要具有 ssm:GetAutomationExecution 才能读取 Automation 输出。

文档步骤

aws:runCommand – 运行 PowerShell 脚本来将所需配置应用到目标实例上的 Windows 服务。

输出

manageWindowsService.Output