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 la 2.59.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.

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, la ejecución de MSI de 32 bits o 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.

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.

Habilitar la finalización de pestañas en PowerShell

La finalización de pestañas, también conocido como "Finalizadores de la Interfaz de la línea de comandos de Azure", proporciona completado en las entradas para proporcionar pistas, permitir el descubrimiento y acelerar la entrada de entradas. 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 tabulador está activado por defecto 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.

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/

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.

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.

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 11 Inicio > Configuración > Aplicaciones > Aplicaciones instaladas
Windows 10 Inicio > Configuración > Sistema > 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