Compartir a través de


Introducción a la CLI de Azure

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.

  1. 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.

  2. 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:

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. Se puede usar, por ejemplo, para identificar la API REST que el comando ejecutado está invocando debajo y la respuesta recibida del servicio.

  • --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:

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

Consulte también