Microsoft 365-Gruppenberichte mit PowerShell erstellen: So geht’s

Die Berichterstattung zu Microsoft 365-Gruppen hilft Administrator:innen dabei, Gruppenbesitz, Mitgliedschaften, Sichtbarkeit und Nutzung über Teams, SharePoint, Planner und Outlook hinweg nachzuvollziehen.

Klassische Methoden der Berichterstattung bieten schlicht nicht die Automatisierung und Tiefe, die moderne Administrator:innen benötigen. Deshalb setzen immer mehr Unternehmen auf Tools wie Graph PowerShell und die Graph Reports-Endpunkte, um Berichte zu erstellen.

Diese Plattformen automatisieren wiederkehrende Aufgaben wie das Sammeln von Mitgliedschaftsdaten und liefern vor allem deutlich reichhaltigere Datensätze.

In diesem Leitfaden zeigen wir Ihnen, wie Sie Microsoft 365-Gruppenberichte mit PowerShell und Graph Reports automatisieren.

Microsoft 365-Gruppenberichte mit PowerShell automatisieren

PowerShell und Microsoft Graph sind die beiden zentralen Werkzeuge, die Sie für eine skalierbare und sichere Berichterstattung zu Microsoft 365-Gruppen benötigen.

📌Voraussetzungen

• Die Module Microsoft Graph PowerShell SDK und Exchange Online
• Eine Azure-App-Registrierung mit den API-Berechtigungen Reports.Read.All und Group.Read.All
• App-only- oder delegierte Anmeldeinformationen, sicher gespeichert in einem Key Vault oder einer verschlüsselten JSON-Datei
• Administratorrechte für den Zugriff auf die Berichterstattung des Microsoft 365-Mandanten und Exchange Online

Methode 1: Vollständige Gruppeninventur mit Microsoft Graph PowerShell

📌Anwendungsfall: Diese Methode stellt eine sichere Verbindung zu Microsoft Graph her, über die Sie Ihre Microsoft 365-Daten abfragen können. Sie eignet sich ideal für eine vollständige Inventur aller Gruppen in Ihrem Mandanten, einschließlich Teams-fähiger und dynamischer Gruppen

A. Module installieren und importieren

Install-Module Microsoft.Graph -Scope CurrentUser

Import-Module Microsoft.Graph

Connect-MgGraph -Scopes "Group.Read.All","Reports.Read.All"

Damit wird das SDK sicher installiert und mit den erforderlichen Berechtigungen verbunden.

B. Alle Microsoft 365-Gruppen mit Get-MgGroup inventarisieren

Get-MgGroup -All | Select DisplayName,GroupTypes,Visibility,CreatedDateTime |

Export-Csv "C:\Reports\GroupInventory.csv" -NoTypeInformation

💡Tipp: Filtern Sie die Ergebnisse nach Gruppentyp oder Namenskonvention, um Teams-fähige oder dynamische Gruppen gezielt herauszufiltern.

Methode 2: Mitgliedschaften und Besitzverhältnisse über Exchange Online abrufen

📌Anwendungsfall: Mit dieser Methode rufen Sie Details zu Mitgliedschaften und Besitzverhältnissen direkt aus Exchange Online ab. Das ist besonders hilfreich für Administrator:innen, die E-Mail-aktivierte Sicherheitsgruppen oder Microsoft 365-Verteilerlisten verwalten.

A. Mit Exchange Online verbinden:

Connect-ExchangeOnline -UserPrincipalName [email protected]

Get-UnifiedGroup | Select DisplayName,PrimarySmtpAddress,AccessType |

Export-Csv "C:\Reports\UnifiedGroups.csv" -NoTypeInformation

B. Gruppenmitglieder oder -besitzer:innen auflisten:

Get-UnifiedGroupLinks -Identity "<GroupName>" -LinkType Members |

Select Name,PrimarySmtpAddress

Exportieren Sie die Ergebnisse zur Prüfung oder als Audit-Dokumentation.

Methode 3: Gruppennutzung mit der Microsoft Graph Reports API analysieren

📌Anwendungsfall: Mit dieser Methode analysieren Sie Gruppenaktivitäten und gewinnen Einblicke in den Lebenszyklus.

A. Graph Reports API für Gruppenaktivitäten aufrufen

$uri = "https://graph.microsoft.com/v1.0/reports/getOffice365GroupsActivityDetail(period='D30')"

Invoke-MgGraphRequest -Method GET -Uri $uri |

ConvertFrom-Csv | Export-Csv "C:\Reports\GroupActivity_D30.csv" -NoTypeInformation

Vergleichen Sie die Aktivitätszahlen mit den Mitgliedschaftsdaten, um zu erkennen, welche Gruppen inaktiv oder kaum genutzt sind oder keine Besitzer:innen haben.

Methode 4: Exporte automatisieren und planen

📌Anwendungsfall: Mit dieser Methode erstellen Sie Gruppenberichte automatisiert für Compliance und Management-Berichterstattung.

