Compartir vía

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 también se puede usar desde un explorador a través de 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 paquete MSI o ZIP, lo que proporciona acceso a la CLI de Azure mediante PowerShell o el Command Prompt de Windows (cmd.exe). 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 la 2.75.0. Para obtener información sobre la última versión, consulte las notas de la versión. Para averiguar tu versión instalada y ver si necesitas actualizar, ejecuta 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, debe cerrar y volver a abrir cualquier ventana de terminal activa 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)

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. Consulte estos artículos para obtener más información:

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 variables 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.

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 desde PowerShell o la consola de comandos de Windows.

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 experimenta un problema que no se trata aquí, presente un problema en GitHub.

Variable PATH no establecida

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

El servidor proxy bloquea la conexión

Si no puede descargar el instalador msi porque el proxy está bloqueando la conexión, asegúrese de que tiene configurado el proxy. Para Windows 11, esta configuración se administra en el Settings > Network & Internet > Proxy panel. Póngase en contacto con el administrador del sistema para conocer la configuración necesaria o para situaciones en las que la máquina podría administrarse o requerir una configuración avanzada.

Importante

Esta configuración también es necesaria para poder acceder a los servicios de Azure usando la CLI de Azure, ya sea desde PowerShell o desde el símbolo del sistema. En PowerShell, realizará esta configuración con el siguiente comando:

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

Para obtener el MSI, el proxy debe permitir 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.

Habilitación de 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 az upgrade opciones, 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, quite 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 una MSI de 64 bits, que se recomienda para mejorar el rendimiento.

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

  1. Compruebe la versión actual de la CLI de Azure y las extensiones instaladas ejecutando az --version.
  2. Las extensiones requieren reinstalación. Realice una copia de seguridad de la carpeta %userprofile%\.azure\cliextensions de extensión actual cambiando su nombre en caso de que decida revertir a la versión de 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 como se describe en Instalación o actualización. La MSI de 32 bits se desinstala automáticamente.
  4. Instale extensiones mediante la ejecución de az extension add --name <extension> --version <version>. Si no desea reinstalar las extensiones manualmente, la CLI de Azure le pedirá que instale una extensión en primer uso. Para más información sobre cómo instalar extensiones, vea Procedimiento para instalar extensiones.

Si experimenta problemas después de la migración, puede desinstalar la versión de 64 bits y volver a instalar la MSI de 32 bits. Si realizó una copia de seguridad de la carpeta de extensiones de 32 bits, restaure o cambie el nombre de la carpeta de extensión después del cambio.

Desinstalar

Si decides desinstalar la CLI de Azure, lamentamos que decidas irte. 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 agradeceríamos 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 instaló la CLI de Azure en Windows, obtenga información sobre las distintas formas de iniciar sesión.

Inicio de sesión con la CLI de Azure