Instalación del CLI de Azure en Windows

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

Para Windows, CLI de Azure se instala a través de un MSI o un paquete ZIP, lo que proporciona acceso a CLI de Azure desde PowerShell o el símbolo del sistema de Windows (cmd.exe). Al realizar una instalación para Subsistema de Windows para Linux (WSL), los paquetes están 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 del CLI de Azure es 2.84.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

La distribución MSI y ZIP se usan para instalar o actualizar el 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.

winget install --exact --id Microsoft.AzureCLI

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

$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

$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

Ejecución del 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 el símbolo del sistema de Windows.

Para poder ejecutar comandos CLI de Azure, debe iniciar sesión en Azure. Para iniciar sesión de forma interactiva, use . Para obtener información sobre la autenticación, consulte Sign into Azure with 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 detectados al instalar el CLI de Azure en Windows. Si experimenta un problema que no se trata aquí, file 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 panel Settings > Network & Internet > Proxy. 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.

(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 obtener 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 Migrar a CLI de Azure de 64 bits

Habilitación de la finalización de pestañas en PowerShell

El autocompletado de tabulación, también conocido como "completadores de CLI de Azure", proporciona finalización en las entradas para ofrecer sugerencias, habilitar la detección y acelerar la entrada. 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.

La finalización de tabulación está habilitada de forma predeterminada en Azure Cloud Shell y en la mayoría de las distribuciones de Linux. A partir de CLI de Azure versión 2.49, puede habilitar la finalización de tabulación para el CLI de Azure en PowerShell. Siga estos pasos:

1. Crear o editar el perfil almacenado en la variable . La manera más sencilla es ejecutar 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 al perfil de PowerShell.

Actualización del CLI de Azure

A partir de la versión 2.11.0, el 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, consulte la página de referencia del comando. Para las versiones de CLI de Azure anteriores a 2.11.0, actualice reinstalando como se describe en Instalar el 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 CLI de Azure de 64 bits

A partir de la versión 2.51.0, 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 CLI de Azure:

1. Compruebe la versión actual de CLI de Azure y las extensiones instaladas mediante la ejecución de az --version.
2. Las extensiones requieren reinstalación. Realice una copia de seguridad de la carpeta 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 . Si no desea reinstalar las extensiones manualmente, el 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 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 decide desinstalar el CLI de Azure, lamentamos su partida. Antes de desinstalar, use el comando para contarnos lo que se podría mejorar o corregir. Nuestro objetivo es que el CLI de Azure sea libre de errores y fácil de usar. Si encontró un error, le agradeceríamos si file un problema de GitHub.

Desinstale el CLI de Azure de la lista Windows "Aplicaciones y características". Para desinstalar:

Una vez en esta pantalla, escriba CLI de Azure en la barra de búsqueda del programa. El programa que se va a desinstalar aparece como Microsoft CLI 2.0 para Azure. Seleccione esta aplicación y, a continuación, el botón .

Eliminar datos

Si no tiene previsto volver a instalar CLI de Azure, quite 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ó el CLI de Azure en Windows, obtenga información sobre las distintas formas de iniciar sesión.