Installer l’interface de ligne de commande (CLI) Microsoft Graph

L’interface de ligne de commande (CLI) Microsoft Graph est publiée sur GitHub.

Installation

Fenêtres

1. Téléchargez le fichier .zip commençant par msgraph-cli-win-x64 à partir de la section Ressources de la page Versions de GitHub.
2. Extrayez le contenu du fichier dans un répertoire.

Configuration de l’environnement Windows (facultatif)

1. Ouvrez Paramètres.

2. Sélectionnez À propos de, puis Paramètres système avancés.

3. Sélectionnez Variables d’environnement...

4. Recherchez et sélectionnez Chemin d’accès, puis sélectionnez Modifier.

   Remarque

   La variable Path est présente dans les variables utilisateur ainsi que dans les variables système. La mise à jour de la variable dans Variables utilisateur met uniquement à jour le chemin d’accès de l’utilisateur actuel. La mise à jour de la variable dans Variables système met à jour le chemin d’accès pour tous les utilisateurs sur l’ordinateur.

5. Ajoutez le chemin d’accès complet au répertoire contenant mgc.exe.

Linux

1. Téléchargez le fichier .tar.gz à partir de msgraph-cli-linux-x64 à partir de la section Ressources de la page Versions de GitHub.
2. Extrayez le contenu du fichier dans un répertoire.

Configuration de l’environnement Linux

Pour effectuer la mise à jour PATH de votre session active, exécutez la commande suivante dans le répertoire contenant mgc.

export PATH=$PATH:$(PWD)

Vous pouvez également mettre à jour PATH définitivement en modifiant votre profil d’interpréteur de commandes (~/.bash-profile ou ~/.zsh-profile). Ajoutez la ligne suivante à votre profil.

export PATH=$PATH:[path-to-the-cli-folder]

Configurer gnome-keyring

Les étapes suivantes sont requises sur les distributions Linux qui n’ont pas d’environnement de bureau.

1. Installez gnome-keyring et libsecret avec la commande suivante.

   sudo apt-get install --assume-yes gnome-keyring libsecret-1-0
   

2. Exécutez un processus de démon gnome-keyring avec les commandes suivantes. Remplacez par secure-password un mot de passe sécurisé de votre choix.

   sudo setcap cap_ipc_lock=+ep $(which gnome-keyring-daemon)
   
   export DBUS_SESSION_BUS_ADDRESS=$(dbus-daemon --session --fork --print-address)
   
   export KEYRING_PASSWORD=secure-password
   
   dbus-run-session -- echo "$KEYRING_PASSWORD" | gnome-keyring-daemon --daemonize --components=secrets --unlock
   

   Remarque

   Les commandes précédentes doivent être exécutées chaque fois que le système redémarre.

MacOS

1. Téléchargez le fichier .tar.gz à partir de msgraph-cli-osx-x64 (pour Mac Intel) ou msgraph-cli-osx-arm (pour Mac M1 ou M2) à partir de la section Ressources de la page Versions de GitHub.
2. Extrayez le contenu du fichier dans un répertoire.

Configuration de l’environnement macOS

Pour effectuer la mise à jour PATH de votre session active, exécutez la commande suivante dans le répertoire contenant mgc.

export PATH=$PATH:$(PWD)

Vous pouvez également mettre à jour PATH définitivement en modifiant votre profil d’interpréteur de commandes (~/.bash-profile ou ~/.zsh-profile). Ajoutez la ligne suivante à votre profil.

export PATH=$PATH:[path-to-the-cli-folder]

Vérifier l’installation

Une fois l’installation terminée, vous pouvez vérifier la version installée avec la commande suivante.

mgc --version

La version de la sortie doit correspondre à la dernière version publiée sur TBD. Vous êtes maintenant prêt à utiliser le Kit de développement logiciel (SDK).

Mise à jour de l’interface CLI

Pour mettre à jour l’interface CLI, téléchargez une version plus récente et extrayez-la dans le répertoire contenant l’ancienne version.

Désinstallation de l’interface CLI

Supprimez les fichiers de leur emplacement.

Étapes suivantes

Pour savoir comment effectuer des tâches de base avec l’interface CLI Microsoft Graph, consultez Prise en main de l’interface de ligne de commande (CLI) Microsoft Graph.