Erweitern von PowerShell-Skripts, die reine App-Authentifizierung verwenden, mit weiteren 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. Beispielsweise die API für Listengruppen . 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.

Der API-Endpunkt zum Auflisten von Gruppen ist GET /groupsbeispielsweise . Sie können diese Informationen verwenden, um den entsprechenden PowerShell-Befehl zu suchen.

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, …

Die Ausgabe gibt an, dass der Get-MgGroup 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 z. B. keine app-only.

Um eine API mit nur app-Authentifizierung aufzurufen (sofern die API dies unterstützt), fügen Sie den erforderlichen Berechtigungsbereich im Microsoft Entra Admin Center hinzu. Stellen Sie sicher, dass Sie die Verbindung trennen und die Verbindung erneut herstellen, indem Sie nur die App-Berechtigung verwenden.

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.