# Instalación de la versión 2 de la AWS CLI a partir de la versión 1 de la AWS CLI
<a name="cliv2-migration-instructions"></a>

En este tema se ofrecen instrucciones para migrar desde la AWS CLI versión 1 a la AWS CLI versión 2.

Las versiones 1 y 2 de la AWS CLI utilizan el mismo nombre de comando de `aws`. Si tiene ambas versiones instaladas, el equipo utiliza la primera que encuentra en la ruta de búsqueda. Si ha instalado la versión 1 de la AWS CLI anteriormente, le recomendamos que realice una de las siguientes acciones para usar la versión 2 de la AWS CLI:
+ **Recomendado**: [desinstale la AWS CLI versión 1 y use solo la AWS CLI versión 2](#cliv2-migration-instructions-migrate).
+ [Para tener ambas versiones instaladas](#cliv2-migration-instructions-side-by-side), utilice la capacidad de su sistema operativo para crear un enlace simbólico (symlink) o un alias con otro nombre para uno de los dos comandos `aws`.

Para obtener información sobre los cambios notorios entre la versión 1 y la versión 2, consulte [Nuevas características y cambios en la versión 2 de la AWS CLI](cliv2-migration-changes.md).

## Reemplazo de la versión 1 por la versión 2
<a name="cliv2-migration-instructions-migrate"></a>

Siga estos pasos para reemplazar la AWS CLI versión 1 por la AWS CLI versión 2. 

**Para reemplazar la AWS CLI versión 1 por la AWS CLI versión 2**

1. Prepare los scripts existentes que tenga para la migración mediante la confirmación de confirmando los cambios importantes entre la versión 1 y la versión 2 en [Nuevas características y cambios en la versión 2 de la AWS CLI](cliv2-migration-changes.md). Puede utilizar la característica del modo de depuración de actualizaciones como guía en su preparación siguiendo las instrucciones que se indican en [Uso del modo de depuración de actualizaciones para actualizar la versión 1 de AWS CLI a la versión 2 de AWS CLI](cli-upgrade-debug-mode.md).

1. Desinstale la AWS CLI versión 1 siguiendo las instrucciones de desinstalación correspondientes a su sistema operativo en [Instalación, actualización y desinstalación de la AWS CLI versión 1](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html).

1. Confirme que la AWS CLI se ha desinstalado completamente mediante el siguiente comando.

   ```
   $ aws --version
   ```

   Complete uno de los siguientes procesos en función del resultado:
   + **No se ha devuelto ninguna versión:** ha desinstalado correctamente la AWS CLI versión 1 y continúe con el siguiente paso.
   + **Se ha devuelto una versión:** aún tiene una instalación de la AWS CLI versión 1. Para ver los pasos de solución de problemas, consulte [El comando "`aws --version`" devuelve una versión después de desinstalar la AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1). Realice los pasos de resolución de problemas hasta que no se reciba ninguna salida de versión.

1. Instale la AWS CLI versión 2 siguiendo las instrucciones de instalación adecuadas para su sistema operativo en [Instalación o actualización de la versión más reciente de AWS CLI](getting-started-install.md).

## Instalación en paralelo
<a name="cliv2-migration-instructions-side-by-side"></a>

Para tener ambas versiones instaladas, utilice la capacidad de su sistema operativo para crear un enlace simbólico (symlink) o un alias con otro nombre para uno de los dos comandos `aws`. 

1. Instale la AWS CLI versión 2 siguiendo las instrucciones de instalación adecuadas para su sistema operativo en [Instalación o actualización de la versión más reciente de AWS CLI](getting-started-install.md).

1. Utilice la capacidad de su sistema operativo para crear un enlace simbólico (symlink) o un alias con otro nombre para uno de los dos comandos `aws`, por ejemplo, use *`aws2`* para la AWS CLI versión 2. A continuación, se muestran ejemplos de enlaces simbólicos para la AWS CLI versión 2. Reemplace el valor de *PATH* por su ubicación de instalación.

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

   Puede usar un [enlace simbólico](https://www.linux.com/topic/desktop/understanding-linux-links/) o un [alias](https://www.linux.com/topic/desktop/aliases-diy-shell-commands/) en Linux y 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) en Windows.

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

------