Introducción a la CLI de Azure

Artículo
03/11/2024

Le damos la bienvenida a la interfaz de la línea de comandos de Azure (CLI). En este artículo se presenta la CLI y se facilita ayuda sobre la realización de tareas comunes.

Instalación o ejecución en Azure Cloud Shell

La manera más fácil de aprender a usar la CLI de Azure es ejecutar un entorno de Bash en Azure Cloud Shell a través del explorador. Para más información acerca de Cloud Shell, consulte Guía de inicio rápido para Bash en Azure Cloud Shell.

Cuando esté listo para instalar la CLI de Azure, consulte las instrucciones de instalación del contenedor Windows, Linux, macOS y Docker. Si usa el modelo de implementación clásico de Azure, instale la CLI clásica de Azure.

Para comprobar la versión, ejecute az --version. Azure Cloud Shell siempre tiene la versión más reciente de la CLI de Azure preinstalada.

az version

Inicio de sesión en la CLI de Azure

Antes de usar los comandos de la CLI de Azure en una instalación local, deberá iniciar sesión con az login.

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, inicie el flujo de código del dispositivo y le indica que abra una página del explorador 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, es posible que tenga que forzar el flujo de código de dispositivo con az login --use-device-code.
Inicie sesión con las credenciales de su cuenta en el explorador.

Después de iniciar sesión, recibirá una lista de suscripciones asociadas a su cuenta de Azure. La información de suscripción con isDefault: true es la suscripción actualmente activada después de iniciar sesión. Para seleccionar otra suscripción, use el comando az account set con el identificador de suscripción de la cuenta deseada. Para más información sobre la selección de suscripciones, consulte Administración de suscripciones de Azure.

Hay varias formas de iniciar sesión de una manera no interactiva, que se describen con detalle en 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 contienen vm, use el siguiente comando:
```
az find vm
```

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

az vm --help

Esta es la salida de ejemplo con líneas omitidas para mayor brevedad:

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

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

--help Use también para obtener listas de parámetros y ejemplos de comandos para un comando de referencia.

az vm create --help

Esta es la salida de ejemplo con líneas omitidas para mayor brevedad:

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 A a Z que enumera todos los grupos de comandos alfabéticamente.

Búsqueda de ejemplos y artículos publicados

Si prefiere aprender la sintaxis de la CLI de Azure mediante la visualización de ejemplos publicados probados, hay dos índices de contenido del artículo:

Ejemplos de índice A a Z. El índice de ejemplos proporciona una lista de ejemplos de la CLI de Azure ordenados por área de asunto, grupo de referencia y repositorio de GitHub.

Índice de artículo A a Z. Use las teclas de método abreviado de teclado find , como Ctrl + F, para quitar rápidamente al grupo de comandos de referencia en el que está interesado. Por ejemplo, el índice de artículo tiene un aspecto similar al siguiente para az vm:

Subgrupo de referencia	Artículo de la CLI de Azure que muestra el uso de la 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 la 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	{...}

Uso de la finalización de tabulación

La CLI tiene finalización de pestaña completa para los comandos en un entorno de Bash. Para habilitar la finalización de pestañas en un entorno de PowerShell, consulte Habilitación de la finalización de pestañas en PowerShell.

Tenga en cuenta los argumentos disponibles globalmente.

Hay algunos argumentos disponibles para la mayoría de los comandos.

--help imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los comandos y subgrupos disponibles.
--output cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), table (tablas ASCII en lenguaje natural) y yaml. De forma predeterminada, la CLI genera json. Para más información sobre los formatos de salida disponibles, consulte Formatos de salida de la CLI de Azure.
--query usa el lenguaje de consulta JMESPath para filtrar los resultados devueltos por los servicios de Azure. Para más información sobre las consultas, vea Consulta de los resultados de los comandos con la CLI de Azure y Tutorial de JMESPath.
--verbose imprime información acerca de los recursos creados en Azure durante una operación y otra información de utilidad.
--debug imprime más información aún sobre las operaciones de la CLI y se utiliza con fines de depuración. Si encuentra un error, proporcione la salida que se genera con la marca --debug activada al enviar un informe de errores.
--subscription es el nombre o el identificador de una suscripción. Para más información sobre cómo establecer la suscripción predeterminada, consulte Administración de suscripciones de Azure con la CLI de Azure.
--only-show-errors suprime las advertencias en la salida del comando y solo muestra errores.

Uso del modo interactivo

La CLI ofrece un modo interactivo que muestra automáticamente información de ayuda y facilita la selección de subcomandos. Puede entrar en el modo interactivo con el comando az interactive.

az interactive

Para más información sobre el modo interactivo, consulte Ejecución de la CLI de Azure en modo interactivo.

También hay un complemento de Visual Studio Code que ofrece una experiencia interactiva, incluida la función de autocompletar y documentación al pasar el ratón.

Información sobre los conceptos básicos de la CLI de Azure con inicios rápidos y tutoriales

Para aprender a usar la CLI de Azure, pruebe nuestro tutorial de incorporación que le enseña las siguientes aptitudes al trabajar con Azure Storage:

Busque y cambie la suscripción predeterminada.
Cree un recurso de Azure que contenga un identificador aleatorio en el nombre.
Establecer variables de entorno.
Obtenga información sobre las diferencias de sintaxis entre Bash, PowerShell y Cmd.
Depuración de comandos de referencia de la CLI de Azure.
Obtiene las propiedades de un archivo JSON local. En este ejemplo se muestra cómo obtener valores de configuración para desarrollo, fase y producción.
Elimine varios recursos mediante un script.

Nota:

En scripts y en el sitio de documentación de Microsoft, los ejemplos de la CLI de Azure se escriben para el shell de Bash. La mayoría de los ejemplos de una línea se ejecutarán en cualquier plataforma. Algunos ejemplos más largos que incluyen continuaciones de línea (\), asignación de variables o comillas deben modificarse para que funcionen en otros shells, incluido PowerShell. Para obtener más información sobre las diferencias de sintaxis entre entornos, consulte Diferencias de sintaxis entre Bash, PowerShell y Cmd.

Proporcionar comentarios

Le agradecemos sus comentarios sobre la CLI para ayudarnos a mejorar y resolver errores. También puede informar de un problema en GitHub o utilizar las características integradas de la CLI para dejar comentarios generales con el comando az feedback.

az feedback