Aller au contenu

Glossaire des principales commandes Azure CLI

Azure CLI est un outil en ligne de commande permettant de créer, consulter, modifier et supprimer des ressources Azure. Ses commandes commencent par az.

Dans Azure Cloud Shell, Azure CLI est préinstallé et l’authentification est automatique. Les exemples ci-dessous sont écrits sur une seule ligne et peuvent être exécutés dans Bash ou PowerShell.

Les noms comme rg-cli-demo, vm-demo et vnet-demo sont des exemples à adapter. Les commandes portant sur une ressource existante supposent qu’elle a déjà été créée.

1. Comprendre la syntaxe

Une commande suit généralement cette structure :

az <groupe> <sous-groupe éventuel> <action> <paramètres>

Par exemple :

az group create --name rg-cli-demo --location francecentral
Élément Signification
az Exécute Azure CLI.
group Désigne les groupes de ressources.
create Demande une création.
--name Définit le nom du groupe de ressources.
--location Définit la région du groupe de ressources.

Les actions les plus fréquentes sont list pour lister, show pour consulter, create pour créer, update pour modifier et delete pour supprimer. Leur disponibilité dépend du groupe de commandes.

2. Aide et version

az version — Afficher les versions installées

Affiche notamment la version d’Azure CLI.

az version

--help — Consulter l’aide

Affiche les commandes disponibles, les paramètres et des exemples.

az --help
az group --help
az group create --help

L’aide peut être demandée à chaque niveau d’une commande.

3. Abonnements et régions

Les commandes az account permettent de consulter les abonnements accessibles et de choisir celui sur lequel travailler.

az account list — Lister les abonnements

az account list --output table

az account show — Consulter l’abonnement actif

az account show --output table

Pour afficher uniquement son identifiant :

az account show --query id --output tsv

az account set — Choisir l’abonnement actif

Remplacer la valeur par le nom ou l’identifiant d’un abonnement accessible.

az account set --subscription "Mon abonnement Azure"

Les commandes suivantes utilisent cet abonnement, sauf indication contraire avec --subscription.

az account list-locations — Lister les régions

az account list-locations --output table

Une région présente dans cette liste ne garantit pas que tous les services et toutes les tailles de machines virtuelles y soient disponibles pour votre abonnement.

4. Groupes de ressources

Les commandes az group gèrent les groupes qui contiennent les ressources Azure.

az group list — Lister les groupes

az group list --output table

az group create — Créer un groupe

az group create --name rg-cli-demo --location francecentral

Avec des balises :

az group create --name rg-cli-demo --location francecentral --tags environnement=formation projet=demo

az group show — Consulter un groupe

az group show --name rg-cli-demo

az group exists — Vérifier son existence

Renvoie true ou false.

az group exists --name rg-cli-demo

az group delete — Supprimer un groupe et ses ressources

Cette commande supprime le groupe ainsi que les ressources qu’il contient.

az group delete --name rg-cli-demo

Une confirmation est demandée. Le paramètre --yes permet de la supprimer dans un script.

5. Ressources Azure

Les commandes az resource permettent de travailler sur différents types de ressources avec une syntaxe générique.

az resource list — Lister les ressources

Dans l’abonnement actif :

az resource list --output table

Dans un groupe particulier :

az resource list --resource-group rg-cli-demo --output table

Pour un type de ressource :

az resource list --resource-type Microsoft.Compute/virtualMachines --output table

az resource show — Consulter une ressource

Le type permet d’identifier la nature de la ressource recherchée.

az resource show --resource-group rg-cli-demo --name vm-demo --resource-type Microsoft.Compute/virtualMachines

az resource delete — Supprimer une ressource

L’exemple suivant supprime la machine virtuelle indiquée. Le devenir de ses disques et interfaces réseau dépend notamment de leur configuration de suppression.

az resource delete --resource-group rg-cli-demo --name vm-demo --resource-type Microsoft.Compute/virtualMachines

6. Machines virtuelles

Les commandes az vm permettent de consulter les machines virtuelles et de gérer leur exécution.

az vm list — Lister les machines virtuelles

az vm list --resource-group rg-cli-demo --output table

az vm show — Consulter une machine virtuelle

az vm show --resource-group rg-cli-demo --name vm-demo

Pour afficher son état d’exécution et des informations complémentaires :

az vm show --resource-group rg-cli-demo --name vm-demo --show-details --output table

