使用共用的 SSM 文件
當您共用 AWS Systems Manager (SSM) 文件時,系統會產生 Amazon 資源名稱 (ARN),並指派給命令。如果您從 Systems Manager 主控台選取和執行共用文件,則不會看到 ARN。但是,如果您想要使用 Systems Manager 主控台以外的其他方法執行共用的 SSM 文件,則必須為 DocumentName
請求參數指定文件的完整 ARN。當您執行命令列出文件時,系統會顯示 SSM 文件的完整 ARN。
您不需要為 AWS 公有文件 (開頭為 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