# Instalando a AWS CLI versão 2 a partir da AWS CLI versão 1
<a name="cliv2-migration-instructions"></a>

Este tópico fornece instruções para a migração da AWS CLI versão 1 para a AWS CLI versão 2.

As versões 1 e 2 da AWS CLI usam o mesmo nome de comando da `aws`. Se você tiver as duas versões instaladas, o computador usará a primeira encontrada no caminho de pesquisa. Se você já instalou a AWS CLI versão 1, recomendamos executar um dos seguintes procedimentos para usar a AWS CLI versão 2:
+  **Recomendado**: [desinstale a AWS CLI versão 1 e use apenas a AWS CLI versão 2](#cliv2-migration-instructions-migrate).
+ [Para ter as duas versões instaladas](#cliv2-migration-instructions-side-by-side), use a capacidade do sistema operacional de criar um link simbólico (symlink) ou um alias com um nome diferente para um dos dois comandos da `aws`.

Para obter informações sobre as principais diferenças entre a versão 1 e a versão 2, consulte [Novos atributos e alterações na AWS CLI versão 2](cliv2-migration-changes.md).

## Substituindo a versão 1 pela versão 2
<a name="cliv2-migration-instructions-migrate"></a>

Siga estes passos para substituir a AWS CLI versão 1 pela AWS CLI versão 2. 

**Como substituir a AWS CLI versão 1 pela AWS CLI versão 2**

1. Prepare todos os scripts existentes para a migração, confirmando quaisquer todas as últimas alterações entre a versão 1 e a versão 2 na [Novos atributos e alterações na AWS CLI versão 2](cliv2-migration-changes.md). É possível usar o recurso do modo de depuração de atualização para orientar sua preparação seguindo as instruções em [Usar o modo de depuração de atualização para atualizar a AWS CLI versão 1 para a AWS CLI versão 2](cli-upgrade-debug-mode.md).

1. Desinstale a AWS CLI versão 1 seguindo as instruções de desinstalação do seu sistema operacional em [Instalar, atualizar e desinstalar a AWS CLI versão 1](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html).

1. Confirme que a AWS CLI está completamente desinstalada usando o comando a seguir.

   ```
   $ aws --version
   ```

   Conclua uma das seguintes opções com base na saída:
   + **Nenhuma versão retornada:** você desinstalou com sucesso a AWS CLIVersão 1 e pode prosseguir para o próximo passo.
   + **Uma versão é retornada:** você ainda tem uma instalação da AWS CLI versão 1. Para obter etapas sobre a solução de problemas, consulte [O comando “`aws --version`” retorna uma versão após a desinstalação da AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1). Execute os passos de solução de problemas até que nenhuma saída de versão seja recebida.

1. Instale a AWS CLI versão 2 seguindo as instruções de instalação apropriadas do seu sistema operacional em [Instalar ou atualizar a versão mais recente da AWS CLI](getting-started-install.md).

## Instalação lado a lado
<a name="cliv2-migration-instructions-side-by-side"></a>

Para ter as duas versões instaladas, use a capacidade do sistema operacional de criar um link simbólico (symlink) ou um alias com um nome diferente para um de dois comandos da `aws`. 

1. Instale a AWS CLI versão 2 seguindo as instruções de instalação apropriadas do seu sistema operacional em [Instalar ou atualizar a versão mais recente da AWS CLI](getting-started-install.md).

1. Use a capacidade do seu sistema operacional para criar um alias ou um symlink com um nome diferente para um de dois comandos da `aws`, como usar *`aws2`* para a AWS CLI versão 2. A seguir estão exemplos de symlinks para a AWS CLI versão 2. Substitua o *CAMINHO* com pelo seu local de instalação.

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

   Você pode usar um [link simbólico](https://www.linux.com/topic/desktop/understanding-linux-links/) ou um [alias](https://www.linux.com/topic/desktop/aliases-diy-shell-commands/) no Linux e no macOS.

   ```
   $ 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) no Windows.

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

------