AWS Systems Manager Run Command - AWS Systems Manager

AWS Systems Manager Run Command

Using Run Command, a capability of AWS 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, edge device, or on-premises server or virtual machine (VM) in your hybrid 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 AWS Management Console, the AWS Command Line Interface (AWS CLI), AWS Tools for Windows PowerShell, or the AWS SDKs. Run Command is offered at no additional cost.

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.

Getting Started

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

Topic Details

Systems Manager prerequisites

(Required) Verify that your managed nodes meet the minimum requirements for Run Command, configure required roles, and install the SSM Agent.

Setting up AWS Systems Manager for hybrid environments

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

Setting up AWS Systems Manager for edge devices

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

Sending commands using Systems Manager Run Command

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

Run Command walkthroughs

Learn how to run commands using either Tools for Windows PowerShell or the AWS 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.