Compartir a través de

Instalación de la CLI de Azure en Windows

  • Artículo

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.

Para Windows, la CLI de Azure se instala a través de un MSI o un paquete ZIP, que proporciona acceso a la CLI a través del símbolo del sistema de Windows (CMD) o PowerShell. Si está ejecutando el Subsistema de Windows para Linux (WSL), hay paquetes disponibles para la 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 2.70.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 msi y el archivo ZIP distribuible se usan para instalar o actualizar la CLI de Azure en Windows. No necesita desinstalar las versiones actuales antes de utilizar el instalador MSI, ya que éste actualiza cualquier versión existente.

Importante

Una vez completada la instalación, tendrá que cerrar y volver a abrir cualquier ventana activa del terminal para usar la CLI de Azure.

WinGet (Administrador de paquetes de Windows)

Use WinGet, administrador de paquetes de Microsoft para Windows, para instalar y administrar actualizaciones para la CLI de Azure. De forma predeterminada, Winget instala la CLI de Azure de 64 bits en sistemas operativos de 64 bits.

Nota

WinGet está disponible de forma predeterminada en Windows 11 y versiones modernas de Windows 10. Sin embargo, es posible que no esté instalado en versiones anteriores de Windows. Consulte la documentación de winget para obtener instrucciones de instalación.

winget install --exact --id Microsoft.AzureCLI

La opción --exact permite asegurarse de que está instalado el paquete oficial de la CLI de Azure. Este comando instala la versión más reciente de forma predeterminada. Para especificar una versión, agregue a --version <version> con la versión que desee al comando. Este es un ejemplo:

winget install --exact --id Microsoft.AzureCLI --version 2.67.0

Microsoft Installer (MSI)

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 su equipo, seleccione la casilla "Sí".

MSI más reciente de la CLI de Azure (32 bits)

MSI más reciente de la CLI de Azure (64 bits)

Si ha instalado previamente la CLI de Azure, ejecutar el MSI de 32 bits o el MSI de 64 bits sobrescribirá una instalación existente.

Versión específica

Si lo prefiere, puede descargar una versión específica de la Interfaz de la línea de comandos de Azure utilizando una URL.

Para descargar el instalador MSI de una versión específica, cambie el segmento de versión en URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi(32 bits) o https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64 bits).

Por ejemplo, para instalar la MSI de 32 bits de la CLI de Azure versión 2.51.0, la dirección URL sería https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. La instalación de 64 bits correspondiente sería https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.

Las versiones disponibles de la CLI de Azure se pueden encontrar en las notas de la versión de la CLI de Azure. MSI de 64 bits está disponible en la versión 2.51.0.

Microsoft Installer (MSI) con PowerShell

Para instalar la CLI de Azure mediante PowerShell, inicie PowerShell como administrador y ejecute el siguiente comando:

$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi

Esto descargará e instalará el instalador más reciente de 32 bits de la CLI de Azure para Windows. Si prefiere una instalación de 64 bits, cambie la dirección URL a https://aka.ms/installazurecliwindowsx64. Si la CLI de Azure ya está instalada, el instalador sobrescribirá la versión existente.

Para instalar una versión específica, reemplace el argumento -Uri por la dirección URL descrita en la sección siguiente. Este es un ejemplo del uso del instalador de 32 bits de la versión 2.51.0 de la CLI de Azure en PowerShell:

$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi

Versión específica

Para descargar el instalador MSI de una versión específica, cambie el segmento de versión en URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi(32 bits) o https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64 bits).

Por ejemplo, para instalar la MSI de 32 bits de la CLI de Azure versión 2.51.0, la dirección URL sería https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. La instalación de 64 bits correspondiente sería https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.

Las versiones disponibles de la CLI de Azure se pueden encontrar en las notas de la versión de la CLI de Azure. MSI de 64 bits está disponible en la versión 2.51.0.

Diferencias de sintaxis entre Bash y PowerShell

Aunque la mayoría de la documentación de la CLI de Azure está escrita y probada en un shell de Bash, también puede instalar y ejecutar la CLI de Azure mediante PowerShell. Hay diferencias sutiles de sintaxis entre Bash y PowerShell. Revise estos artículos para evitar errores de scripting:

