Partager via


Étendre des scripts PowerShell avec des API Microsoft Graph supplémentaires

Dans cet article, vous allez ajouter vos propres fonctionnalités Microsoft Graph à l’application que vous avez créée dans Créer 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 Créer un événement . 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, l’un des points de terminaison d’API pour créer un événement est POST /users/{id | userPrincipalName}/events. Vous pouvez l’utiliser pour rechercher la commande PowerShell correspondante.

PS > Find-MgGraphCommand -Uri "/users/{id | userPrincipalName}/events" -Method "POST"

   APIVersion: v1.0

Command         Module   Method URI                     OutputType           Permissions           Variants
-------         ------   ------ ---                     ----------           -----------           --------
New-MgUserEvent Calendar POST   /users/{user-id}/events IMicrosoftGraphEvent {Calendars.ReadWrite} {Create1, CreateExp…

   APIVersion: beta

Command         Module   Method URI                     OutputType            Permissions           Variants
-------         ------   ------ ---                     ----------            -----------           --------
New-MgUserEvent Calendar POST   /users/{user-id}/events IMicrosoftGraphEvent1 {Calendars.ReadWrite} {Create, CreateExp…

La sortie indique que la New-MgUserEvent 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 l’authentification utilisateur (déléguée) ou les comptes Microsoft personnels, par exemple.

Déconnectez la session active (Disconnect-MgGraph) et reconnectez-vous avec l’autorisation requise dans le -Scopes paramètre .

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.