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.

En Windows, la CLI de Azure se instala mediante un archivo MSI 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.52.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 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í".

Versión más reciente de la CLI de Azure (32 bits)Versión 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

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 (32 bits) o https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64 bit)s y descárguelo.

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 finalización con tabulación en PowerShell

PowerShell proporciona finalización en las entradas para proporcionar sugerencias, habilitar la detección y acelerar la entrada. Los nombres de comando, los nombres de los grupos de comandos, los parámetros y determinados valores de parámetro se pueden completar presionando la tecla Tab.

Nota:

Se requiere la versión 2.49 o posterior de la CLI de Azure para habilitar la finalización con tabulación para la CLI de Azure en PowerShell.

Para habilitar la finalización con tabulación en PowerShell, cree o edite 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.

A continuación, agregue el código siguiente al perfil de 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
}

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.

Desinstalar

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 & 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 CLI de Azure en Windows, dé un breve paseo por sus características y comandos más comunes.

Introducción a la CLI de Azure