Prise en main d’Azure CLIGet started with Azure CLI

Bienvenue dans Azure CLI !Welcome to the Azure CLI! L’interface CLI est un outil conçu pour vous aider à utiliser rapidement et efficacement les services Azure, en mettant l’accent sur l’automatisation.The CLI is a tool designed to get you working quickly and efficiently with Azure services, with an emphasis on automation. Cet article présente les fonctionnalités de l’interface CLI et des liens vers des ressources qui vous aideront à être productif.This article introduces features of the CLI and links out to resources that help you be productive.

Installer ou exécuter dans Azure Cloud ShellInstall or run in Azure Cloud Shell

Pour commencer avec l’interface CLI, le plus simple est de l’exécuter dans un environnement Azure Cloud Shell via votre navigateur.The easiest way to get started with the Azure CLI is by running it in an Azure Cloud Shell environment through your browser. Pour en savoir plus sur Cloud Shell, consultez Démarrage rapide de Bash dans Azure Cloud Shell.To learn about Cloud Shell, see Quickstart for Bash in Azure Cloud Shell.

Lorsque vous êtes prêt à installer l’interface CLI, consultez les instructions d’installation.When you're ready to install the CLI, see the installation instructions.

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.After installing the CLI for the first time, check that it's installed and you've got the correct version by running az --version.

Se connecterSign in

Avant d’utiliser les commandes CLI avec une installation locale, vous devez vous connecter avec la commande az login.Before using any CLI commands with a local install, you need to sign in with az login.

  1. Exécutez la commande login.Run the login command.

    az login
    

    Si l’interface CLI peut ouvrir votre navigateur par défaut, elle le fera et chargera une page de connexion par la même occasion.If the CLI can open your default browser, it will do so and load a sign-in page.

    Sinon, vous devez ouvrir une page de navigateur et suivre les instructions sur la ligne de commande pour entrer un code d’autorisation après avoir accédé à https://aka.ms/devicelogin dans votre navigateur.Otherwise, you need to open a browser page and follow the instructions on the command line to enter an authorization code after navigating to https://aka.ms/devicelogin in your browser.

  2. Dans le navigateur, connectez-vous avec les informations d’identification de votre compte.Sign in with your account credentials in the browser.

Après vous être connecté, vous voyez une liste des abonnements associés à votre compte Azure.After logging in, you see a list of subscriptions associated with your Azure account. Les informations d’abonnement avec isDefault: true correspond à l’abonnement actuellement activé après vous être connecté.The subscription information with isDefault: true is the currently activated subscription after logging in. Pour sélectionner un autre abonnement, utilisez la commande az account set avec l’ID d’abonnement auquel vous voulez passer.To select another subscription, use the az account set command with the subscription ID to switch to. Pour plus d’informations sur la sélection d’abonnements, consultez Utiliser plusieurs abonnements Azure.For more information about subscription selection, see Use multiple Azure subscriptions.

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.There are ways to sign in non-interactively, which are covered in detail in Sign in with Azure CLI.

Commandes courantesCommon commands

Ce tableau répertorie certaines commandes courantes utilisées dans l’interface CLI ainsi que des liens vers leur documentation de référence.This table lists some common commands used in the CLI and links to their reference documentation.

Type de ressourceResource type Groupe de commandes Azure CLIAzure CLI command group
Groupe de ressourcesResource group az groupaz group
Machines virtuellesVirtual machines az vmaz vm
Comptes de stockageStorage accounts az storage accountaz storage account
Key VaultKey Vault az keyvaultaz keyvault
Applications webWeb applications az webappaz webapp
Bases de données SQLSQL databases az sql serveraz sql server
CosmosDBCosmosDB az cosmosdbaz cosmosdb

Recherche de commandesFinding commands

Les commandes dans l’interface CLI sont classées par commandes de groupes.Commands in the CLI are organized as commands of groups. Chaque groupe représente un service Azure, et les commandes agissent sur ce service.Each group represents an Azure service, and commands operate on that service.

Pour rechercher des commandes, utilisez la commande az find.To search for commands, use az find. Par exemple, pour rechercher des noms de commandes contenant secret, utilisez la commande suivante :For example, to search for command names containing secret, use the following command:

az find secret

Utilisez l’argument --help pour obtenir une liste complète des commandes et des sous-groupes d’un groupe.Use the --help argument to get a complete list of commands and subgroups of a group. Par exemple, pour trouver les commandes CLI pour fonctionner avec des groupes de sécurité réseau (NSG) :For example, to find the CLI commands for working with Network Security Groups (NSGs):

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.The CLI has full tab completion for commands under the bash shell.

Arguments globalement disponiblesGlobally available arguments

Certains arguments sont disponibles pour chaque commande.There are some arguments that are available for every command.

  • --help imprime les informations de référence CLI sur les commandes et leurs arguments, et répertorie les commandes et sous-groupes disponibles.--help prints CLI reference information about commands and their arguments and lists available subgroups and commands.
  • --output modifie le format de sortie.--output changes the output format. Les formats de sortie disponibles sont json, jsonc (JSON coloré), tsv (valeurs séparées par des tabulations), table (tables ASCII lisibles) et yaml.The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. Par défaut, l’interface CLI génère json.By default the CLI outputs json. Pour en savoir plus sur les formats de sortie disponibles, consultez Formats de sortie pour Azure CLI.To learn more about the available output formats, see Output formats for Azure CLI.
  • --query utilise le langage de requête JMESPath pour filtrer la sortie retournée à partir des services Azure.--query uses the JMESPath query language to filter the output returned from Azure services. Pour en savoir plus sur les requêtes, consultez Interroger des résultats de commande avec Azure CLI et le tutoriel JMESPath.To learn more about queries, see Query command results with Azure CLI and the JMESPath tutorial.
  • --verbose imprime les informations sur les ressources créées dans Azure pendant une opération, et d’autres informations utiles.--verbose prints information about resources created in Azure during an operation, and other useful information.
  • --debug imprime davantage d’informations sur les opérations CLI, utilisées pour le débogage.--debug prints even more information about CLI operations, used for debugging purposes. 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.If you find a bug, provide output generated with the --debug flag on when submitting a bug report.

Mode interactifInteractive mode

L’interface CLI propose un mode interactif qui affiche automatiquement les informations d’aide et qui facilite la sélection de sous-commandes.The CLI offers an interactive mode that automatically displays help information and makes it easier to select subcommands. Vous pouvez entrer en mode interactif avec la commande az interactive.You enter interactive mode with the az interactive command.

az interactive

Pour plus d’informations sur le mode interactif, consultez Mode interactif Azure CLI.For more information on interactive mode, see Azure CLI Interactive Mode.

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.There's also a Visual Studio Code plugin that offers an interactive experience, including autocomplete and mouse-over documentation.

Apprendre les concepts de base CLI à l’aide des démarrages rapides et des didacticielsLearn CLI basics with quickstarts and tutorials

Pour vous aider à prendre en main Azure CLI, lancez-vous dans un didacticiel approfondi de configuration des machines virtuelles, et utilisez la puissance de l’interface de ligne de commande pour interroger des ressources Azure.To get you started with the Azure CLI, try an in-depth tutorial for setting up virtual machines and using the power of the CLI to query Azure resources.

Il existe également des guides de démarrage rapide pour les autres services populaires.There are also quickstarts for other popular services.

Envoyer des commentairesGive feedback

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.We welcome your feedback for the CLI to help us make improvements and resolve bugs. 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.You can file an issue on GitHub or use the built-in features of the CLI to leave general feedback with the az feedback command.

az feedback