Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅
中国的 Amazon Web Services 服务入门
(PDF)。
• Amazon Systems Manager Change Manager 不再向新客户开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 Amazon Systems Manager Change Manager 可用性变更。
• Amazon Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 Amazon CloudWatch 控制面板文档。
将 StartAutomationExecution 与 CLI 配合使用
以下代码示例演示如何使用 StartAutomationExecution。
- CLI
-
- Amazon CLI
-
示例 1：执行自动化文档
以下 start-automation-execution 示例运行自动化文档。
aws ssm start-automation-execution \
--document-name "AWS-UpdateLinuxAmi" \
--parameters "AutomationAssumeRole=arn:aws:iam::123456789012:role/SSMAutomationRole,SourceAmiId=ami-EXAMPLE,IamInstanceProfileName=EC2InstanceRole"
输出：
{
"AutomationExecutionId": "4105a4fc-f944-11e6-9d32-0a1b2EXAMPLE"
}
有关更多信息，请参阅《Amazon Systems Manager 用户指南》中的手动运行自动化工作流。
示例 2：运行共享自动化文档
以下 start-automation-execution 示例运行一个共享的自动化文档。
aws ssm start-automation-execution \
--document-name "arn:aws:ssm:us-east-1:123456789012:document/ExampleDocument"
输出：
{
"AutomationExecutionId": "4105a4fc-f944-11e6-9d32-0a1b2EXAMPLE"
}
有关更多信息，请参阅《Amazon Systems Manager 用户指南》中的使用共享 SSM 文档。
- PowerShell
-
- 适用于 PowerShell V4 的工具
-
示例 1：此示例运行一个文档，指定自动化角色、AMI 源 ID 和 Amazon EC2 实例角色。
Start-SSMAutomationExecution -DocumentName AWS-UpdateLinuxAmi -Parameter @{'AutomationAssumeRole'='arn:aws:iam::123456789012:role/SSMAutomationRole';'SourceAmiId'='ami-f173cc91';'InstanceIamRole'='EC2InstanceRole'}
输出：
3a532a4f-0382-11e7-9df7-6f11185f6dd1
- 适用于 PowerShell V5 的工具
-
示例 1：此示例运行一个文档，指定自动化角色、AMI 源 ID 和 Amazon EC2 实例角色。
Start-SSMAutomationExecution -DocumentName AWS-UpdateLinuxAmi -Parameter @{'AutomationAssumeRole'='arn:aws:iam::123456789012:role/SSMAutomationRole';'SourceAmiId'='ami-f173cc91';'InstanceIamRole'='EC2InstanceRole'}
输出：
3a532a4f-0382-11e7-9df7-6f11185f6dd1
有关 Amazon SDK 开发人员指南和代码示例的完整列表，请参阅 将此服务与 Amazon SDK 结合使用 本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。