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

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

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

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

你可以使用独立安装程序 AWS Command Line Interface (推荐AWS CLI)在 Windows 上安装 () 的版本 1pip,也可以使用适用于 Python 的包管理器。

键入命令时,请勿包含提示符符号 (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 SDKs和之间共享 AWS CLI。如果删除此文件夹,则系统上仍 AWS SDKs存在的任何文件都无法访问这些文件夹。

    .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. 如果您使用安装 AWS CLI 版本 1pip,则还必须使用进行卸载pip

    C:\> pip uninstall awscli

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

    C:\> pip3 uninstall awscli

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

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

    警告

    这些配置和凭据设置在所有 AWS SDKs和之间共享 AWS CLI。如果删除此文件夹,则系统上仍 AWS SDKs存在的任何文件都无法访问这些文件夹。

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

    $ rmdir %UserProfile%\.aws

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

使用安装 AWS CLI 版本 1 后pip,将该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,然后选择 “编辑”

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

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

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

AWS CLI 安装和卸载错误疑难解答

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