• AWS Systems Manager CloudWatch ダッシュボードは、2026 年 4 月 30 日以降は利用できなくなります。お客様は、これまでと同様に Amazon CloudWatch コンソールを使用して、Amazon CloudWatch ダッシュボードの表示、作成、管理を継続できます。詳細については、「[Amazon CloudWatch ダッシュボードのドキュメント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)」を参照してください。 # `aws:runCommand` – マネージドインスタンスでコマンドを実行する 指定されたコマンドを実行します。 **注記** オートメーションは、1 つの AWS Systems Manager Run Command アクションの*Output*のみをサポートします。Runbook には、複数の Run Command アクションを含めることができますが、Output がサポートされるのは一度に 1 つのアクションに対してのみです。 **Input** このアクションでは、ほとんどの Send Command Parameters がサポートされています。詳細については、「[SendCommand](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_SendCommand.html)」を参照してください。 ------ #### [ YAML ] ``` - name: checkMembership action: 'aws:runCommand' inputs: DocumentName: AWS-RunPowerShellScript InstanceIds: - '{{InstanceIds}}' Parameters: commands: - (Get-WmiObject -Class Win32_ComputerSystem).PartOfDomain ``` ------ #### [ JSON ] ``` { "name": "checkMembership", "action": "aws:runCommand", "inputs": { "DocumentName": "AWS-RunPowerShellScript", "InstanceIds": [ "{{InstanceIds}}" ], "Parameters": { "commands": [ "(Get-WmiObject -Class Win32_ComputerSystem).PartOfDomain" ] } } } ``` ------ DocumentName コマンドタイプドキュメントの所有者が、お客様または AWS の場合は、ドキュメントの名前を指定します。別の AWS アカウント から共有されたドキュメントを使用している場合は、そのドキュメントの Amazon リソースネーム (ARN) を指定します。共有ドキュメントの使用方法については、「[共有 SSM ドキュメントを使用する](documents-ssm-sharing.md#using-shared-documents)」を参照してください。 型: 文字列 必須: はい InstanceIds コマンドを実行するインスタンス ID です。最大 50 の ID を指定できます。 インスタンス ID の代わりに擬似パラメータ `{{RESOURCE_ID}}` を使用して、ターゲットグループ内のすべてのインスタンスでコマンドを実行することもできます。疑似 Parameters の詳細については、「[メンテナンスウィンドウのタスクを登録する際の疑似パラメータの使用](maintenance-window-tasks-pseudo-parameters.md)」を参照してください。 他に、`Targets` パラメータを使用して、コマンドをインスタンスのフリートに送信する方法もあります。`Targets` パラメータは、Amazon Elastic Compute Cloud (Amazon EC2) タグを受け入れます。`Targets` パラメータの使用方法の詳細については、「[コマンドを大規模に実行する](send-commands-multiple.md)」を参照してください。 タイプ: StringList 必須: いいえ (InstanceId を指定しない場合、または `{{RESOURCE_ID}}` 擬似パラメータを使用する場合は、`Targets` パラメータを指定する必要があります)。 Targets 指定した Key、Value の組み合わせを使用してインスタンスを対象とする検索条件の配列です。呼び出しにインスタンス ID を 1 つも指定しない場合は、`Targets` が必要です。`Targets` パラメータの使用方法の詳細については、「[コマンドを大規模に実行する](send-commands-multiple.md)」を参照してください。 タイプ: MapList (リスト内のマップのスキーマはオブジェクトと一致する必要があります)。詳細については、*AWS Systems Manager API リファレンス*の「[ターゲット](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_Target.html)」を参照してください。 必須: いいえ (`Targets` を指定しない場合は、InstanceId を指定するか、`{{RESOURCE_ID}}` 擬似パラメータを使用する必要があります)。 次に例を示します。 ``` - name: checkMembership action: aws:runCommand inputs: DocumentName: AWS-RunPowerShellScript Targets: - Key: tag:Stage Values: - Gamma - Beta - Key: tag-key Values: - Suite Parameters: commands: - (Get-WmiObject -Class Win32_ComputerSystem).PartOfDomain ``` ``` { "name": "checkMembership", "action": "aws:runCommand", "inputs": { "DocumentName": "AWS-RunPowerShellScript", "Targets": [ { "Key": "tag:Stage", "Values": [ "Gamma", "Beta" ] }, { "Key": "tag:Application", "Values": [ "Suite" ] } ], "Parameters": { "commands": [ "(Get-WmiObject -Class Win32_ComputerSystem).PartOfDomain" ] } } } ``` Parameters ドキュメントに指定されている必須およびオプションの Parameters。 型: マップ 必須: いいえ CloudWatchOutputConfig Amazon CloudWatch Logs にコマンド Output を送信するための設定オプション。CloudWatch Logs への Command Output 送信の詳細については、「[Run Command の Amazon CloudWatch Logs の設定](sysman-rc-setting-up-cwlogs.md)」を参照してください。 タイプ: StringMap (マップのスキーマはオブジェクトと一致する必要があります。詳細については、*AWS Systems Manager API リファレンス*の「[CloudWatchOutputConfig](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_CloudWatchOutputConfig.html)」を参照してください)。 必須: いいえ 次に例を示します。 ``` - name: checkMembership action: aws:runCommand inputs: DocumentName: AWS-RunPowerShellScript InstanceIds: - "{{InstanceIds}}" Parameters: commands: - "(Get-WmiObject -Class Win32_ComputerSystem).PartOfDomain" CloudWatchOutputConfig: CloudWatchLogGroupName: CloudWatchGroupForSSMAutomationService CloudWatchOutputEnabled: true ``` ``` { "name": "checkMembership", "action": "aws:runCommand", "inputs": { "DocumentName": "AWS-RunPowerShellScript", "InstanceIds": [ "{{InstanceIds}}" ], "Parameters": { "commands": [ "(Get-WmiObject -Class Win32_ComputerSystem).PartOfDomain" ] }, "CloudWatchOutputConfig" : { "CloudWatchLogGroupName": "CloudWatchGroupForSSMAutomationService", "CloudWatchOutputEnabled": true } } } ``` Comment コマンドに関するユーザー定義情報。 型: 文字列 必須: いいえ DocumentHash ドキュメントのハッシュ。 型: 文字列 必須: いいえ DocumentHashType ハッシュの種類。 型: 文字列 有効な値: `Sha256` \| `Sha1` 必須: いいえ NotificationConfig 通知を送信するための設定。 必須: いいえ OutputS3BucketName Command Output の応答を保存する S3 バケットの名前。マネージドノードには、S3 バケットが Output を正常にログに記録するためのアクセス許可が必要です。 タイプ: 文字列 必須: いいえ OutputS3KeyPrefix プレフィックス。 型: 文字列 必須: いいえ ServiceRoleArn AWS Identity and Access Management (IAM) ロールの ARN。 型: 文字列 必須: いいえ TimeoutSeconds インスタンスの AWS Systems Manager SSM Agent にコマンドが配信されるまで待機する時間 (秒単位)。指定した値に達する前にインスタンスで SSM Agent が Command を受信しなかった場合、Command の Status は `Delivery Timed Out` に変わります。 タイプ: 整数 必須: いいえ 有効な値: 30～2592000Output CommandId コマンドの ID。 Status Command の Status。 ResponseCode コマンドのレスポンスコード。実行するドキュメントに複数のステップがある場合、この Output の値は返されません。 Output Command の Output。Command でタグまたは複数のインスタンスをターゲットにした場合、Output 値は返されません。`GetCommandInvocation` および `ListCommandInvocations` API オペレーションを使用して、個々のインスタンスの Output を取得できます。