Al ejecutar Azure CLI en PowerShell, también existen diferencias en la gestión de errores y la posibilidad de habilitar la finalización automática de comandos. Para obtener más información, vea estos artículos:

Paquete ZIP

Importante

Este paquete está actualmente en versión preliminar.

Puede usar el paquete ZIP para instalar la CLI de Azure en Windows. Este paquete es útil cuando no tiene privilegios administrativos.

Descomprima el paquete en una carpeta y, a continuación, use Cmd o PowerShell para llamar a la CLI de Azure mediante la ejecución de <unzipped folder path>\bin\az.cmd.

Si desea ejecutar el az comando directamente, siga los pasos que se indican a continuación para agregar la CLI de Azure a la PATH variable de entorno.

  1. Abra el menú Inicio y busque environment variables. Haga clic en Edit the system environment variables.
  2. Haga clic en el botón Environment Variables....
  3. En el User varibles for <username> cuadro, seleccione Path y haga clic en el Edit... botón .
  4. Haga clic en el botón New y agregue <unzipped folder path>\bin a la lista.
  5. Reinicie el terminal. Ahora debería poder ejecutar az comandos.

La versión más reciente

Archivo ZIP más reciente de la CLI de Azure (64 bits)

Versión específica

Si lo prefiere, puede descargar una versión específica de la Interfaz de la línea de comandos de Azure utilizando una URL.

Para descargar el paquete ZIP para una versión específica, cambie el segmento de versión en la dirección URL https://azcliprod.blob.core.windows.net/zip/azure-cli-<version>-x64.zip.

Por ejemplo, para instalar el ARCHIVO ZIP de 64 bits de la CLI de Azure versión 2.57.0, la dirección URL sería https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip.

Las versiones disponibles de la CLI de Azure se pueden encontrar en las notas de la versión de la CLI de Azure. El paquete ZIP está disponible en la versión 2.57.0. Solo está disponible la versión de 64 bits.

Ejecución de la CLI de Azure

Después de la instalación, cierre y vuelva a abrir cualquier ventana de terminal activa. Ejecute la CLI de Azure con el comando az ya sea desde el símbolo del sistema de Windows o desde PowerShell.

Para poder ejecutar comandos de la CLI de Azure, debe iniciar sesión en Azure. Para iniciar sesión de forma interactiva, use az login. Para más información sobre la autenticación, consulte Inicio de sesión en Azure con la CLI de Azure.

az login

Un primer paso común es comprobar la suscripción activa.

az account show

Solución de problemas de instalación

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.

Variable PATH no establecida

La causa más común de este problema es que la ventana del terminal activo no se ha reiniciado después de la instalación. Cierre y vuelva a abrir cualquier ventana de terminal activa.

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/

Para más información, consulte Trabajo detrás de un proxy en la guía de solución de problemas de la CLI de Azure.

Tiempos de respuesta lentos

Consulte Migración a la CLI de Azure de 64 bits.

Habilitar la finalización de pestañas en PowerShell

El autocompletado de comandos, también conocidos como "finalizadores de la CLI de Azure", permite completar inputs para proporcionar pistas, facilitar el descubrimiento y agilizar el ingreso de datos. Los nombres de comandos, grupos de comandos, parámetros y determinados valores de parámetros pueden insertarse automáticamente en la línea de comandos pulsando la tecla Tabulador.

