Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Azure CLI est un outil multiplateforme qui simplifie la gestion des ressources Azure à partir de la ligne de commande. Optimisé pour l’automatisation et la facilité d’utilisation, il prend en charge les sessions interactives et les scripts avec des commandes simples qui s’intègrent en toute transparence au modèle Azure Resource Manager. Vous pouvez commencer à l’utiliser dans votre navigateur avec Azure Cloud Shell ou l’installer localement pour l’utiliser à partir de votre terminal préféré.
Installer ou exécuter dans Azure Cloud Shell
Le moyen le plus simple d’essayer Azure CLI consiste à utiliser Azure Cloud Shell, un interpréteur de commandes basé sur un navigateur sans installation requise. Cloud Shell prend en charge Bash et PowerShell et est fourni avec la dernière version d’Azure CLI préinstallée.
Pour installer Azure CLI localement, consultez Comment installer Azure CLI.
Pour vérifier votre version, exécutez :
az version
Connexion à Azure
Pour commencer à utiliser Azure CLI avec une installation locale, connectez-vous :
Exécutez la commande
az login
.az login
Si Azure CLI peut ouvrir votre navigateur par défaut, il lance le flux de code d’autorisation et ouvre le navigateur par défaut pour charger une page de connexion Azure.
Sinon, il lance le flux de code de l’appareil et vous demande d’ouvrir une page de navigateur à https://aka.ms/devicelogin. Entrez ensuite le code affiché dans votre terminal.
Si aucun navigateur web n’est disponible ou si le navigateur web ne parvient pas à s’ouvrir, vous pouvez forcer le flux de code de l’appareil avec
az login --use-device-code
.Dans le navigateur, connectez-vous avec les informations d’identification de votre compte.
Important
À compter de 2025, Microsoft applique l’authentification multifacteur obligatoire pour Azure CLI et d’autres outils en ligne de commande. L’authentification multifacteur affecte uniquement les identités utilisateur Microsoft Entra ID. Il n’aura pas d’impact sur les identités de charge de travail, telles que les principaux de service et les identités managées .
Si vous utilisez az login avec un ID Entra et un mot de passe pour authentifier un script ou un processus automatisé, prévoyez maintenant de migrer vers une identité de charge de travail. Pour plus d’informations, consultez l’impact de l’authentification multifacteur sur Azure CLI dans les scénarios d’automatisation.
Une fois connecté, une liste de vos abonnements s’affiche. Celui marqué isDefault: true
est actuellement actif. Pour passer à un autre abonnement, exécutez :
az account set --subscription "<subscription-id>"
Pour plus d’informations sur la sélection des abonnements, consultez Gérer les abonnements Azure. Pour obtenir des options de connexion avancées, consultez Se connecter avec Azure CLI.
Trouver des commandes
Les commandes Azure CLI sont organisées en tant que groupes de commandes. Chaque groupe représente une zone d’un service Azure. Il existe deux options pour rechercher des groupes de commandes :
Utilisez la commande az find . Par exemple, pour rechercher des noms de commandes contenant
vm
, utilisez l’exemple suivant :az find vm
Utilisez l’argument
--help
pour obtenir une liste complète de sous-groupes au sein d’un groupe de références. L’exemple suivant retourne tous les sous-groupes pour les machines virtuelles :az vm --help
L’exemple suivant montre la partie pertinente de la sortie.
Subgroups: application : Manage applications for VM. availability-set : Group resources into availability sets. boot-diagnostics : Troubleshoot the startup of an Azure Virtual Machine. ...
La sortie d’aide comprend des sous-groupes, des paramètres, des options d’authentification et des exemples.
Voici un autre exemple qui recherche les commandes Azure CLI pour regrouper des machines virtuelles dans des groupes à haute disponibilité, sous-groupe de
az vm
:az vm availability-set --help
Vous pouvez également utiliser
--help
pour obtenir des listes de paramètres et des exemples de commandes pour une commande de référence.az vm create --help
Voici la section pertinente de l’exemple de sortie :
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 ...
Utilisez l’index de référence qui répertorie tous les groupes de commandes par ordre alphabétique.
Explorer des exemples et des articles
Pour obtenir des exemples d’utilisation, consultez :
Index d’exemples pour les exemples Azure CLI par objet, groupe de référence ou référentiel GitHub.
Index d’article pour rechercher des repères détaillés. Utilisez vos touches de raccourci clavier
find
, par exempleCtrl + F
, pour rechercher rapidement le groupe de commandes de référence dans lequel vous êtes intéressé. Par exemple, l’index d’article pouraz vm
ressemble au tableau suivant :Sous-groupe de référence Article sur l'Azure CLI montrant comment l'utiliser comme référence az vm Formats de sortie pour les commandes Azure CLI Utilisation des variables dans les commandes Azure CLI Obtenir des informations sur les machines virtuelles avec des requêtes {Autres articles répertoriés ici.} az vm aem Nouvelle version de l’extension de machine virtuelle Azure pour les solutions SAP Version standard de l’extension de machine virtuelle Azure pour les solutions SAP az vm application {...}
Utiliser la saisie semi-automatique des onglets
Azure CLI prend en charge la complétion par tabulation dans Bash. Pour l’activer dans PowerShell, consultez Activer la complétion automatique dans PowerShell.
Comprendre les arguments globaux
Les arguments courants disponibles pour la plupart des commandes sont les suivants :
Raisonnement | Descriptif |
---|---|
--help |
Afficher l’aide de la commande |
--output |
Modifier le format de sortie : json , , jsonc tsv table ,yaml |
--query |
Filtrer la sortie à l’aide de JMESPath |
--verbose |
Imprimer plus de détails sur l’exécution |
--debug |
Afficher les appels REST de bas niveau pour le débogage |
--subscription |
Spécifier le nom ou l’ID de l’abonnement |
--only-show-errors |
Supprimer la sortie non critique |
Pour plus d’informations, consultez Formats de sortie et résultats de requête.
Utiliser le mode interactif
Exécutez le mode interactif avec :
az interactive
Le mode interactif lance une expérience Azure CLI améliorée avec l’aide inline et les suggestions de commande. Pour plus d’informations, consultez Mode interactif.
Une extension VS Code facultative fournit des fonctionnalités similaires avec la saisie semi-automatique et les conseils de pointage.
Apprenez avec les didacticiels et les guides de démarrage rapide
Familiarisez-vous avec les principes de base d’Azure CLI à l’aide du didacticiel d’intégration. Vous apprenez à :
- Gérer votre abonnement par défaut
- Créer des ressources avec des noms aléatoires
- Utiliser des variables d’environnement
- Déboguer des commandes et analyser des fichiers JSON
- Supprimer efficacement les ressources
Remarque
Les exemples Azure CLI sur Microsoft Learn sont écrits pour Bash. Les scripts en une seule ligne fonctionnent généralement avec divers interpréteurs de commandes, mais les scripts multilignes peuvent nécessiter des ajustements. Pour plus d’informations, consultez Découvrir les différences de syntaxe entre Bash, PowerShell et Cmd
Fournir des commentaires
N’hésitez pas à nous faire part de vos commentaires. Envoyez des problèmes sur GitHub ou exécutez :
az feedback