Remarque
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.
L’interface de Azure Command-Line (CLI) est un outil en ligne de commande multiplateforme permettant de se connecter à Azure et d’exécuter des commandes d’administration sur des ressources Azure. Il permet d'exécuter des commandes via un terminal en utilisant des commandes interactives ou un script.
Pour une utilisation interactive, vous lancez d’abord un interpréteur de commandes tel que cmd.exe sur Windows ou Bash sur Linux ou macOS, puis émettez une commande à l’invite de l’interpréteur de commandes. Pour automatiser des tâches répétitives, assemblez les commandes CLI dans un script d’interpréteur de commandes en respectant la syntaxe de l’interpréteur choisi, puis exécutez le script.
Vous pouvez installer le Azure CLI localement sur des ordinateurs Linux, macOS ou Windows. Il peut également être utilisé à partir d’un navigateur via le Azure Cloud Shell ou s’exécuter à partir d’un conteneur Docker.
Version actuelle
La version actuelle du Azure CLI est 2.84.0. Pour plus d’informations sur la version la plus récente, consultez les Notes de publication. Pour connaître la version que vous avez installée et savoir si elle nécessite d’être mise à jour, exécutez az version.
Authentification
Azure CLI prend en charge plusieurs méthodes d’authentification. Pour plus d’informations sur l’authentification auprès de Azure à partir du Azure CLI, consultez Sign in with Azure CLI.
Conception de référence des commandes
La syntaxe Azure CLI suit un modèle simple reference name - command - parameter - parameter value pattern. Par exemple, le basculement d’un abonnement à un autre est souvent une tâche courante. Voici la syntaxe.
az account set --subscription "my subscription name"
Une autre utilisation courante de l’Azure CLI gère les attributions de rôles.
az role assignment create --assignee servicePrincipalName --role Reader --scope /subscriptions/mySubscriptionID/resourceGroups/myResourceGroupName
az role assignment delete --assignee userSign-inName --role Contributor
Pour plus d’informations sur la gestion des abonnements, consultez Gérer les abonnements avec Azure CLI. Consultez Créer un principal de service Azure avec le Azure CLI pour obtenir un didacticiel détaillé sur la gestion des principaux de service et des attributions de rôles.
Comparaison de la syntaxe PowerShell
Choose l’outil en ligne de commande approprié explique la différence entre tools et environments en mettant l’accent sur les Azure CLI et les Azure PowerShell. Elle fournit également de nombreuses comparaisons de commandes côte à côte. Voici deux exemples :
| Commande | Azure CLI | Azure PowerShell |
|---|---|---|
| Créer un groupe de ressources | az group create --name <ResourceGroupName> --location est des États-Unis | New-AzResourceGroup -Nom <ResourceGroupName> -Emplacement eastus |
| Créer un compte Azure Storage | Pour créer un compte de stockage Azure, utilisez la commande suivante : ``` az storage account create --name <StorageAccountName> --resource-group <ResourceGroupName> --location eastus --sku Standard_LRS --kind StorageV2 ``` Remplacez `<StorageAccountName>` par le nom souhaité pour votre compte de stockage et `<ResourceGroupName>` par le nom de votre groupe de ressources. | New-AzStorageAccount -Name <StorageAccountName> -ResourceGroupName <ResourceGroupName> -Emplacement eastus -SkuName Standard_LRS -Type StorageV2 |
Pour les comparaisons de syntaxe de l'Azure CLI entre les environnements Bash et PowerShell, consultez Découvrez les différences de syntaxe d'Azure CLI dans Bash, PowerShell et Cmd.
Formats de sortie
Le Azure CLI utilise JSON comme format de sortie par défaut, mais propose d’autres formats, comme décrit dans FormatsOutput pour les commandes Azure CLI. Utilisez le paramètre --output pour mettre en forme les résultats des commandes Azure CLI. Voici un exemple :
az account list --output table
Définissez votre sortie par défaut en définissant la propriété de configuration output comme décrit dans Azure CLI configuration.
az config set core.output=jsonc
Collecte de données
Azure CLI collecte les données de télémétrie par défaut. Microsoft agrège les données collectées pour identifier les modèles d’utilisation afin d’identifier les problèmes courants et d’améliorer l’expérience de Azure CLI. Microsoft Azure CLI ne collecte aucune donnée privée ou personnelle. Par exemple, les données d’utilisation permettent d’identifier des problèmes, tels que des commandes dont le niveau de réussite est faible, et nous aident à définir les priorités dans notre travail.
Bien que nous appréciions les insights que ces données fournissent, nous comprenons également que tout le monde ne veut pas envoyer des données d’utilisation. Vous pouvez désactiver la collecte de données à l’aide de la commande az config set core.collect_telemetry=false. Vous pouvez également lire notre déclaration de confidentialité pour en savoir plus à ce sujet.