Compartir a través de

¿Qué es la CLI de Azure?

La interfaz de la línea de comandos (CLI) de Azure es una herramienta multiplataforma para conectarse a Azure y ejecutar comandos administrativos en los recursos de Azure. Permite la ejecución de comandos mediante un terminal con mensajes de la línea de comandos interactivos o un script.

Para un uso interactivo, inicie primero un shell como cmd.exe en Windows o Bash en Linux o macOS y, a continuación, emita el comando en el símbolo del shell. Para automatizar las tareas repetitivas, una los comandos CLI en un script usando la sintaxis de scripts de tu terminal elegida y luego ejecute el script.

Puede instalar la CLI de Azure localmente en equipos Linux, macOS o Windows. También se puede usar desde un explorador a través de Azure Cloud Shell o ejecutarse desde dentro de un contenedor de Docker.

Versión actual

La versión actual de la CLI de Azure es la 2.74.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.

Autenticación

La CLI de Azure admite varios métodos de autenticación. Para obtener información detallada sobre la autenticación en Azure desde la CLI de Azure, consulte Inicio de sesión con la CLI de Azure.

Diseño de referencia de comandos

La sintaxis de la CLI de Azure sigue un patrón reference name - command - parameter - parameter value simple. Por ejemplo, cambiar entre suscripciones suele ser una tarea común. Esta es la sintaxis.

az account set --subscription "my subscription name"

Otro uso común de la CLI de Azure es administrar las asignaciones de roles.

az role assignment create --assignee servicePrincipalName --role Reader --scope /subscriptions/mySubscriptionID/resourceGroups/myResourceGroupName
az role assignment delete --assignee userSign-inName --role Contributor

Para más información sobre cómo administrar suscripciones, consulte Administración de suscripciones con la CLI de Azure. Consulte Creación de una entidad de servicio de Azure con la CLI de Azure para obtener un tutorial detallado sobre la administración de entidades de servicio y asignaciones de roles.

Comparación con la sintaxis de PowerShell

El artículo Elección de la herramienta de la línea de comandos adecuada explica la diferencia entre tools y environments con énfasis en la CLI de Azure y Azure PowerShell. También proporciona muchas comparaciones de comandos en paralelo. Estos son dos ejemplos:

Comando CLI de Azure Azure PowerShell
Crear grupo de recursos Para crear un grupo de recursos en Azure, use el comando: az group create --name <ResourceGroupName> --location eastus. Cambie "ResourceGroupName" por el nombre deseado para su grupo de recursos. New-AzResourceGroup -Name <ResourceGroupName> -Ubicación eastus
Creación de una cuenta de Azure Storage az storage account create --name <StorageAccountName> --resource-group <ResourceGroupName> --location eastus --sku Standard_LRS --kind StorageV2 // Permite crear una cuenta de almacenamiento especificando el nombre, grupo de recursos, ubicación, tipo de redundancia de almacenamiento (SKU) y tipo de cuenta. New-AzStorageAccount -Name <StorageAccountName> -ResourceGroupName <ResourceGroupName> -Ubicación eastus -SkuName Standard_LRS -Kind StorageV2

Para ver las comparaciones de sintaxis de la CLI de Azure entre los entornos de Bash y PowerShell, consulte Learn Azure CLI syntax differences in Bash, PowerShell and Cmd (Información sobre las diferencias de sintaxis de la CLI de Azure en Bash, PowerShell y Cmd).

Formatos de salida

La CLI de Azure usa JSON como formato de salida predeterminado, pero ofrece otros formatos como se describe en Formatos de salida para comandos de la CLI de Azure. Use el parámetro --output para dar formato a los resultados del comando de la CLI de Azure. Este es un ejemplo:

az account list --output table

Establezca la salida predeterminada configurando la propiedad output, tal como se describe en la configuración de la CLI de Azure.

az config set core.output=jsonc

Recopilación de datos

La CLI de Azure recopila los datos de telemetría de forma predeterminada. Microsoft agrega los datos recopilados para identificar patrones de uso con el fin de identificar problemas comunes y mejorar la experiencia con la CLI de Azure. La CLI de Microsoft Azure no recopila datos personales ni privados. Por ejemplo, los datos de uso ayudan a identificar problemas tales como los comandos que se usan poco y ayudan a asignar prioridades al trabajo.

Aunque la información que ofrecen estos datos es muy útil, también sabemos que no todos quieren enviar los datos de uso. Puede deshabilitar la recopilación de datos con el comando az config set core.collect_telemetry=false. También puede leer nuestra declaración de privacidad para obtener más información.

Véase también