Dans ce guide, je vais vous montrer comment installer le module Microsoft Graph PowerShell. Le module Graph PS fournit un moyen de gérer et d’automatiser les tâches sur les services Microsoft 365, notamment Entra ID, Exchange Online, Outlook, SharePoint, Teams, etc.
Le SDK Microsoft Graph PowerShell se décline essentiellement en deux modules : Microsoft.Graph et Microsoft.Graph.Beta. Les modules interagissent respectivement avec les points de terminaison Microsoft Graph v1.0 et Microsoft Graph bêta et peuvent être installés ensemble sur la même version de PowerShell.
Installer et mettre à jour des applications tierces avec Patch My PC
Principales fonctionnalités et avantages du SDK Microsoft Graph PowerShell
L’utilisation du SDK Microsoft Graph PowerShell offre les fonctionnalités et avantages suivants pour votre organisation.
-
Accès unifié aux services Microsoft 365 : le module Microsoft Graph PowerShell se connecte à l’API Microsoft Graph, donnant accès aux données et aux ressources des services Microsoft 365 tels que Microsoft Entra, Intune, etc.
-
Automatisation : à l’aide des applets de commande Graph SDK, vous pouvez automatiser les tâches administratives telles que la gestion des utilisateurs, la création de groupes, l’attribution de licences, etc.
-
Prend en charge les identités externes : les utilisateurs des locataires Microsoft Entra externes peuvent utiliser le SDK Microsoft Graph PowerShell pour s’authentifier auprès des services de votre locataire.
-
Prise en charge multiplateforme : Microsoft Graph PowerShell fonctionne sur toutes les plateformes, y compris Windows, macOS et Linux.
-
Nécessite le moins de privilèges : les autorisations Microsoft Graph PowerShell ne sont pas préautorisées, ce qui oblige les utilisateurs à soumettre une demande unique d’autorisations d’application en fonction de leurs besoins spécifiques.
-
Authentification sécurisée : prend en charge les méthodes d’authentification telles que la connexion interactive, l’authentification basée sur un certificat et l’identité managée (pour les ressources Azure).
-
Reçoit des mises à jour régulières : Microsoft met fréquemment à jour les commandes Graph PowerShell pour s’aligner sur les dernières améliorations et fonctionnalités de l’API Graph.
Consultez la liste complète des fonctionnalités et avantages de Microsoft Graph PowerShell.
Prérequis
Les conditions préalables suivantes sont requises pour utiliser le SDK Microsoft Graph PowerShell avec Windows PowerShell.
-
Assurez-vous d’avoir installé PowerShell 5.1 ou version ultérieure. PowerShell 7 et versions ultérieures sont la version PowerShell recommandée pour une utilisation avec le SDK Microsoft Graph PowerShell sur toutes les plateformes.
-
Vous devez avoir installé.NET Framework 4.7.2 ou version ultérieure.
-
Vous devez mettre à jour PowerShellGet vers la dernière version à l’aide de l’applet de commande Install-Module PowerShellGet.
-
La stratégie d’exécution du script PowerShell doit être définie sur signé à distance ou moins restrictive.
Étapes pour installer le module Microsoft Graph PowerShell
Je vais maintenant vous guider à travers les étapes d’installation du module Microsoft Graph PowerShell, en suivant les instructions officielles de Microsoft pour garantir une installation fluide et sans erreur.
Étape 1 : définissez la stratégie d’exécution PS sur RemoteSigned
Pour installer le module Microsoft Graph PowerShell, assurez-vous que la stratégie d’exécution PowerShell est définie sur RemoteSigned. Pour ce faire, ouvrez PowerShell en tant qu’administrateur et exécutez la commande ci-dessous pour modifier la stratégie d’exécution PS de Restricted à RemoteSigned sur l’appareil actuel.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Copie
Set-ExecutionPolicy
-
ExecutionPolicy RemoteSigned
-
Scope CurrentUser
Définir la stratégie d’exécution PowerShell sur Signé à distance
Étape 2 : Installer le module Microsoft PowerShellGet
Ouvrez PowerShell en tant qu’administrateur et exécutez la commande ci-dessous pour installer la dernière version de PowerShellGet.
Install-Module PowerShellGet -Force -AllowClobber
Copie
Install-Module
PowerShellGet
-
Force
-
AllowClobber
Exécutez la commande suivante pour vérifier la version installée du module PowerShellGet.
Get-Module PowerShellGet -ListAvailable
Copie
Get-Module
PowerShellGet
-
ListAvailable
Installer le module Microsoft PowerShellGet
Étape 3 : Installer le module Microsoft Graph PowerShell
L’applet de commande Install-Module est la méthode d’installation préférée pour les modules MS Graph PowerShell. Ouvrez PowerShell en tant qu’administrateur et exécutez les commandes ci-dessous pour installer le module Microsoft Graph PowerShell.
Exécutez la commande ci-dessous pour installer le module v1 du SDK dans PowerShell Core ou Windows PowerShell.
Install-Module Microsoft.Graph -Scope CurrentUser -Repository PSGallery -Force
Copie
Install-Module
Microsoft.Graph
-
Scope CurrentUser
-
Repository PSGallery
-
Force
Exécutez la commande ci-dessous pour installer le module Microsoft.Graph v1 pour la portée Tous les utilisateurs.
Install-Module Microsoft.Graph -Scope AllUsers -Repository PSGallery -Force
Copie
Install-Module
Microsoft.Graph
-
Scope AllUsers
-
Repository PSGallery
-
Force
Installer le module Microsoft Graph PowerShell
Étape 4 : Vérifier l’installation du module Graph PowerShell
Une fois l’installation terminée, vous pouvez vérifier la version installée de Graph PowerShell avec la commande suivante.
Get-InstalledModule Microsoft.Graph
Copie
Get-InstalledModule
Microsoft.Graph
Dans l’image ci-dessous, nous voyons que la version installée du module Microsoft.Graph est la 2.31.0. La version affichée doit correspondre à la dernière version publiée sur PowerShell Gallery.
Vérifier l’installation du module PowerShell graphique
Connectez-vous à Microsoft Graph PowerShell
Je vais maintenant vous montrer comment utiliser Connect-MgGraph qui est une applet de commande PowerShell dans le SDK Microsoft Graph PowerShell utilisée pour établir une session authentifiée avec Microsoft Graph.
Microsoft Graph PowerShell prend en charge deux types d’authentifications : l’accès délégué et l’accès aux applications uniquement. Diverses applets de commande sont disponibles pour gérer les paramètres essentiels nécessaires à l’authentification, tels que l’environnement, l’ID d’application et le certificat.
Ci-dessous, j’ai montré le moyen simple de se connecter à Graph PowerShell tandis qu’une explication détaillée des autres méthodes de connexion sera abordée dans un article séparé.
Exécutez la commande ci-dessous pour vous connecter à Microsoft Graph à l’aide de l’authentification interactive, où vous spécifiez les autorisations (étendues) nécessaires pour votre session.
Connect-MgGraph -Scopes "User.Read.All", "Group.ReadWrite.All"
Copie
Connect-MgGraph
-
Scopes
"User.Read.All"
,
"Group.ReadWrite.All"
Après avoir exécuté la commande ci-dessus, vous devez vous connecter avec vos informations d’identification et terminer l’authentification.
Connectez-vous à Microsoft Graph PowerShell
Après une authentification réussie, les outils de ligne de commande Microsoft Graph vous inviteront à accorder votre consentement au nom de votre organisation. Examinez attentivement les autorisations d’application requises et cliquez sur « Accepter ».
Connectez-vous à Microsoft Graph PowerShell
Installation du module bêta de Microsoft.Graph PowerShell
Il s’agit d’une étape facultative. Pour installer le module bêta de Microsoft.Graph PS, exécutez la commande suivante.
Install-Module Microsoft.Graph.Beta -Repository PSGallery -Force
Copie
Install-Module
Microsoft.Graph.Beta
-
Repository PSGallery
-
Force
Vous pouvez mettre à jour le SDK Microsoft Graph PowerShell et toutes ses dépendances à l’aide de la commande suivante.
Update-Module Microsoft.Graph
Copie
Update-Module
Microsoft.Graph
Si vous exécutez déjà la dernière version du SDK Microsoft Graph PowerShell, la commande s’exécutera et ne renverra aucune sortie indiquant qu’aucune mise à jour n’est nécessaire.
Mettre à jour les modules du SDK Microsoft Graph PowerShell
Déconnecter Microsoft Graph
Après avoir terminé vos tâches avec Microsoft Graph, assurez-vous de vous déconnecter à l’aide de l’applet de commande Disconnect-MgGraph.
Exécutez la commande PowerShell ci-dessous pour vous déconnecter et déconnecter complètement Microsoft Graph.
Disconnect-MgGraph
Copie
Disconnect-MgGraph
Désinstaller le SDK Microsoft Graph PowerShell
Si vous souhaitez supprimer toutes les versions installées du SDK Microsoft Graph PowerShell, exécutez la commande ci-dessous dans PowerShell.
Uninstall-Module Microsoft.Graph -AllVersions
Copie
Uninstall-Module
Microsoft.Graph
-
AllVersions
Ensuite, pour supprimer tous les modules de dépendance Microsoft.Graph, exécutez les commandes suivantes.
Get-InstalledModule Microsoft.Graph.* | ? Name -ne "Microsoft.Graph.Authentication" | Uninstall-Module -AllVersionsUninstall-Module Microsoft.Graph.Authentication -AllVersions
Copie
Get-InstalledModule
Microsoft.Graph.
*
|
?
Name
-ne
"Microsoft.Graph.Authentication"
|
Uninstall-Module
-
AllVersions
Uninstall-Module
Microsoft.Graph.Authentication
-
AllVersions
Conclusion
J’espère qu’avec ce guide, je vous ai facilité l’installation du module Microsoft Graph PowerShell. Le module Microsoft Graph PowerShell est un wrapper d’API pour l’API Microsoft Graph et constitue un outil puissant pour gérer les services Microsoft 365. Que vous automatisiez des tâches administratives, gériez des utilisateurs et des groupes ou récupériez des rapports, ce module offre un moyen pratique et efficace d’interagir avec l’API Microsoft Graph à l’aide de PowerShell.
Si vous avez des questions, veuillez me le faire savoir dans la section commentaires ci-dessous.
Vous avez encore besoin d’aide ?
Si vous avez besoin d’aide supplémentaire sur l’article ci-dessus ou si vous souhaitez discuter d’autres problèmes techniques, consultez certaines de ces options.
Forums
Télégramme
Contactez-moi
*️⃣ Lien source :
SDK Microsoft Graph PowerShell , comment installer le module Exchange PowerShell en ligne, ,
Fonctionnalités et avantages de Microsoft Graph PowerShell ,
PowerShell 5.1 ou version ultérieure ,
.NET Framework 4.7.2 ou version ultérieure , Politique d’exécution des scripts PowerShell,
Instructions officielles de Microsoft ,
PowerShell Gallery ,
Connect-MgGraph ,
Forums
, Télégramme ,
Contactez-moi
,