Installing AWS CLI version 2 on Windows

Preview Evaluation Software

AWS CLI version 2 is provided as a preview for testing and evaluation. At this time we recommend that you do not use this in a production environment. For production environments, we recommend that you instead use the generally available version 1.x.

Prerequisites for Windows

  • The AWS CLI version 2 is supported on Microsoft Windows XP or later.
  • The AWS CLI version 2 supports only 64-bit versions of Windows.

Installing on Windows

For Windows users, the MSI installation package offers a familiar and convenient way to install the AWS CLI version 2 without installing any other prerequisites.

To install the AWS CLI version 2 using the MSI installer

  1. Download the MSI installer.
  2. Run the downloaded MSI installer and follow the onscreen instructions. By default, the CLI installs to C:\Program Files\Amazon\AWSCLI2.NoteThe preview release of AWS CLI version 2 names the program aws2 to enable AWS CLI version 1 and version 2 to coexist side-by-side. Future releases of AWS CLI version 2 might change this command name.
  3. To confirm the installation, use the aws2 --version command at a command prompt (open the Start menu and search for cmd to start a command prompt).
C:\> aws2 --version
aws-cli/2.0.0dev0 Python/3.7.3 Windows/10 botocore/2.0.0dev0

Don’t include the prompt symbol (C:\>, shown above) when you type a command. These are included in program listings to differentiate commands that you type from output returned by the CLI. The rest of this guide uses the generic prompt symbol, $ , except in cases where a command is Windows-specific.

If Windows is unable to find the program, you might need to close and reopen the command prompt to refresh the path, or add the installation directory to your PATH environment variable manually.

Upgrading on Windows

The AWS CLI is updated regularly. Check the Releases page on GitHub to see when the latest version was released.

To update to the latest version, download the latest version of the MSI installer and run it, as described previously. It automatically overwrites the previous version.

Removing from Windows

To uninstall the AWS CLI, open the Control Panel, and then choose Programs and Features. Select the entry named AWS Command Line Interface, and then choose Uninstall to launch the uninstaller. Confirm that you want to uninstall the AWS CLI when you’re prompted.

You can also launch the Programs and Features program from the command line with the following command.

c:\> appwiz.cpl