¿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, combine los comandos de la CLI en un script del shell con la sintaxis de script del shell elegido 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.59.0. Para más información sobre la versión más reciente, consulte las notas de la versión. Para averiguar la versión instalada y ver si tiene que actualizar, ejecute 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:
| Get-Help | Azure CLI | Azure PowerShell |
|---|---|---|
| Crear grupo de recursos | az group create --name <ResourceGroupName> --location eastus | New-AzResourceGroup -Name <ResourceGroupName> -Location 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 | New-AzStorageAccount -Name <StorageAccountName> -ResourceGroupName <ResourceGroupName> -Location 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 (Diferencias de sintaxis de la CLI de Azure).
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 para dar formato a los resultados del comando de la --output CLI de Azure. Este es un ejemplo:
az account list --output table
Establezca la salida predeterminada estableciendo la propiedad de configuración como se describe en Configuración de la output CLI de Azure.
az config set core.output=jsonc
datos, recopilación
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.