El autocompletado mediante tabulador está habilitado de manera predeterminada en Azure Cloud Shell y en la mayoría de las distribuciones de Linux. A partir de la versión 2.49 de la Interfaz de la línea de comandos de Azure, puede habilitar la finalización de pestañas para Azure CLI en PowerShell. Siga estos pasos:

  1. Crear o editar el perfil almacenado en la variable $PROFILE. La manera más sencilla es ejecutar notepad $PROFILE en PowerShell. Para obtener más información, vea Cómo crear el perfil y Los perfiles y la directiva de ejecución.

  2. Agregue el siguiente código a su perfil PowerShell:

    Register-ArgumentCompleter -Native -CommandName az -ScriptBlock {
    param($commandName, $wordToComplete, $cursorPosition)
    $completion_file = New-TemporaryFile
    $env:ARGCOMPLETE_USE_TEMPFILES = 1
    $env:_ARGCOMPLETE_STDOUT_FILENAME = $completion_file
    $env:COMP_LINE = $wordToComplete
    $env:COMP_POINT = $cursorPosition
    $env:_ARGCOMPLETE = 1
    $env:_ARGCOMPLETE_SUPPRESS_SPACE = 0
    $env:_ARGCOMPLETE_IFS = "`n"
    $env:_ARGCOMPLETE_SHELL = 'powershell'
    az 2>&1 | Out-Null
    Get-Content $completion_file | Sort-Object | ForEach-Object {
        [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_)
    }
    Remove-Item $completion_file, Env:\_ARGCOMPLETE_STDOUT_FILENAME, Env:\ARGCOMPLETE_USE_TEMPFILES, Env:\COMP_LINE, Env:\COMP_POINT, Env:\_ARGCOMPLETE, Env:\_ARGCOMPLETE_SUPPRESS_SPACE, Env:\_ARGCOMPLETE_IFS, Env:\_ARGCOMPLETE_SHELL
}

  3. Para mostrar todas las opciones disponibles en el menú, agregue Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete al perfil de PowerShell.

Actualización de la CLI de Azure

A partir de la versión 2.11.0, la CLI de Azure proporciona un comando en la herramienta para actualizar a la versión más reciente.

az upgrade

Este comando también actualiza todas las extensiones instaladas de forma predeterminada. Para más opciones de az upgrade, consulte la página de referencia del comando. Para las versiones de la CLI de Azure anteriores a la 2.11.0, actualice mediante la reinstalación como se describe en Instalación de la CLI de Azure.

Si usa la distribución ZIP, elimine la carpeta de instalación anterior y extraiga la nueva versión en la misma ubicación.

Migración a la CLI de Azure de 64 bits

A partir de la versión 2.51.0, la CLI de Azure también proporciona MSI de 64 bits, que se recomienda para mejorar el rendimiento.

Siga estos pasos para migrar a la CLI de Azure de 64 bits:

  1. Compruebe la versión actual de la CLI y las extensiones instaladas mediante la ejecución de az --version.
  2. Las extensiones deberán volver a instalarse. Se recomienda realizar una copia de seguridad de la carpeta de extensión %userprofile%\.azure\cliextensions actual cambiando el nombre en caso de que elija revertir a 32 bits. Esta carpeta se crea automáticamente al reinstalar una extensión.
  3. Descargue e instale el instalador de 64 bits más reciente, tal y como se describe en Instalación o actualización. La MSI de 32 bits se desinstalará automáticamente.
  4. Instale extensiones mediante la ejecución de az extension add --name <extension> --version <version>. Si no desea volver a instalar las extensiones manualmente, la CLI de Azure le pedirá que instale una extensión en el primer uso. Para más información sobre cómo instalar extensiones, vea Procedimiento para instalar extensiones.

Si tiene problemas después de la migración, puede desinstalar el MSI de 64 bits y volver a instalar el MSI de 32 bits. Si ha realizado una copia de seguridad de la carpeta de extensión de 32 bits, restaure (cambie el nombre de) la carpeta de extensión después del cambio.

Desinstalación

Si decide desinstalar la CLI de Azure, lamentamos verlo irse. 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 Instrucciones
Windows 11 Inicio > Configuración > Aplicaciones > Aplicaciones instaladas
Windows 10 Iniciar > Configuración > Aplicaciones > Aplicaciones y características
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, a continuación, el botón Uninstall.

Eliminar datos

Si no planea volver a instalar la CLI de Azure, elimine sus datos de C:\Users\<username>\.azure\msal_token_cache.bin o C:\Users\<username>\.azure\msal_token_cache.json.

Pasos siguientes

Ahora que ha instalado la Interfaz de la línea de comandos de Azure en Windows, conozca las diferentes formas de iniciar sesión.

Inicio de sesión con la CLI de Azure