1. Sichern Sie Ihre App-Anmeldeinformationen, indem Sie sie in einer verschlüsselten JSON-Datei speichern.
2. Nutzen Sie eine geplante PowerShell-Aufgabe oder ein Azure Automation-Runbook für die Ausführung in der Cloud:

$timestamp = Get-Date -Format "yyyyMMdd_HHmm"
Get-MgGroup -All | Export-Csv "C:\Reports\Groups_$timestamp.csv" -NoTypeInformation

3. Aktivieren Sie die Protokollierung für jeden Durchlauf und stellen Sie sicher, dass sie wichtige Details enthält, etwa Zeitstempel der Ausführung, Mandantenname, Anzahl der Datensätze sowie Erfolgs- oder Fehlerstatus.
4. Optional können Sie die exportierten CSV-Dateien in Power BI oder ein Compliance-Berichtspaket einspeisen.

Best Practices für Microsoft 365-Gruppenberichte mit PowerShell und Graph Reports im Überblick

Validierung und Fehlerbehebung bei häufigen Problemen

Wenn Ihr Skript Fehler zurückgibt oder unvollständige Daten erzeugt, nutzen Sie die folgende Checkliste, um häufige Probleme zu erkennen und zu beheben.

• Leere Ergebnisse: Prüfen Sie die Protokollierungseinstellungen des Mandanten und kontrollieren Sie, ob die Graph-API-Berechtigungen korrekt zugewiesen sind.
• Zugriff verweigert: Stellen Sie sicher, dass die Administratorzustimmung für alle erforderlichen API-Berechtigungen in der Azure-App-Registrierung ausdrücklich erteilt wurde.
• Ratenbegrenzungen: Setzen Sie bei größeren Mandanten eine Verzögerungs- oder Wiederholungslogik ein, um Anfragen zu drosseln und die Ratenbegrenzungen der Graph-API nicht zu überschreiten.
• Skriptfehler: Fassen Sie Abfrageblöcke in Try/Catch ein, um Ausnahmen sauber abzufangen und den Fehler für eine spätere Prüfung zu protokollieren.
• Abgelaufene Tokens: Richten Sie Alarmierungen zur Überwachung des Token-Ablaufs ein und wechseln Sie Ihre App-Secrets regelmäßig. So laufen Ihre automatisierten Berichte zuverlässig weiter.

Ansatzpunkt für die Automatisierung der Microsoft 365-Gruppenberichte

Automatisierung kann für MSPs ein echter Wendepunkt sein. Ein täglich geplanter Job, der sich per App-only-Authentifizierung mit Microsoft Graph verbindet, hilft Ihnen zum Beispiel dabei:

• Gruppenlisten und Aktivitätskennzahlen über mehrere Kundenmandanten hinweg abzurufen.
• Daten in einem einheitlichen CSV-Bericht inklusive Zeitstempel zusammenzuführen.
• Berichte automatisiert per E-Mail an bestimmte Administrator:innen zu senden.

Dieser Ansatz verringert den manuellen Aufwand für Ihr Team, sodass es sich auf wichtigere Aufgaben konzentrieren kann.

Microsoft 365-Gruppenberichte mit NinjaOne vereinfachen

NinjaOne macht die Berichterstattung zu Microsoft 365-Gruppen mühelos. Die leistungsstarke Skripting-Engine ermöglicht es Ihnen, PowerShell-Bereitstellungen über Kundenumgebungen hinweg zu automatisieren.

Dank sicherer Speicherung von Anmeldeinformationen können Sie Skripte erstellen, die umsetzbare Erkenntnisse liefern, CSV-Berichte automatisiert erzeugen und sie direkt an die Kundendokumentation anhängen, ganz ohne Sicherheitskompromisse.

Intelligentere Microsoft 365-Gruppenberichte mit PowerShell erstellen

Moderne PowerShell-Berichterstattung für Microsoft 365-Gruppen nutzt Graph-basierte Cmdlets und APIs und erreicht damit eine Präzision und Automatisierung, die klassische Berichtsmethoden nicht bieten können.

Wenn Sie Inventur-, Mitgliedschafts- und Aktivitätsdaten in einheitlichen Berichten zusammenführen, gewinnen Sie entscheidende Transparenz über jeden Kundenmandanten und jede Geschäftseinheit, die Sie betreuen. Noch wichtiger: Dieser Ansatz hält Ihre Berichterstattung skalierbar und zukunftssicher.

Verwandte Themen:

• So nutzen Sie die Microsoft Graph API, um Compliance-Berichte über mehrere Mandanten hinweg abzurufen
• So sichern Sie Microsoft 365 Exchange Online
• Das Administrator-Handbuch zu SharePoint-Gruppenberechtigungen: Einrichtung, Verwaltung und Best Practices
• Microsoft Graph API mit Windows PowerShell nutzen, um Microsoft 365-Clients zu überwachen und zu verwalten
• So erstellen Sie MSP-taugliche Compliance-Berichte aus dem Microsoft Secure Score