az vm start — Démarrer une machine virtuelle

az vm start --resource-group rg-cli-demo --name vm-demo

az vm restart — Redémarrer une machine virtuelle

az vm restart --resource-group rg-cli-demo --name vm-demo

az vm stop — Arrêter une machine virtuelle

az vm stop --resource-group rg-cli-demo --name vm-demo

L’arrêt conserve l’allocation des ressources de calcul : leur facturation continue.

az vm deallocate — Arrêter et désallouer une machine virtuelle

az vm deallocate --resource-group rg-cli-demo --name vm-demo

La désallocation libère les ressources de calcul et arrête leur facturation à l’usage. Les disques et certains autres services associés restent facturables.

az vm list-ip-addresses — Afficher les adresses IP

az vm list-ip-addresses --resource-group rg-cli-demo --name vm-demo --output table

7. Réseaux virtuels

Les commandes az network vnet permettent de gérer les réseaux virtuels Azure.

az network vnet list — Lister les réseaux virtuels

az network vnet list --resource-group rg-cli-demo --output table

az network vnet create — Créer un réseau virtuel

Crée un réseau avec l’espace d’adressage 10.0.0.0/16 et un premier sous-réseau en 10.0.1.0/24.

az network vnet create --resource-group rg-cli-demo --name vnet-demo --location francecentral --address-prefixes 10.0.0.0/16 --subnet-name snet-app --subnet-prefixes 10.0.1.0/24

az network vnet show — Consulter un réseau virtuel

az network vnet show --resource-group rg-cli-demo --name vnet-demo

8. Déploiements ARM et Bicep

Les commandes az deployment group exécutent des déploiements à l’échelle d’un groupe de ressources. Les exemples supposent qu’un fichier main.bicep est présent dans le dossier courant et que le groupe existe.

az deployment group validate — Valider un déploiement

Vérifie le modèle et sa validité dans le contexte du déploiement, sans créer les ressources.

az deployment group validate --resource-group rg-cli-demo --template-file main.bicep

az deployment group what-if — Prévisualiser les changements

Présente les changements prévus avant de les appliquer.

az deployment group what-if --resource-group rg-cli-demo --template-file main.bicep

az deployment group create — Exécuter un déploiement

az deployment group create --resource-group rg-cli-demo --name deploiement-demo --template-file main.bicep

Pour un modèle ARM JSON, remplacer main.bicep par le nom du fichier JSON.

az deployment group list — Lister les déploiements

az deployment group list --resource-group rg-cli-demo --output table

9. Affichage et filtrage des résultats

--output — Choisir le format de sortie

Valeur Utilisation
json Format structuré par défaut.
table Tableau lisible dans la console.
tsv Valeurs séparées par des tabulations, pratiques dans les scripts.
yaml Format structuré YAML.
none Masque la sortie normale de la commande. 
az group list --output table
az group list --output json

Le format table n’affiche pas nécessairement toutes les propriétés disponibles.

--query — Sélectionner et filtrer les résultats

Utilise le langage JMESPath pour sélectionner des propriétés ou filtrer les données renvoyées. Ce paramètre transforme la sortie ; il ne modifie pas les ressources.

Afficher uniquement les noms des groupes :

az group list --query "[].name" --output tsv

Afficher leur nom et leur région :

az group list --query "[].{Nom:name,Region:location}" --output table

Afficher les groupes situés en France Central :

az group list --query "[?location=='francecentral'].{Nom:name,Region:location}" --output table

10. Paramètres à retenir

Paramètre Alias Rôle Exemple
--help -h Afficher l’aide. az vm --help
--name -n Indiquer le nom de l’objet. az group show -n rg-cli-demo
--resource-group -g Indiquer le groupe de ressources. az vm list -g rg-cli-demo
--location -l Indiquer la région, lorsque ce paramètre est proposé. az group create -n rg-cli-demo -l francecentral
--output -o Choisir le format de sortie. az group list -o table
--subscription — Cibler un abonnement pour une commande. az group list --subscription "Mon abonnement Azure"
--query — Sélectionner ou filtrer les résultats. az group list --query "[].name"
--verbose — Afficher davantage d’informations d’exécution. az group list --verbose
--debug — Afficher les détails de diagnostic. az group list --debug

Les paramètres et leurs alias dépendent de la commande : --help reste le moyen le plus direct de les vérifier.

Documentation Microsoft