Introducción a la CLI de Azure

2025-05-22

La CLI de Azure es una herramienta multiplataforma que simplifica la administración de recursos de Azure desde la línea de comandos. Optimizado para automatización y facilidad de uso, admite sesiones interactivas y scripting con comandos sencillos que se integran perfectamente con el modelo de Azure Resource Manager. Puede empezar a usarlo en el explorador con Azure Cloud Shell o instalarlo localmente para usarlo desde su terminal preferido.

Instalación o ejecución en Azure Cloud Shell

La manera más fácil de probar la CLI de Azure es a través de Azure Cloud Shell, un shell basado en explorador sin que se requiera ninguna instalación. Cloud Shell admite Bash y PowerShell y viene con la versión más reciente de la CLI de Azure preinstalada.

Para instalar la CLI de Azure localmente, consulte Instalación de la CLI de Azure.

Para comprobar la versión, ejecute:

az version

Para empezar a usar la CLI de Azure con una instalación local, inicie sesión:

Ejecute el comando az login.
```
az login
```
Si la CLI de Azure puede abrir el explorador predeterminado, inicia el flujo de código de autorización y abre el explorador predeterminado para cargar una página de inicio de sesión de Azure.

De lo contrario, se inicia el flujo de código del dispositivo y se le indica que abra una página del navegador en https://aka.ms/devicelogin. A continuación, escriba el código que se muestra en el terminal.

Si no hay ningún explorador web disponible o no se puede abrir el explorador web, puede forzar el flujo de código del dispositivo con az login --use-device-code.
Inicie sesión con las credenciales de su cuenta en el explorador.

Importante

A partir de 2025, Microsoft aplicará MFA obligatorio para la CLI de Azure y otras herramientas de línea de comandos. MFA solo afectará a las identidades de usuario de Microsoft Entra ID . No afectará a las identidades de carga de trabajo, como las entidades de servicio y las identidades administradas .

Si usa az login con un ID de Entra y una contraseña para autenticar un script o un proceso automatizado, planee migrar ahora a una identidad de carga de trabajo. Para más información, consulte Impacto de la autenticación multifactor en la CLI de Azure en escenarios de automatización.

Después de iniciar sesión, aparece una lista de las suscripciones. El marcado isDefault: true está activo actualmente. Para cambiar a otra suscripción, ejecute:

az account set --subscription "<subscription-id>"

Para más información sobre la selección de suscripciones, consulte Administración de suscripciones de Azure. Para ver las opciones avanzadas de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.

Búsqueda de comandos

Los comandos de la CLI de Azure se organizan como grupos de comandos. Cada grupo representa un área de un servicio de Azure. Hay dos opciones para buscar grupos de comandos:

Use el comando az find . Por ejemplo, para buscar nombres de comando que contengan vm, use el ejemplo siguiente:
```
az find vm
```

Use el --help argumento para obtener una lista completa de subgrupos dentro de un grupo de referencia. En el ejemplo siguiente se devuelven todos los subgrupos para las máquinas virtuales:

az vm --help

En el ejemplo siguiente se muestra la parte pertinente de la salida.

Subgroups:
  application            : Manage applications for VM.
  availability-set       : Group resources into availability sets.
  boot-diagnostics       : Troubleshoot the startup of an Azure Virtual Machine.
  ...

La salida de ayuda incluye subgrupos, parámetros, opciones de autenticación y ejemplos.

Este es otro ejemplo que busca los comandos de la CLI de Azure para agrupar máquinas virtuales en conjuntos de disponibilidad, un subgrupo de az vm:

az vm availability-set --help

También puede usar --help para obtener listas de parámetros y ejemplos de comandos para un comando de referencia.

az vm create --help

Esta es la sección pertinente de la salida de ejemplo:

Arguments
    --name  [Required] : Name of the virtual machine.
    ...
Authentication Arguments
    --admin-password   : Password for the VM if authentication type is 'Password'.
    --admin-username   : Username for the VM...
    ...
Managed Service Identity Arguments
    ...
Examples
    Create a VM from a custom managed image.
      az vm create -g MyResourceGroup -n MyVm --image MyImage
    ...

Use el índice de referencia que enumera todos los grupos de comandos alfabéticamente.

Exploración de ejemplos y artículos

Para obtener ejemplos de uso, consulte:

Índice de ejemplos de ejemplos de la CLI de Azure por asunto, grupo de referencia o repositorio de GitHub.

Índice de artículo para buscar guías detalladas. Utiliza las teclas de acceso rápido del teclado find, como Ctrl + F, para encontrar rápidamente el grupo de comandos de referencia que te interese. Por ejemplo, el índice de artículo para az vm tiene un aspecto similar a la tabla siguiente:

Subgrupo de referencia	Artículo sobre la CLI de Azure que muestra su uso como referencia
az vm	Formatos de salida para los comandos de la CLI de Azure
	Uso de variables en comandos de la CLI de Azure
	Obtención de información de máquina virtual con consultas
	{Más artículos enumerados aquí.}
az vm aem	Nueva versión de la extensión de máquina virtual de Azure para soluciones de SAP
	Versión estándar de la extensión de máquina virtual de Azure para soluciones de SAP
az vm application	{...}

Utiliza la autocompleción con la tecla Tab

La CLI de Azure admite la finalización de tabulaciones en Bash. Para habilitarlo en PowerShell, consulte Habilitación de la finalización de pestañas en PowerShell.

Descripción de los argumentos globales

Entre los argumentos comunes disponibles para la mayoría de los comandos se incluyen:

Argumento	Descripción
`--help`	Ver ayuda del comando
`--output`	Cambiar el formato de salida: `json`, `jsonc`, `tsv`, , `table`, `yaml`
`--query`	Filtrar la salida mediante JMESPath
`--verbose`	Imprimir más detalles de ejecución
`--debug`	Mostrar llamadas REST de bajo nivel para la depuración
`--subscription`	Especificar el nombre o el identificador de la suscripción
`--only-show-errors`	Suprimir la información no crítica

Para obtener más información, consulte Formatos de salida y Resultados de consulta.

Uso del modo interactivo

Ejecute el modo interactivo con:

az interactive

El modo interactivo inicia una experiencia mejorada de la CLI de Azure con ayuda en línea y sugerencias de comandos. Para obtener más información, consulta Modo interactivo.

Una extensión opcional de VS Code proporciona características similares con autocompletar y consejos al pasar el cursor.

Aprenda a través de tutoriales e inicios rápidos

Obtenga información práctica sobre los aspectos básicos de la CLI de Azure mediante el tutorial de incorporación. Aprenderá a:

Nota:

Los ejemplos de la CLI de Azure en Microsoft Learn se escriben para Bash. Normalmente, los comandos de una sola línea funcionan a través de diferentes shells, pero los scripts de varias líneas pueden requerir ajustes. Para más información, consulte Diferencias de sintaxis de Learn entre Bash, PowerShell y Cmd.

Proporcionar comentarios

Agradecemos sus comentarios. Envíe problemas en GitHub o ejecute:

az feedback

Compartir a través de