Prise en main d’Azure CLI

Bienvenue dans l’interface de ligne de commande (CLI) Azure ! Cet article présente l’interface CLI et vous permet d’effectuer des tâches courantes.

Notes

Dans les scripts et sur le site de documentation de Microsoft, les exemples Azure CLI sont écrits pour l’interpréteur de commandes bash. Les exemples d’une ligne seront exécutés sur n’importe quelle plateforme. Les exemples plus longs qui se répartissent sur plusieurs lignes (\) ou incluent l’attribution de variables doivent être modifiés pour fonctionner sur d’autres interpréteurs de commandes, y compris PowerShell.

Installer ou exécuter dans Azure Cloud Shell

Le moyen le plus simple d’apprendre à utiliser l’interface Azure CLI est de l’exécuter dans un environnement Azure Cloud Shell via votre navigateur. Pour découvrir Cloud Shell, consultez Démarrage rapide de Bash dans Azure Cloud Shell.

Lorsque vous êtes prêt à installer l’interface CLI, consultez les instructions d’installation.

Après avoir installé l’interface CLI pour la première fois, vérifiez qu’elle est bien installée et que vous disposez de la version appropriée en exécutant az --version.

Notes

Si vous utilisez le modèle de déploiement Azure CLI Classic, installez l’interface de ligne de commande Azure CLI Classic.

Comment se connecter à l’interface Azure CLI

Avant d’utiliser les commandes Azure CLI avec une installation locale, vous devez vous connecter avec la commande az login.

  1. 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 l’ouverture du navigateur web échoue, vous devrez peut-être forcer le flux de code d’appareil avec la commande az login --use-device-code.

  2. Dans le navigateur, connectez-vous avec les informations d’identification de votre compte.

Après vous être connecté, vous voyez une liste des abonnements associés à votre compte Azure. Les informations d’abonnement avec isDefault: true correspond à l’abonnement actuellement activé après vous être connecté. Pour sélectionner un autre abonnement, utilisez la commande az account set avec l’ID d’abonnement auquel vous voulez passer. Pour plus d’informations sur la sélection d’abonnements, consultez Utiliser plusieurs abonnements Azure.

Il existe des méthodes pour se connecter de manière non interactive, qui sont dévelopées en détail dans Se connecter avec Azure CLI.

Commandes Azure CLI courantes

Ce tableau répertorie certaines commandes courantes utilisées dans l’interface CLI ainsi que des liens vers leur documentation de référence.

Type de ressource Groupe de commandes Azure CLI
Groupe de ressources az group
Machines virtuelles az vm
Comptes de stockage az storage account
Key Vault az keyvault
Applications web az webapp
Bases de données SQL az sql server
CosmosDB az cosmosdb

Recherche de commandes

Les commandes Azure CLI sont organisées comme des commandes de groupes. Chaque groupe représente un service Azure, et les commandes agissent sur ce service.

Pour rechercher des commandes, utilisez la commande az find. Par exemple, pour rechercher des noms de commandes contenant secret, utilisez la commande suivante :

az find secret

Utilisez l’argument --help pour obtenir une liste complète des commandes et des sous-groupes d’un groupe. Par exemple, pour trouver les commandes CLI pour fonctionner avec des groupes de sécurité réseau (NSG) :

az network nsg --help

L’interface CLI dispose de la saisie semi-automatique via la touche Tab pour les commandes de l’interpréteur de commandes bash.

Arguments globalement disponibles

Certains arguments sont disponibles pour chaque commande.

  • --help imprime les informations de référence CLI sur les commandes et leurs arguments, et répertorie les commandes et sous-groupes disponibles.
  • --output modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON coloré), tsv (valeurs séparées par des tabulations), table (tables ASCII lisibles) et yaml. Par défaut, l’interface CLI génère json. Pour en savoir plus sur les formats de sortie disponibles, consultez Formats de sortie pour Azure CLI.
  • --query utilise le langage de requête JMESPath pour filtrer la sortie retournée à partir des services Azure. Pour en savoir plus sur les requêtes, consultez Interroger des résultats de commande avec Azure CLI et le tutoriel JMESPath.
  • --verbose imprime les informations sur les ressources créées dans Azure pendant une opération, et d’autres informations utiles.
  • --debug imprime davantage d’informations sur les opérations CLI, utilisées pour le débogage. Si vous rencontrez un bogue, fournissez la sortie générée avec l’indicateur --debug lors de l’envoi d’un rapport de bogue.

Mode interactif

L’interface CLI propose un mode interactif qui affiche automatiquement les informations d’aide et qui facilite la sélection de sous-commandes. Vous pouvez entrer en mode interactif avec la commande az interactive.

az interactive

Pour plus d’informations sur le mode interactif, consultez Mode interactif Azure CLI.

Il existe également un plug-in Visual Studio Code qui propose une expérience interactive, comprenant l’autocomplétion et le survol de la documentation.

Apprendre les concepts de base CLI à l’aide des démarrages rapides et des didacticiels

Pour savoir comment utiliser Azure CLI, essayez notre tutoriel d’intégration, qui vous apprendra les compétences suivantes lors de l’utilisation de Stockage Azure :

Il existe également des guides de démarrage rapide pour les services les plus courants.

Envoyer des commentaires

N’hésitez pas à nous faire part de vos commentaires au sujet de l’interface CLI pour nous aider à l’améliorer et à résoudre les bogues. Vous pouvez signaler un problème sur GitHub ou utiliser les fonctionnalités intégrées de l’interface CLI pour laisser des commentaires d’ordre général à l’aide de la commande az feedback.

az feedback

Voir aussi