Partager via


Prise en main d’Azure CLI

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 :

  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 le navigateur web ne parvient pas à s’ouvrir, vous pouvez forcer le flux de code de l’appareil avec az login --use-device-code.

  2. 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 :

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, , jsonctsvtable,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 à :

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

Voir aussi