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
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 |
---|---|
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. |
(Optional) Configure edge devices so you can manage them using Run Command. |
|
Learn how to run a command that targets one or more managed nodes by using the Amazon Web Services Management Console. |
|
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.
- More info
-
-
Remotely Run Command on an EC2 Instance (10 minute tutorial)
-
Systems Manager service quotas in the Amazon Web Services General Reference
-