使用共用的 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