Amazon Systems Manager Run Command - Amazon Systems Manager
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Amazon Systems Manager Run Command

Using Run Command, a capability of Amazon Systems Manager, you can remotely and securely manage the configuration of your managed nodes. A managed node is any Amazon Elastic Compute Cloud (Amazon EC2) instance or non-EC2 machine in your hybrid and multicloud environment that has been configured for Systems Manager. Run Command allows you to automate common administrative tasks and perform one-time configuration changes at scale. You can use Run Command from the Amazon Web Services Management Console, the Amazon Command Line Interface (Amazon CLI), Amazon Tools for Windows PowerShell, or the Amazon SDKs. Run Command is offered at no additional cost. To get started with Run Command, open the Systems Manager console. In the navigation pane, choose Run Command.

Administrators use Run Command to install or bootstrap applications, build a deployment pipeline, capture log files when an instance is removed from an Auto Scaling group, join instances to a Windows domain, and more.

The Run Command API follows an eventual consistency model, due to the distributed nature of the system supporting the API. This means that the result of an API command you run that affects your resources might not be immediately visible to all subsequent commands you run. You should keep this in mind when you carry out an API command that immediately follows a previous API command.

Getting Started

The following table includes information to help you get started with Run Command.

Topic Details

Setting up managed nodes for Amazon Systems Manager

Verify that you have completed the setup requirements for your Amazon Elastic Compute Cloud (Amazon EC2) instances and non-EC2 machines in a hybrid and multicloud environment.

Managing nodes in hybrid and multicloud environments with Systems Manager

(Optional) Register on-premises servers and VMs with Amazon so you can manage them using Run Command.

Managing edge devices with Systems Manager

(Optional) Configure edge devices so you can manage them using Run Command.

Running commands on managed nodes

Learn how to run a command that targets one or more managed nodes by using the Amazon Web Services Management Console.

Run Command walkthroughs

Learn how to run commands using either Tools for Windows PowerShell or the Amazon CLI.

EventBridge support

This Systems Manager capability is supported as both an event type and a target type in Amazon EventBridge rules. For information, see Monitoring Systems Manager events with Amazon EventBridge and Reference: Amazon EventBridge event patterns and types for Systems Manager.