Instalación de la CLI de Azure en Windows

La interfaz de la línea de comandos (CLI) de Azure es una herramienta de línea de comandos multiplataforma que se puede instalar localmente en equipos Windows. Puede usar la CLI de Azure para Windows para conectarse a Azure y ejecutar comandos administrativos en recursos de Azure. La CLI de Azure para Windows también se puede usar desde un explorador mediante Azure Cloud Shell o ejecutarse desde dentro de un contenedor de Docker.

En Windows, la CLI de Azure se instala mediante un archivo MSI que proporciona acceso a la CLI mediante el símbolo del sistema de Windows (CMD) o PowerShell. Si se va a instalar el subsistema de Windows para Linux (WSL), hay paquetes disponibles para su distribución de Linux. Consulte la página principal de instalación para obtener la lista de administradores de paquetes admitidos o información para instalar manualmente en WSL.

La versión actual de la CLI de Azure es la 2.39.0. Para más información sobre la versión más reciente, consulte las notas de la versión. Para averiguar la versión instalada y ver si tiene que actualizar, ejecute az version.

Instalación o actualización

El archivo MSI distribuible se usa para instalar o actualizar la CLI de Azure en Windows. No es necesario desinstalar las versiones actuales antes de usar el instalador MSI porque el archivo MSI actualizará cualquier versión existente.

La versión más reciente

Descargue e instale la versión más reciente de la CLI de Azure. Cuando el instalador le pregunte si puede realizar cambios en el equipo, haga clic en la casilla "Sí". Una vez completada la instalación, deberá cerrar y volver a abrir cualquier ventana activa del símbolo del sistema de Windows o PowerShell para usar la CLI de Azure.

Versión específica

Para descargar el instalador de MSI para una versión específica, cambie el segmento de versión en la URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi y descárguelo. Las versiones disponibles se pueden encontrar en las notas de la versión de la CLI de Azure.

Ejecución de la CLI de Azure

Ya puede ejecutar la CLI de Azure con el comando az desde el símbolo del sistema de Windows o PowerShell.

Solución de problemas

Estos son algunos problemas comunes que se han observado al instalar la CLI de Azure en Windows. Si tiene algún problema que no se trata aquí, abra una incidencia en GitHub.

El servidor proxy bloquea la conexión

Si no puede descargar al instalador MSI porque el proxy está bloqueando la conexión, asegúrese de que el servidor proxy esté configurado correctamente. En Windows 10, esta configuración se administra en el panel Settings > Network & Internet > Proxy. Póngase en contacto con el administrador del sistema para más información sobre la configuración necesaria, o si su máquina se puede administrar mediante configuración o si requiere configuración avanzada.

Importante

Esta configuración también es necesaria para poder tener acceso a los servicios de Azure con la CLI, PowerShell o la línea de comandos. En PowerShell, se hace con el siguiente comando:

(New-Object System.Net.WebClient).Proxy.Credentials = `
  [System.Net.CredentialCache]::DefaultNetworkCredentials

Para obtener el MSI, el servidor proxy debe permitir las conexiones HTTPS a las siguientes direcciones:

  • https://aka.ms/
  • https://azcliprod.blob.core.windows.net/

Desinstalación

Si decide desinstalar la CLI de Azure, sentimos que se marche. Antes de desinstalar, use el comando az feedback para contarnos lo que se podría mejorar o corregir. Nuestro objetivo es hacer una CLI de Azure sin errores y fácil de usar. Si encuentra un error, le rogamos que abra una incidencia en GitHub.

La CLI de Azure se desinstala desde la lista "Aplicaciones y características" de Windows. Para desinstalar:

Plataforma Instructions
Windows 10 Inicio > Configuración > Aplicaciones
Windows 8 y Windows 7 Inicio > Panel de control > Programas > Desinstalar un programa

En esta pantalla, escriba CLI de Azure en la barra de búsqueda de programas. El programa para desinstalar aparece como Microsoft CLI 2.0 para Azure. Seleccione esta aplicación y, después, haga clic en el botón Uninstall.

Eliminar datos

Si no planea volver a instalar la CLI de Azure, quite sus datos de C:\Users\<username>\.azure.

Pasos siguientes

Ahora que ha instalado la CLI de Azure en Windows, dé un breve paseo por sus características y comandos más comunes.