在 Windows 上安装、更新和卸载 AWS CLI 版本 1 - AWS Command Line Interface

本文档仅适用于 AWS CLI 版本 1。有关 AWS CLI 版本 2 的相关文档,请参阅版本 2 用户指南

在 Windows 上安装、更新和卸载 AWS CLI 版本 1

可以在 Windows 上使用独立安装程序(建议)或 pip(一种适用于 Python 的程序包管理器)来安装 AWS Command Line Interface (AWS CLI) 的版本 1。

键入命令时,请勿包含提示符符号 (C:\>)。程序列表中包含这些符号是为了区分您键入的命令与 AWS CLI 返回的输出。除非是特定于 Windows 的命令,否则本指南其余部分使用通用提示符符号 ($)。

使用 MSI 安装程序来安装、更新和卸载 AWS CLI 版本 1

Windows XP 或更高版本支持 AWS CLI 版本 1。对于 Windows 用户,MSI 安装程序包提供了一种熟悉而方便的方式来安装 AWS CLI 版本 1,且无需安装其他任何必备软件。

使用 MSI 安装程序来安装和更新 AWS CLI 版本 1

查看 GitHub 上的版本页面,了解何时发布了最新版本。更新发布后,您必须重复安装过程以获取最新版本的 AWS CLI 版本 1。

  1. 下载相应的 MSI 安装程序:

  2. 运行下载的 MSI 安装程序或设置文件。

  3. 按照屏幕上的说明进行操作。默认情况下,AWS CLI 版本 1 安装到 C:\Program Files\Amazon\AWSCLI(64 位版本)或 C:\Program Files (x86)\Amazon\AWSCLI(32 位版本)。

  4. 要确认安装,请在命令提示符下使用 aws --version 命令(打开 Start(开始)菜单并搜索 cmd 以启动命令提示符)。

    C:\> aws --version aws-cli/1.27.69 Python/3.11.2 Windows/10 botocore/1.13

    如果 Windows 无法找到该程序,您需要关闭并重新打开命令提示符以刷新该路径,或手动将安装目录添加到您的 PATH 环境变量。

卸载 AWS CLI 版本 1

要使用以下卸载说明,您需要已经使用 MSI 安装程序或安装文件安装了 AWS CLI 版本 1。

  1. 通过执行以下操作之一打开程序和功能

    • 打开控制面板,然后选择程序和功能

    • 打开命令提示符,然后运行以下命令。

      C:\> appwiz.cpl
  2. 选择名为 AWS Command Line Interface 的条目,然后选择 Uninstall(卸载)启动卸载程序。

  3. 确认您要卸载 AWS CLI。

  4. (可选)删除 .aws 文件夹中的共享 AWS SDK 和 AWS CLI 设置信息。

    警告

    这些配置和凭证设置跨所有 AWS SDK 和 AWS CLI 进行共享。如果删除此文件夹,则您系统上的任何 AWS SDK 都无法访问它们。

    .aws 文件夹的默认位置因平台而异,默认情况下,该文件夹位于 %UserProfile%\.aws

    $ rmdir %UserProfile%\.aws

在 Windows 上使用 Python 和 pip 安装、更新和卸载 AWS CLI 版本 1

Python Software Foundation 为包含 pip 的 Windows 提供了安装程序。

先决条件

您必须已安装 Python 3.8 或更高版本。有关安装说明,请参阅 Python 的初学者指南 中的下载 Python 页面。

警告

Python 2.7 已于 2020 年 1 月 1 日被 Python Software Foundation 弃用。从 AWS CLI 版本 1.20.0 开始,至少需要 Python 3.6 版本。

为了将 AWS CLI 版本 1 与较旧版本的 Python 配合使用,您需要安装较早版本的 AWS CLI 版本 1。要查看 AWS CLI 版本 1 Python 版本支持表,请参阅 Python 版本要求

使用 pip 安装和更新 AWS CLI 版本 1

  1. 要安装 AWS CLI 版本 1,请使用 pip3 命令(如果使用 Python 版本 3 或更高版本)或 pip 命令。

    对于最新版本的 AWS CLI,请使用以下命令块:

    C:\> pip3 install awscli --upgrade --user

    对于特定版本的 AWS CLI,在文件名中附加一个小于号 < 和版本号。在本示例中,版本 1.16.312 的文件名为 <1.16.312,这会生成以下命令:

    C:\> pip3 install awscli<1.16.312 --upgrade --user
  2. 验证 AWS CLI 版本 1 是否已正确安装。如果没有响应,请参阅 将 AWS CLI 版本 1 可执行文件添加到命令行路径 部分。

    C:\> aws --version aws-cli/1.27.69 Python/3.11.2 Windows/10 botocore/1.13

