Installing AWS Tools for PowerShell on Linux or macOS - AWS Tools for PowerShell (version 5)
Prerequisites

Version 5 (V5) of the AWS Tools for PowerShell has been released!

For information about breaking changes and migrating your applications, see the migration topic.

Installing AWS Tools for PowerShell on Linux or macOS

For information about the Tools for PowerShell that are pre-installed on AWS CloudShell, see Installed on CloudShell.

To install AWS Tools for PowerShell on a Linux or macOS computer, you can choose from two package options:

  • AWS.Tools – The modularized version of AWS Tools for PowerShell. Each AWS service is supported by its own individual, small module, with shared support modules AWS.Tools.Common.

  • AWSPowerShell.NetCore – The single, large-module version of AWS Tools for PowerShell. All AWS services are supported by this single, large module.

    Note

    Be aware that the single module might be too large to use with AWS Lambda functions. Instead, use the modularized version shown above.

Setting either of these up on a computer running Linux or macOS involves the following tasks, described in detail in subsequent topics:

  1. Install PowerShell Core 6.0 or later on a supported system.

  2. After installing PowerShell Core, start PowerShell by running pwsh in your system shell.

  3. Install either AWS.Tools or AWSPowerShell.NetCore.

  4. Run the appropriate Import-Module cmdlet to import the module into your PowerShell session.

  5. Run the Initialize-AWSDefaultConfiguration cmdlet to provide your AWS credentials.

Prerequisites

To run the AWS Tools for PowerShell Core, your computer must be running PowerShell Core 6.0 or later.

  • For a list of supported Linux platform releases and for information about how to install the latest version of PowerShell on a Linux-based computer, see Installing PowerShell on Linux on Microsoft's website. Some Linux-based operating systems, such as Arch, Kali, and Raspbian, are not officially supported, but have varying levels of community support.

  • For information about supported macOS versions and about how to install the latest version of PowerShell on macOS, see Installing PowerShell on macOS on Microsoft's website.

Topics