在 Windows 上安装、更新和卸载 AWS CLI 版本 1 - AWS Command Line Interface
使用 MSI 安装程序进行安装、更新和卸载使用 Python 和 pip 进行安装、更新和卸载将 AWS CLI 可执行文件添加到命令行路径AWS CLI 安装和卸载错误故障排除

本文档仅适用于 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.33.33 Python/3.11.6 Windows/10 botocore/1.18.6

    如果 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 页面。

使用 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.33.33 Python/3.11.6 Windows/10 botocore/1.18.6

使用 pip 卸载 AWS CLI 版本 1

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

    C:\> pip uninstall awscli

    如果您使用的是 Python 版本 2 或 3，则可能需要使用 pip2 或 pip3 命令。使用 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 和 pip3 – C:\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”命令返回一个版本。