Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门。使用共享 SSM 文档
共享 Amazon Systems Manager (SSM) 文档时,系统将生成一个 Amazon Resource Name (ARN) 并将其分配给命令。如果您从 Systems Manager 控制台选择并运行某个共享文档,则不会看到此 ARN。但如果您要使用 Systems Manager 控制台以外的方法运行共享 SSM 文档,则必须在 DocumentName
请求参数中指定文档的完整 ARN。当您运行列出文档的命令时,将为您显示 SSM 文档的完整 ARN。
您无需为 Amazon 公有文档(以 AWS-*
开头的文档)或您拥有的文档指定 ARN。
使用共享 SSM 文档(命令行)
列出所有公有 SSM 文档
- Linux & macOS
-
aws ssm list-documents \
--filters Key=Owner,Values=Public
- Windows
-
aws ssm list-documents ^
--filters Key=Owner,Values=Public
- PowerShell
-
$filter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$filter.Key = "Owner"
$filter.Values = "Public"
Get-SSMDocumentList `
-Filters @($filter)
列出已与您共享的私有 SSM 文档
- Linux & macOS
-
aws ssm list-documents \
--filters Key=Owner,Values=Private
- Windows
-
aws ssm list-documents ^
--filters Key=Owner,Values=Private
- PowerShell
-
$filter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$filter.Key = "Owner"
$filter.Values = "Private"
Get-SSMDocumentList `
-Filters @($filter)
列出可供您使用的所有 SSM 文档
- Linux & macOS
-
aws ssm list-documents
- Windows
-
aws ssm list-documents
- PowerShell
-
Get-SSMDocumentList
获取有关已与您共享的 SSM 文档的信息
- Linux & macOS
-
aws ssm describe-document \
--name arn:aws:ssm:us-east-2:12345678912:document/documentName
- Windows
-
aws ssm describe-document ^
--name arn:aws:ssm:us-east-2:12345678912:document/documentName
- PowerShell
-
Get-SSMDocumentDescription `
–Name arn:aws:ssm:us-east-2:12345678912:document/documentName
运行共享的 SSM 文档
- Linux & macOS
-
aws ssm send-command \
--document-name arn:aws:ssm:us-east-2:12345678912:document/documentName
\
--instance-ids ID
- Windows
-
aws ssm send-command ^
--document-name arn:aws:ssm:us-east-2:12345678912:document/documentName
^
--instance-ids ID
- PowerShell
-
Send-SSMCommand `
–DocumentName arn:aws:ssm:us-east-2:12345678912:document/documentName
`
–InstanceIds ID