使用 pip 卸载 AWS CLI 版本 1

  1. 如果您使用 pip 安装了 AWS CLI 版本 1,则还必须使用 pip 进行卸载。

    C:\> pip uninstall awscli

    如果您使用的是 Python 版本 2 或 3,则可能需要使用 pip2pip3 命令。使用 aws --version 命令确定与您安装的 AWS CLI 版本 1 关联的 Python 版本。

    C:\> pip3 uninstall awscli

    您可能需要重新启动命令提示符窗口或电脑才能删除所有文件。

  2. (可选)删除 .aws 文件夹中的共享 AWS SDK 和 AWS CLI 设置信息。

    警告

    这些配置和凭证设置跨所有 AWS SDK 和 AWS CLI 进行共享。如果删除此文件夹,则您系统上的任何 AWS SDK 都无法访问它们。

    .aws 文件夹的默认位置因平台而异,默认情况下,该文件夹位于 %UserProfile%\.aws

    $ rmdir %UserProfile%\.aws

将 AWS CLI 版本 1 可执行文件添加到命令行路径

在使用 pip 安装 AWS CLI 版本 1 后,将 aws 程序添加到操作系统的 PATH 环境变量中。通过 MSI 安装,这应该会自动发生。但是,如果在安装它后未运行 aws 命令,则可能需要手动设置它。

  1. 使用 where 命令查找 aws 文件位置。默认情况下,where 命令显示在系统的 PATH 中找到指定程序的位置。

    C:\> where aws

    所显示的路径取决于平台和安装 AWS CLI 所采用的方法。包含版本号的文件夹名称可能有所不同。这些示例反映所使用的是 Python 版本 3.7。根据需要将版本替换为您正在使用的版本号。典型路径包括:

    • Python 3 和 pip3C:\Program Files\Python37\Scripts\

    • Windows 较早版本上的 Python 3 和 pip3 --user 选项%USERPROFILE%\AppData\Local\Programs\Python\Python37\Scripts

    • Windows 10 上的 Python 3 和 pip3 --user 选项%USERPROFILE%\AppData\Roaming\Python\Python37\Scripts

    • MSI 安装程序(64 位)C:\Program Files\Amazon\AWSCLI\bin

    • MSI 安装程序(32 位)C:\Program Files (x86)\Amazon\AWSCLI\bin

    根据是否返回文件路径,使用以下步骤。

    A file path is returned
    C:\> where aws C:\Program Files\Amazon\AWSCLI\bin\aws.exe

    您可以通过运行以下命令找到安装 aws 程序的位置。

    C:\> where c:\ aws C:\Program Files\Python37\Scripts\aws
    A file path is NOT returned

    如果 where 命令返回以下错误,这表示程序并不在系统 PATH 下,因此您无法通过输入其名称来运行它。

    C:\> where c:\ aws INFO: Could not find files for the given pattern(s).

    在这种情况下,请运行带有 where 参数的 /R path 命令,以告诉它搜索所有文件夹,然后手动添加路径。使用命令行或文件资源管理器发现它在电脑上的安装位置。

    C:\> where /R c:\ aws c:\Program Files\Amazon\AWSCLI\bin\aws.exe c:\Program Files\Amazon\AWSCLI\bincompat\aws.cmd c:\Program Files\Amazon\AWSCLI\runtime\Scripts\aws c:\Program Files\Amazon\AWSCLI\runtime\Scripts\aws.cmd ...
  2. 按 Windows 键并输入 environment variables

  3. 选择 Edit environment variables for your account(编辑您账户的环境变量)。

  4. 选择 PATH,然后选择 Edit(编辑)。

  5. 将找到的路径添加到 Variable value(变量值)字段中,例如 C:\Program Files\Amazon\AWSCLI\bin\aws.exe

  6. 选择 OK(确定)两次以应用新设置。

  7. 关闭任何运行的命令提示符并重新打开命令提示符窗口。

AWS CLI 安装和卸载错误故障排除

如果您在安装或卸载 AWS CLI 后遇到问题,请参阅排查 AWS CLI 错误以了解故障排除步骤。有关相关性最高的故障排除步骤,请参阅找不到命令错误“aws --version”命令返回的版本与您安装的版本不同卸载 AWS CLI 后,“aws --version”命令返回一个版本