AWS Tools for PowerShell
User Guide

Using the AWS Tools for Windows PowerShell

This section provides examples of using the AWS Tools for PowerShell to access AWS services. These examples help demonstrate how to use the cmdlets to perform actual AWS tasks.

Note Regarding Returned Objects for the Powershell Tools

In some cases, the object returned from an Tools for PowerShell cmdlet does not mirror what is returned from the corresponding API in the AWS SDK for .NET. For example, Get-S3Bucket emits a Buckets collection, not an Amazon S3 response object. Similarly, Get-EC2Instance emits a Reservation collection, not a DescribeEC2Instances result object. This behavior is by design and is intended to have the Tools for PowerShell experience be more consistent with idiomatic PowerShell.

The actual service responses are stored in note properties on the returned objects and are therefore available if you need to access them. For API actions that support NextToken fields, these are also attached as note properties.

Amazon EC2

This section walks through the steps required to launch an Amazon EC2 instance including how to:

  • Retrieve a list of Amazon Machine Images (AMIs).

  • Create a key pair.

  • Create and configure a security group.

  • Launch the instance and retrieve information about it.

Amazon S3

The section walks through the steps required to create a static website hosted in Amazon S3. It demonstrates how to:

  • Create and delete Amazon S3 buckets.

  • Upload files to an Amazon S3 bucket as objects.

  • Delete objects from an Amazon S3 bucket.

  • Designate an Amazon S3 bucket as a website.

AWS Identity and Access Management

This section demonstrates basic operations in AWS Identity and Access Management (IAM) including how to:

  • Create an IAM group.

  • Create an IAM user.

  • Add an IAM user to an IAM group.

  • Specify a policy for an IAM user.

  • Set a password and credentials for an IAM user.

AWS Lambda and Lambda Tools for PowerShell

This section provides a brief overview of the AWS Lambda Tools for PowerShell module and describes the required steps for setting up the module.

Amazon SNS and Amazon SQS

This section walks through the steps required to subscribe an Amazon SQS queue to an Amazon SNS topic. It demonstrates how to:

  • Create an Amazon SNS topic.

  • Create an Amazon SQS queue.

  • Subscribe the queue to the topic.

  • Send a message to the topic.

  • Receive the message from the queue.


This section provides an example of how to publish custom data to CloudWatch.

  • Publish a Custom Metric to Your CloudWatch Dashboard.

See Also

On this page: