**本文档仅适用于 AWS CLI 版本 1。**
我们已宣布即将终止对 AWS CLI 版本 1 的支持。建议您迁移到 AWS CLI 版本 2。有关日期、其它详细信息以及如何迁移的信息，请参阅[公告](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/)。有关 AWS CLI 版本 2 的相关文档，请参阅[版本 2 用户指南](https://docs.aws.amazon.com/cli/latest/userguide/)。
# 在 Windows 上安装、更新和卸载 AWS CLI 版本 1
可以在 Windows 上使用独立安装程序（建议）或 AWS Command Line Interface（一种适用于 Python 的程序包管理器）来安装 AWS CLI (`pip`) 的版本 1。
键入命令时，请勿包含提示符符号 (`C:\>`)。程序列表中包含这些符号是为了区分您键入的命令与 AWS CLI 返回的输出。除非是特定于 Windows 的命令，否则本指南其余部分使用通用提示符符号 (`$`)。
**Topics**
+ [使用 MSI 安装程序来安装、更新和卸载 AWS CLI 版本 1](#msi-on-windows)
+ [在 Windows 上使用 Python 和 pip 安装、更新和卸载 AWS CLI 版本 1](#awscli-install-windows-pip)
+ [将 AWS CLI 版本 1 可执行文件添加到命令行路径](#awscli-install-windows-path)
+ [AWS CLI 安装和卸载错误故障排除](#awscli-install-windows-tshoot)
## 使用 MSI 安装程序来安装、更新和卸载 AWS CLI 版本 1
Windows XP 或更高版本支持 AWS CLI 版本 1。对于 Windows 用户，MSI 安装程序包提供了一种熟悉而方便的方式来安装 AWS CLI 版本 1，且无需安装其他任何必备软件。
### 使用 MSI 安装程序来安装和更新 AWS CLI 版本 1
查看 GitHub 上的[版本](https://github.com/aws/aws-cli/releases)页面，了解何时发布了最新版本。更新发布后，您必须重复安装过程以获取最新版本的 AWS CLI 版本 1。
1. 下载相应的 MSI 安装程序：
+ 适用于 Windows（64 位）的 AWS CLI MSI 安装程序：[https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi)
+ 适用于 Windows（32 位）的 AWS CLI MSI 安装程序：[https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi)
+ 适用于 Windows 的 AWS CLI 合并安装文件：[ https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe](https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe)（同时包括 32 位和 64 位 MSI 安装程序，并自动安装正确的版本）
1. 运行下载的 MSI 安装程序或设置文件。
1. 按照屏幕上的说明进行操作。默认情况下，AWS CLI 版本 1 安装到 `C:\Program Files\Amazon\AWSCLI`（64 位版本）或 `C:\Program Files (x86)\Amazon\AWSCLI`（32 位版本）。
1. 要确认安装，请在命令提示符下使用 `aws --version` 命令（打开 **Start**（开始）菜单并搜索 `cmd` 以启动命令提示符）。
```
C:\> aws --version
aws-cli/1.40.41 Python/3.11.6 Windows/10 botocore/1.18.6
```
如果 Windows 无法找到该程序，您需要关闭并重新打开命令提示符以刷新该路径，或手动[将安装目录添加到您的 PATH](#awscli-install-windows-path) 环境变量。
### 卸载 AWS CLI 版本 1
要使用以下卸载说明，您需要已经使用 MSI 安装程序或安装文件安装了 AWS CLI 版本 1。
1. 通过执行以下操作之一打开**程序和功能**：
+ 打开**控制面板**，然后选择**程序和功能**。
+ 打开命令提示符，然后运行以下命令。
```
C:\> appwiz.cpl
```
1. 选择名为 **AWS Command Line Interface** 的条目，然后选择 **Uninstall**（卸载）启动卸载程序。
1. 确认您要卸载 AWS CLI。
1. **（可选）**删除 `.aws` 文件夹中的共享 AWS SDK 和 AWS CLI 设置信息。
**警告**
这些配置和凭证设置跨所有 AWS SDK 和 AWS CLI 进行共享。如果删除此文件夹，则您系统上的任何 AWS SDK 都无法访问它们。
`.aws` 文件夹的默认位置因平台而异，默认情况下，该文件夹位于 *%UserProfile%\$1.aws*。
```
$ rmdir %UserProfile%\.aws
```
## 在 Windows 上使用 Python 和 pip 安装、更新和卸载 AWS CLI 版本 1
Python Software Foundation 为包含 `pip` 的 Windows 提供了安装程序。
### 先决条件
您必须已安装 Python 3.8 或更高版本。有关安装说明，请参阅 Python 的*初学者指南* 中的[下载 Python](https://wiki.python.org/moin/BeginnersGuide/Download) 页面。
### 使用 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
```
1. 验证 AWS CLI 版本 1 是否已正确安装。如果没有响应，请参阅 [将 AWS CLI 版本 1 可执行文件添加到命令行路径](#awscli-install-windows-path) 部分。
```
C:\> aws --version
aws-cli/1.40.41 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
```
您可能需要重新启动命令提示符窗口或电脑才能删除所有文件。
1. **（可选）**删除 `.aws` 文件夹中的共享 AWS SDK 和 AWS CLI 设置信息。
**警告**
这些配置和凭证设置跨所有 AWS SDK 和 AWS CLI 进行共享。如果删除此文件夹，则您系统上的任何 AWS SDK 都无法访问它们。
`.aws` 文件夹的默认位置因平台而异，默认情况下，该文件夹位于 *%UserProfile%\$1.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
...
```
------
1. 按 Windows 键并输入 **environment variables**。
1. 选择 **Edit environment variables for your account**（编辑您账户的环境变量）。
1. 选择 **PATH**，然后选择 **Edit**（编辑）。
1. 将找到的路径添加到 **Variable value**（变量值）字段中，例如 ***C:\$1Program Files\$1Amazon\$1AWSCLI\$1bin\$1aws.exe***。
1. 选择 **OK**（确定）两次以应用新设置。
1. 关闭任何运行的命令提示符并重新打开命令提示符窗口。
## AWS CLI 安装和卸载错误故障排除
如果您在安装或卸载 AWS CLI 后遇到问题，请参阅[排查 AWS CLI 错误](cli-chap-troubleshooting.md)以了解故障排除步骤。有关相关性最高的故障排除步骤，请参阅[找不到命令错误](cli-chap-troubleshooting.md#tshoot-install-not-found)、[“`aws --version`”命令返回的版本与您安装的版本不同](cli-chap-troubleshooting.md#tshoot-install-wrong-version)和[卸载 AWS CLI 后，“`aws --version`”命令返回一个版本](cli-chap-troubleshooting.md#tshoot-uninstall-1)。