¿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, Mac o Windows. También se puede usar desde un explorador mediante 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.44.1. 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.
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.
Preparación del entorno
Antes de ejecutar comandos de la CLI de Azure, debe configurar el entorno.
Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Inicio rápido para Bash en Azure Cloud Shell.
Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.
Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.
En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.
Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.
Ejemplos de la CLI de Azure
En este artículo se incluyen diferentes ejemplos de la CLI de Azure para los casos siguientes:
- Sintaxis de suscripción
- Sintaxis de asignación de roles
- Sintaxis de PowerShell
Ejemplo de sintaxis de suscripción
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"
¿Ha sido sencillo? Consulte Administración de suscripciones con la CLI de Azure para más información sobre el uso de la CLI de Azure para trabajar con suscripciones y crear grupos de administración.
Ejemplo de sintaxis de asignación de roles
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
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 |