Partager via


Étendre des scripts PowerShell qui utilisent l’authentification d’application uniquement avec d’autres API Microsoft Graph

Dans cet article, vous allez ajouter vos propres fonctionnalités Microsoft Graph à l’application que vous avez créée dans Générer des scripts PowerShell avec Microsoft Graph. Par exemple, vous pouvez ajouter un extrait de code à partir de la documentation Microsoft Graph ou de l’Explorer Graph, ou du code que vous avez créé.

Choisir une API

Recherchez une API dans Microsoft Graph que vous souhaitez essayer. Par exemple, l’API Répertorier les groupes . Vous pouvez utiliser l’un des exemples de la documentation de l’API, personnaliser une demande d’API dans Graph Explorer et utiliser l’extrait de code généré, ou utiliser la Find-MgGraphCommand commande pour rechercher la commande correspondante.

Par exemple, le point de terminaison d’API pour répertorier les groupes est GET /groups. Vous pouvez utiliser ces informations pour rechercher la commande PowerShell correspondante.

PS > Find-MgGraphCommand -Uri "/groups" -Method "GET"

   APIVersion: v1.0

Command     Module Method URI     OutputType           Permissions
-------     ------ ------ ---     ----------           -----------
Get-MgGroup Groups GET    /groups IMicrosoftGraphGroup {Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, G…

   APIVersion: beta

Command     Module Method URI     OutputType            Permissions
-------     ------ ------ ---     ----------            -----------
Get-MgGroup Groups GET    /groups IMicrosoftGraphGroup1 {Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, …

La sortie indique que la Get-MgGroup commande est la commande correspondante.

Configuration des autorisations

Consultez la section Autorisations de la documentation de référence de l’API choisie pour voir quelles méthodes d’authentification sont prises en charge. Certaines API ne prennent pas en charge les applications uniquement, par exemple.

Pour appeler une API avec une authentification d’application uniquement (si l’API la prend en charge), ajoutez l’étendue d’autorisation requise dans le centre d’administration Microsoft Entra. Veillez à vous déconnecter et à vous reconnecter à l’aide de l’autorisation d’application uniquement.

Conseil

L’utilisation du -ForceRefresh paramètre avec la Connect-MgGraph commande garantit que les autorisations nouvellement configurées sont appliquées.

Exécuter la commande

Maintenant que vous êtes connecté avec les autorisations requises, exécutez la commande que vous avez choisie.

Maintenant que vous disposez d’une application opérationnelle qui appelle Microsoft Graph, vous pouvez expérimenter et ajouter de nouvelles fonctionnalités.