特定のドキュメントバージョンを使用したコマンドの実行 - AWS Systems Manager

特定のドキュメントバージョンを使用したコマンドの実行

ドキュメントバージョンパラメータを使用して、コマンドの実行時に使用する AWS Systems Manager ドキュメントのバージョンを指定できます。このパラメータに指定できるオプションは以下のとおりです。

  • $DEFAULT

  • $LATEST

  • バージョン番号

ドキュメントバージョンパラメータを使用してコマンドを実行するには、次の手順を実行します。

Linux
ローカルの Linux マシンで AWS CLI を使用してコマンドを実行するには
  1. まだ AWS Command Line Interface (AWS CLI) をインストールして設定していない場合は、インストールして設定します。

    詳細については、「AWS CLI の最新バージョンをインストールまたは更新します。」を参照してください。

  2. 利用可能なすべてのドキュメントを表示します。

    このコマンドでは、AWS Identity and Access Management(IAM) アクセス許可に基づいて、アカウントで利用可能なすべてのドキュメントが表示されます。

    aws ssm list-documents
  3. ドキュメントのバージョンを一覧表示するには、次のコマンドを実行します。document name を自分の情報に置き換えます。

    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 CLI の最新バージョンをインストールまたは更新します。」を参照してください。

  2. 利用可能なすべてのドキュメントを表示します。

    このコマンドでは、AWS Identity and Access Management(IAM) アクセス許可に基づいて、アカウントで利用可能なすべてのドキュメントが表示されます。

    aws ssm list-documents
  3. ドキュメントのバージョンを一覧表示するには、次のコマンドを実行します。document name を自分の情報に置き換えます。

    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 (Tools for Windows PowerShell) をインストールして設定します (まだインストールしていない場合)。

    詳細については、「AWS Tools for PowerShell のインストール」を参照してください。

  2. 利用可能なすべてのドキュメントを表示します。

    このコマンドでは、AWS Identity and Access Management(IAM) アクセス許可に基づいて、アカウントで利用可能なすべてのドキュメントが表示されます。

    Get-SSMDocumentList
  3. ドキュメントのバージョンを一覧表示するには、次のコマンドを実行します。document name を自分の情報に置き換えます。

    Get-SSMDocumentVersionList ` -Name "document name"
  4. SSM ドキュメントバージョンを実行するコマンドを実行するには、次のコマンドを使用します。各リソースプレースホルダーの例をユーザー自身の情報に置き換えます。

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