使用文件版本參數執行命令 - AWS Systems Manager

使用文件版本參數執行命令

您可以使用文件版本參數來在命令執行時，指定要使用的 AWS Systems Manager 文件版本。您可為此參數指定下列其中一個選項：

  • $DEFAULT

  • $LATEST

  • 版本編號

請執行以下處理程序來使用文件版本參數執行命令。

Linux

在本機 Linux 機器上使用 AWS CLI 執行命令

  1. 如果您尚未安裝並設定 AWS Command Line Interface (AWS CLI)，請進行相應的操作。

    如需相關資訊，請參閱安裝或升級 AWS 命令列工具。

  2. 列出所有可用的文件

    此命令會列出根據 AWS Identity and Access Management (IAM) 許可適用於您帳戶的所有文件。

    aws ssm list-documents

  3. 執行下列命令來檢視不同版本的文件。

    aws ssm list-document-versions \
    --name "document-name"

  4. 執行下列命令來執行使用 SSM 文件版本的命令。

    aws ssm send-command \
    --document-name "AWS-RunShellScript" \
    --parameters commands="echo Hello" \
    --instance-ids instance-ID \
    --document-version '$LATEST'
Windows

在本機 Windows 機器上使用 AWS CLI 執行命令

  1. 如果您尚未安裝並設定 AWS Command Line Interface (AWS CLI)，請進行相應的操作。

    如需相關資訊，請參閱安裝或升級 AWS 命令列工具。

  2. 列出所有可用的文件

    此命令會列出根據 AWS Identity and Access Management (IAM) 許可適用於您帳戶的所有文件。

    aws ssm list-documents

  3. 執行下列命令來檢視不同版本的文件。

    aws ssm list-document-versions ^
    --name "document-name"

  4. 執行下列命令來執行使用 SSM 文件版本的命令。

    aws ssm send-command ^
    --document-name "AWS-RunShellScript" ^
    --parameters commands="echo Hello" ^
    --instance-ids instance-ID ^
    --document-version "$LATEST"
PowerShell

使用 Tools for PowerShell 執行命令

  1. 如果您尚未安裝並設定 AWS Tools for PowerShell，請進行相應的操作。

    如需相關資訊，請參閱安裝或升級 AWS 命令列工具。

  2. 列出所有可用的文件

    此命令會列出根據 AWS Identity and Access Management (IAM) 許可適用於您帳戶的所有文件。

    Get-SSMDocumentList

  3. 執行下列命令來檢視不同版本的文件。

    Get-SSMDocumentVersionList `
    -Name "document-name"

  4. 執行下列命令來執行使用 SSM 文件版本的命令。

    Send-SSMCommand `
    -DocumentName "AWS-RunShellScript" `
    -Parameter @{commands = "echo helloWorld"} `
    -InstanceIds "instance-ID" `
    -DocumentVersion $LATEST