Microsoft Graph klingt nach einem leistungsstarken Tool für den Zugriff auf alle möglichen Daten aus Microsofts Cloud-Ökosystem – von Benutzerinformationen und Dateien bis hin zu Teams-Kanälen. Die Einrichtung kann allerdings etwas knifflig sein, wenn man mit der Azure AD-Registrierung oder der SDK-Installation nicht vertraut ist. Man hat das Gefühl, Fortschritte zu machen, und dann stößt man plötzlich auf ein Problem, weil man einen kleinen Schritt übersehen hat – beispielsweise Berechtigungen oder eine Anpassung in der Befehlszeile. Wenn Sie Microsoft Graph unter Windows 11 problemlos zum Laufen bringen möchten, finden Sie hier eine detailliertere Anleitung mit praktischen Tipps und Befehlen, die Ihnen viel Ärger ersparen können.
So installieren und verwenden Sie Microsoft Graph unter Windows 11
Im Wesentlichen ist Microsoft Graph eine RESTful-API – also eine komfortable Möglichkeit, programmatisch über Webaufrufe mit Microsoft-Diensten zu interagieren. Sie müssen sich nur einmal authentifizieren und können dann zahlreiche Aktionen durchführen, z. B.Benutzer verwalten oder E-Mails lesen. Die Einrichtung umfasst einige wichtige Schritte: die Registrierung einer Azure AD-App, die Installation des SDK über PowerShell, die Auswahl des richtigen API-Endpunkts und die anschließende Authentifizierung, um API-Aufrufe tätigen zu können. Die praktische Umsetzung, insbesondere unter Windows 11, erfordert das Befolgen einiger Befehlszeilen und Menüklicks. Probleme können auftreten, wenn Berechtigungen vernachlässigt oder die PowerShell-Ausführungsrichtlinie fehlerhaft konfiguriert wird. Daher erklären wir Ihnen hier, wie Sie die Einrichtung korrekt durchführen.
Installieren Sie das Microsoft Graph SDK.
Zunächst müssen Sie das SDK installieren. Microsoft stellt es über die PowerShell Gallery bereit. Am einfachsten geht das mit PowerShell und Administratorrechten. Windows blockiert Skripte aus Sicherheitsgründen manchmal standardmäßig. Daher müssen Sie möglicherweise zuerst die Ausführungsrichtlinie anpassen – etwas umständlich, aber notwendig. Klicken Sie unter Windows 11 mit der rechten Maustaste auf das Startmenü, wählen Sie „ Windows PowerShell (Administrator)“ und führen Sie folgenden Befehl aus:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Dadurch können lokale Skripte und heruntergeladene Module ohne Sicherheitsfehler ausgeführt werden. In manchen Konfigurationen müssen Sie den Gültigkeitsbereich möglicherweise auf „Lokaler Rechner“ anstatt auf „Aktueller Benutzer“ setzen, normalerweise funktioniert der Gültigkeitsbereich des aktuellen Benutzers jedoch problemlos. Anschließend installieren Sie das Haupt-SDK mit:
Install-Module Microsoft. Graph -Scope CurrentUser -Repository PSGallery -Force
Wenn Sie mit neuen, noch nicht veröffentlichten Funktionen experimentieren möchten, lohnt es sich, auch das Beta-Modul zu besorgen:
Install-Module Microsoft. Graph. Beta -Scope CurrentUser
Kurzer Hinweis: Das Hauptmodul enthält alle Untermodule (wie Benutzer, Gruppen, Dateien).Wenn Sie jedoch nur bestimmte Dienste benötigen, können Sie diese separat installieren. Zum Beispiel, wenn Sie nur mit Benutzern arbeiten möchten:
Install-Module Microsoft. Graph. Users -Scope CurrentUser
Vergessen Sie natürlich nicht, Microsoft. Graph. Authentication für die Tokenverwaltung einzubinden. Das ist normalerweise Teil des Haupt-SDKs, aber es lohnt sich, die Dokumentation noch einmal zu prüfen, wenn Sie eine schlankere Konfiguration bevorzugen.
Wählen Sie Ihren API-Endpunkt (v1.0 oder Beta)
Dieser Teil bereitet vielen Schwierigkeiten. Sie haben zwei Möglichkeiten: die stabile API v1.0 – für den Produktiveinsatz – oder die Beta- Version mit neueren, experimentellen Funktionen. Gerade am Anfang empfiehlt sich v1.0, da sie garantiert stabil ist. Die Beta-API eignet sich zwar gut zum Testen neuer Funktionen, da sie sich aber noch in der Entwicklung befindet, können sich Funktionen schnell ändern oder sogar fehlerhaft sein. In Ihren Skripten oder Anwendungen geben Sie den Endpunkt daher folgendermaßen an:
- v1.0 Endpunkt :
https://graph.microsoft.com/v1.0/ - Beta-Endpunkt :
https://graph.microsoft.com/beta/
Auf manchen Systemen kann die Nutzung der Beta-Funktionen zu Fehlern oder Leistungseinbußen führen. Gehen Sie daher mit Bedacht vor. Ersetzen Sie beim Ausführen von Befehlen einfach die URL von v1.0 durch die entsprechende Beta-URL, je nach Bedarf. Die Beta-API dient mitunter als Testumgebung, um neue Funktionen vor der Veröffentlichung in der Hauptversion zu erkunden. Beachten Sie jedoch: Sie ist noch nicht für den Produktiveinsatz vorgesehen.
Authentifizieren und Verbinden
Hier scheitern viele. Die Authentifizierungsmethoden hängen von Ihrer Aufgabe ab: delegiert (im Auftrag eines Benutzers) oder anwendungsspezifisch (Hintergrunddienst).Das PowerShell SDK vereinfacht dies mit Connect-MgGraph. Um sich mit delegierten Berechtigungen zu authentifizieren (z. B.zum Lesen Ihrer E-Mails), führen Sie Folgendes aus:
Connect-MgGraph -Scopes "User. Read. All", "Mail. Read"
Dieser Befehl öffnet ein Anmeldefenster, in dem Sie sich bei Ihrem Microsoft-Konto anmelden, Berechtigungen erteilen und anschließend ein Token für zukünftige Aufrufe speichern. Wenn Sie mit App-spezifischen Berechtigungen testen möchten – beispielsweise für Hintergrundaufgaben –, müssen Sie eine App in Azure AD registrieren, ihr Berechtigungen erteilen und anschließend ein Clientgeheimnis oder -zertifikat generieren. Dies ist jedoch etwas aufwendiger und erfordert Anpassungen Ihrer Azure-Portal-Einstellungen unter Azure-Portal > Azure Active Directory > App-Registrierungen.
Von dort aus können Sie Ihre Verbindung testen mit:
$graphConnection = Connect-MgGraph -ClientId
Oder, für einfachere Tests, bleiben Sie zunächst bei der interaktiven Anmeldemethode.
Führen Sie Ihren ersten API-Aufruf durch.
Sobald die Verbindung hergestellt ist, ist der Aufruf der API unkompliziert. Um beispielsweise Ihre eigenen Profilinformationen abzurufen, führen Sie einfach Folgendes aus:
Get-MgUser -UserId 'me'
Wenn Sie Ihren E-Mail-Posteingang abrufen möchten, können Sie Folgendes tun:
Get-MgMailMessage -UserId 'me' -Top 10
Schon mal versucht, eine E-Mail über PowerShell zu versenden? Mit dem richtigen Cmdlet ist das genauso einfach – New-MgMailMessageallerdings sind dafür zusätzliche Berechtigungen erforderlich. Der springende Punkt ist: Sobald Sie authentifiziert sind, können Sie unzählige Aktionen ausführen, ohne sich durch endlose Dokumentationen wühlen zu müssen.
Zusätzliche Tipps & Häufige Fallstricke
Dieser Abschnitt ist etwas ungewöhnlich, aber falls Befehle fehlschlagen oder Authentifizierungsfehler auftreten, überprüfen Sie die Microsoft. Graph- Version, Ihre Berechtigungen und ob Sie im Azure-Portal die Administratorzustimmung erteilt haben. Windows kann außerdem bei Ausführungsrichtlinien sehr wählerisch sein. Falls Skripte nicht ausgeführt werden, überprüfen Sie den ersten Schritt und passen Sie die Richtlinie gegebenenfalls an RemoteSigned.
Bei manchen Konfigurationen kann es beim erstmaligen Installieren von Modulen oder Ausführen der Befehle erforderlich sein, PowerShell neu zu starten oder das System neu zu starten. Wenn Sie Beta-Funktionen testen, müssen Sie außerdem mit möglichen Inkompatibilitäten rechnen – Geduld ist gefragt.
Und falls Sie eine unkompliziertere Lösung bevorzugen, gibt es natürlich das GitHub-Repository: Winhance, das Skripte und Tipps enthält, die Ihnen das Ganze etwas erleichtern.
Zusammenfassung
- Stellen Sie sicher, dass die Ausführungsrichtlinie von PowerShell Skripte zulässt.
- Installieren Sie das SDK über PowerShell mit dem richtigen Gültigkeitsbereich.
- Registrieren Sie Ihre App in Azure AD, wenn Sie eine reine App-Authentifizierung benötigen.
- Wählen Sie den passenden API-Endpunkt entsprechend dem erforderlichen Reifegrad.
- Melden Sie sich an
Connect-MgGraphund testen Sie mit einfachen Befehlen.
Zusammenfassung
Die Einrichtung von Microsoft Graph unter Windows 11 ist zwar kein Hexenwerk, aber etwas knifflig, wenn man noch keine Erfahrung mit Azure AD oder PowerShell-Modulen hat. Wichtig ist, die Schritte geduldig zu befolgen – insbesondere bei Berechtigungen und Authentifizierung. Sobald alles funktioniert, ist es großartig, über einfache API-Aufrufe direkt auf so viele Microsoft-Cloud-Dienste zugreifen zu können. Beta-Endpunkte eignen sich zwar gut zum Testen, sind aber nicht für den Produktiveinsatz geeignet.Überprüfen Sie außerdem immer Ihre Bereiche und Zustimmungseinstellungen in Azure. Ich hoffe, diese Erklärung beschleunigt Ihre Einrichtung – ich drücke die Daumen!