Erweitern von PowerShell-Skripts mit zusätzlichen Microsoft Graph-APIs

In diesem Artikel fügen Sie der Anwendung, die Sie unter Erstellen von PowerShell-Skripts mit Microsoft Graph erstellt haben, Ihre eigenen Microsoft Graph-Funktionen hinzu. Sie können z. B. einen Codeausschnitt aus der Microsoft Graph-Dokumentation oder graph Explorer oder code hinzufügen, den Sie erstellt haben.

Auswählen einer API

Suchen Sie eine API in Microsoft Graph, die Sie ausprobieren möchten. Beispiel: Die Api zum Erstellen eines Ereignisses . Sie können eines der Beispiele in der API-Dokumentation verwenden, eine API-Anforderung in Graph Explorer anpassen und den generierten Codeausschnitt verwenden oder den Find-MgGraphCommand Befehl verwenden, um den entsprechenden Befehl zu suchen.

Einer der API-Endpunkte zum Erstellen eines Ereignisses ist POST /users/{id | userPrincipalName}/eventsbeispielsweise . Sie können dies verwenden, um den entsprechenden PowerShell-Befehl zu suchen.

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…

Die Ausgabe gibt an, dass der New-MgUserEvent Befehl der entsprechende Befehl ist.

Konfigurieren von Berechtigungen

Überprüfen Sie den Abschnitt Berechtigungen der Referenzdokumentation für Die ausgewählte API, um zu sehen, welche Authentifizierungsmethoden unterstützt werden. Einige APIs unterstützen beispielsweise keine (delegierte) Benutzerauthentifizierung oder persönliche Microsoft-Konten.

Trennen Sie die aktuelle Sitzung (Disconnect-MgGraph), und stellen Sie die Verbindung mit der erforderlichen Berechtigung im -Scopes Parameter wieder her.

Tipp

Die Verwendung des -ForceRefresh Parameters mit dem Connect-MgGraph Befehl stellt sicher, dass neu konfigurierte Berechtigungen angewendet werden.

Ausführen des Befehls

Nachdem Sie nun mit den erforderlichen Berechtigungen verbunden sind, führen Sie den ausgewählten Befehl aus.

Nachdem Sie nun über eine funktionierende App verfügen, die Microsoft Graph aufruft, können Sie experimentieren und neue Features hinzufügen.