Prise en main d’Azure CLI

Article
03/11/2024

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.

Installer ou exécuter dans Azure Cloud Shell

Le moyen le plus simple d’apprendre à utiliser Azure CLI consiste à exécuter un environnement Bash dans 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 Azure CLI, consultez les instructions d’installation pour le conteneur Windows, Linux, macOS et Docker. Si vous utilisez le modèle de déploiement Azure CLI Classic, installez l’interface de ligne de commande Azure CLI Classic.

Vérifiez votre version en exécutant az --version. Azure Cloud Shell dispose toujours de la dernière version d’Azure CLI préinstallée.

az version

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.

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.
Dans le navigateur, connectez-vous avec les informations d’identification de votre compte.

Après vous être connecté, vous recevez une liste d’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 du compte souhaité. Pour plus d’informations sur la sélection des abonnements, consultez Gérer les 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.

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 la commande suivante :
```
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. Cet exemple retourne tous les sous-groupes pour les machines virtuelles :

az vm --help

Voici un exemple de sortie avec des lignes omises pour la concision :

Subgroups:
  application            : Manage applications for VM.
  availability-set       : Group resources into availability sets.
  boot-diagnostics       : Troubleshoot the startup of an Azure Virtual Machine.
  ...

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

Utilisez --help également pour obtenir des listes de paramètres et des exemples de commandes pour une commande de référence.

az vm create --help

Voici un exemple de sortie avec des lignes omises pour la concision :

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 A to Z qui répertorie tous les groupes de commandes par ordre alphabétique.

Rechercher des exemples et des articles publiés

Si vous préférez apprendre la syntaxe Azure CLI en voyant des exemples publiés testés, il existe deux index de contenu d’article :

Exemples index A à Z. L’index d’exemples fournit une liste d’exemples Azure CLI triés par zone d’objet, groupe de références et référentiel GitHub.

Index d’article A à Z. Utilisez vos touches de raccourci clavier find , par exemple Ctrl + F, pour accéder rapidement au groupe de commandes de référence dans lequel vous êtes intéressé. Par exemple, l’index de l’article ressemble à ceci :az vm

Sous-groupe de référence	Article Azure CLI montrant l’utilisation de 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

L’interface CLI dispose d’une saisie semi-automatique de tabulation complète pour les commandes dans un environnement Bash. Pour activer la saisie semi-automatique des onglets dans un environnement PowerShell, consultez Activer la saisie semi-automatique de tabulation dans PowerShell.

Tenez compte des arguments disponibles à l’échelle mondiale

Il existe certains arguments disponibles pour la plupart des commandes.

--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.
--subscription est le nom ou l’ID d’un abonnement. Pour plus d’informations sur la définition de votre abonnement par défaut, consultez Gérer les abonnements Azure avec Azure CLI.
--only-show-errors supprime les avertissements dans la sortie de commande et affiche uniquement les erreurs.

Utiliser le 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 Exécuter Azure CLI en mode interactif.

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.

Découvrir les principes de base d’Azure CLI avec des guides de démarrage rapide et des didacticiels

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

Recherchez et modifiez votre abonnement par défaut.
Créez une ressource Azure contenant un ID aléatoire dans le nom.
Définissez des variables d’environnement.
Découvrez les différences de syntaxe entre Bash, PowerShell et Cmd.
Déboguer des commandes de référence Azure CLI.
Obtenir des propriétés à partir d’un fichier JSON local.. Cet exemple montre comment obtenir des valeurs de configuration pour le développement, l’étape et la production.
Supprimez plusieurs ressources à l’aide d’un script.

Remarque

Dans les scripts et sur le site de documentation Microsoft, les exemples Azure CLI sont écrits pour l’interpréteur de commandes Bash. La plupart des exemples en une seule ligne s’exécutent sur n’importe quelle plateforme. Des exemples plus longs incluant des continuations de ligne (\), une affectation de variable ou des guillemets doivent être modifiés pour fonctionner dans d’autres interpréteurs de commandes, y compris PowerShell. Pour plus d’informations sur les différences de syntaxe entre les environnements, consultez Découvrir les différences de syntaxe entre Bash, PowerShell et Cmd.

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