

# 从 AWS CLI 版本 1 安装 AWS CLI 版本 2
<a name="cliv2-migration-instructions"></a>

本主题提供用于从 AWS CLI 版本 1 迁移至 AWS CLI 版本 2 的说明。

AWS CLI 版本 1 和 2 使用相同的 `aws` 命令名称。如果您安装了两个版本，电脑将使用在搜索路径中找到的第一个版本。如果您之前安装过 AWS CLI 版本 1，建议您执行以下操作之一来使用 AWS CLI 版本 2：
+ **推荐** – [卸载 AWS CLI 版本 1 并仅使用 AWS CLI 版本 2](#cliv2-migration-instructions-migrate)。
+ [要同时安装这两个版本](#cliv2-migration-instructions-side-by-side)，请使用操作系统的功能为两个 `aws` 命令之一创建具有不同名称的符号链接 (symlink) 或别名。

有关版本 1 和版本 2 之间的突破性更改的信息，请参阅 [AWS CLI 版本 2 中的新功能和变化](cliv2-migration-changes.md)。

## 将版本 1 替换为版本 2
<a name="cliv2-migration-instructions-migrate"></a>

执行以下步骤以将 AWS CLI 版本 1 替换为 AWS CLI 版本 2。

**将 AWS CLI 版本 1 替换为 AWS CLI 版本 2**

1. 通过在 [AWS CLI 版本 2 中的新功能和变化](cliv2-migration-changes.md)中确认版本 1 和版本 2 之间的任何突破性更改，为迁移准备任何现有的脚本。您可以按照[使用升级调试模式将 AWS CLI 版本 1 升级到 AWS CLI 版本 2](cli-upgrade-debug-mode.md)中的说明，使用升级调试模式功能来指导您的准备工作。

1. 按照[安装、更新和卸载 AWS CLI 版本 1](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html) 中适用于您的操作系统的卸载说明操作，卸载 AWS CLI 版本 1。

1. 使用以下命令确认 AWS CLI 已完全卸载。

   ```
   $ aws --version
   ```

   根据输出完成下列操作之一：
   + **没有返回任何版本：**您已成功卸载 AWS CLI 版本 1，可以继续执行下一步。
   + **返回了版本：**您仍有 AWS CLI 版本 1 的安装。有关问题排查步骤，请参阅[卸载 AWS CLI 后，“`aws --version`”命令返回一个版本](cli-chap-troubleshooting.md#tshoot-uninstall-1)。执行故障排除步骤，直到不会收到版本输出。

1. 按照[安装或更新最新版本的 AWS CLI](getting-started-install.md)中适用于您的操作系统的安装说明安装 AWS CLI 版本 2。

## 并排安装
<a name="cliv2-migration-instructions-side-by-side"></a>

要同时安装这两个版本，请使用操作系统的功能为两个 `aws` 命令之一创建具有不同名称的符号链接 (symlink) 或别名。

1. 按照[安装或更新最新版本的 AWS CLI](getting-started-install.md)中适用于您的操作系统的安装说明安装 AWS CLI 版本 2。

1. 使用操作系统的功能为两个 `aws` 命令中的一个命令创建具有不同名称的符号链接或别名，例如，将 *`aws2`* 用于 AWS CLI 版本 2。以下是用于 AWS CLI 版本 2 的符号链接示例。将 *PATH* 替换为您的安装位置。

------
#### [ Linux and macOS ]

   您可以在 Linux 和 macOS 上使用[符号链接](https://www.linux.com/topic/desktop/understanding-linux-links/)或[别名](https://www.linux.com/topic/desktop/aliases-diy-shell-commands/)。

   ```
   $ alias aws2='PATH'
   ```

------
#### [ Windows command prompt ]

   [https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/doskey](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/doskey)Windows 上的

   ```
   C:\> doskey aws2=PATH
   ```

------