Amazon EC2 Systems Manager
用户指南
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

如何使用共享的 Systems Manager 文档

共享 Systems Manager 文档时,系统将生成一个 Amazon 资源名称 (ARN) 并将其分配给命令。如果您从 Amazon EC2 控制台选择并执行共享文档,则不会看到此 ARN。但如果您要从命令行应用程序执行共享 Systems Manager 文档,则必须指定完整的 ARN。当您执行列出文档的命令时,将为您显示 Systems Manager 文档的完整 ARN。

注意

您无需为 AWS 公有文档 (以 AWS-* 开头的文档) 或您拥有的命令指定 ARN。

本部分中包含的示例说明如何通过 AWS CLI 和适用于 Windows PowerShell 的 AWS 工具查看和执行共享 Systems Manager 文档。

通过 AWS CLI 使用共享 Systems Manager 文档

列出所有公有 Systems Manager 文档

Copy
aws ssm list-documents --document-filter-list key=Owner,value=Public

列出已与您共享的私有 Systems Manager 文档

Copy
aws ssm list-documents --document-filter-list key=Owner,value=Private

列出可供您使用的所有 Systems Manager 文档

Copy
aws ssm list-documents --document-filter-list key=Owner,value=All

使用完整 ARN 通过共享 Systems Manager 文档执行命令

Copy
aws ssm send-command --document-name FullARN/name

例如:

Copy
aws ssm send-command --document-name arn:aws-cn:ssm:us-east-1:12345678912:document/highAvailabilityServerSetup --instance-ids i-12121212

通过适用于 Windows PowerShell 的 AWS 工具使用共享 Systems Manager 文档

列出所有公有 Systems Manager 文档

Copy
Get-SSMDocumentList -DocumentFilterList @(New-Object Amazon.SimpleSystemsManagement.Model.DocumentFilter("Owner", "Public"))

列出已与您共享的私有 Systems Manager 文档

Copy
Get-SSMDocumentList -DocumentFilterList @(New-Object Amazon.SimpleSystemsManagement.Model.DocumentFilter("Owner", "Private"))

获取有关已与您共享的 Systems Manager 文档的信息

Copy
Get-SSMDocument –Name FullARN/name

例如:

Copy
Get-SSMDocument –Name arn:aws-cn:ssm:us-east-1:12345678912:document/highAvailabilityServerSetup

获取已与您共享的 Systems Manager 文档的描述

Copy
Get-SSMDocumentDescription –Name FullARN/name

例如:

Copy
Get-SSMDocumentDescription –Name arn:aws-cn:ssm:us-east-1:12345678912:document/highAvailabilityServerSetup

使用完整 ARN 通过共享 Systems Manager 文档执行命令

Copy
Send-SSMCommand –DocumentName FullARN/name –InstanceId IDs

例如:

Copy
Send-SSMCommand –DocumentName arn:aws-cn:ssm:us-east-1:555450671542:document/highAvailabilityServerSetup –InstanceId @{"i-273d4e9e"}