Microsoft 365 mit PowerShell prüfen. Lesend starten, Ergebnisse verstehen.
Ein lesender Bericht über Gruppen und ihre Eigentümer mit Microsoft Graph PowerShell. Kleine Rechte, klare Erwartung und was die Zahlen wirklich sagen.
PowerShell gegen den eigenen Tenant macht vielen ein ungutes Gefühl. Zu Recht. Ein falscher Befehl mit den falschen Rechten richtet in Sekunden mehr an als ein Nachmittag im Admin Center.
Die Antwort ist nicht, die Finger davon zu lassen. Die Antwort ist eine Arbeitsweise.
Lesend anfangen. Rechte klein halten. Jedes Ergebnis hinterfragen.
Ich zeige das an einem kleinen Bericht, der eine einfache Frage beantwortet. Welche Microsoft-365-Gruppen haben keinen oder nur einen Eigentümer?
Bevor du etwas ausführst
Vor jeder Abfrage stelle ich mir drei Fragen.
- Wozu? Welche Entscheidung soll das Ergebnis ermöglichen? Ohne Zweck sammelst du Daten, die niemand braucht und die trotzdem geschützt werden müssen.
- Womit? Welche Berechtigung ist die kleinste, die reicht? Was du nicht darfst, kannst du auch nicht versehentlich tun.
- Was erwarte ich? Wie viele Zeilen, welche Größenordnung?
Die dritte Frage wird am häufigsten ausgelassen. Wer vorher schätzt, dass der Tenant etwa 60 Teams hat, stutzt bei 600 Zeilen. Wer nichts erwartet, exportiert sie einfach.
Dazu kommen vier Regeln für den lesenden Start.
- Leserolle statt Adminrolle. Für Bestandsaufnahmen ist Global Reader die richtige Rolle, das lesende Gegenstück zum Global Admin.
- Nur Leseberechtigungen anfordern. Microsoft Graph PowerShell fordert Berechtigungen einzeln an. Wer nur
Readanfordert und keine älteren Schreibrechte in der Sitzung hat, kann nichts ändern, auch wenn er sich vertippt. - Nur
Get--Befehle.Set-,New-,Update-undRemove-haben in einem Bestandsbericht nichts verloren. - Erst zählen, dann exportieren.
Schritt 1. Verbinden und nachsehen, was du darfst
Connect-MgGraph -Scopes 'Group.Read.All'
Get-MgContext | Select-Object Account, TenantId, Scopes
Schau dir die Scopes in der Ausgabe genau an. Stehen dort mehr Berechtigungen, als du angefordert hast, wurden sie früher einmal für die App „Microsoft Graph Command Line Tools“ erteilt. Sie gelten auch in dieser Sitzung. Steht dort etwas mit ReadWrite, ist deine Sitzung nicht mehr rein lesend.
Group.Read.All braucht die Zustimmung eines Administrators. Mit Global Reader erteilst du sie nicht selbst. Fehlt sie im Tenant noch, stimmt jemand mit passender Adminrolle einmalig zu.
Die kleinste passende Berechtigung musst du nicht raten. Das Modul bringt einen eigenen Befehl dafür mit.
Find-MgGraphCommand -Command 'Get-MgGroupOwner' |
Select-Object -ExpandProperty Permissions |
Select-Object Name, IsAdmin
Für das Lesen der Eigentümer allein reicht GroupMember.Read.All. Ich nehme hier Group.Read.All, weil der Bericht auch die Eigenschaften der Gruppen selbst liest.
Schritt 2. Zählen
Schreib dir vorher auf, welche drei Zahlen du erwartest. Dann erst ausführen.
$gruppen = Get-MgGroup -All -Property Id, DisplayName, GroupTypes, Visibility, CreatedDateTime, ResourceProvisioningOptions
"Gruppen insgesamt: $(@($gruppen).Count)"
"Microsoft-365-Gruppen: $(@($gruppen | Where-Object { $_.GroupTypes -contains 'Unified' }).Count)"
"davon Teams: $(@($gruppen | Where-Object { @($_.AdditionalProperties['resourceProvisioningOptions']) -contains 'Team' }).Count)"
Das Team-Kennzeichen hat im Gruppenobjekt des Moduls keine eigene Eigenschaft. Der Wert steht in AdditionalProperties, deshalb liest die dritte Zeile ihn von dort.
Liegt eine Zahl weit neben deiner Erwartung, hör hier auf und finde heraus, warum. Meist sind Sicherheitsgruppen und Verteiler mitgezählt, oder es gibt deutlich mehr alte Gruppen als gedacht. Beides ist schon ein Ergebnis.
Schritt 3. Eigentümer lesen
$bericht = foreach ($g in ($gruppen | Where-Object { $_.GroupTypes -contains 'Unified' })) {
$eigentuemer = @(Get-MgGroupOwner -GroupId $g.Id -All)
[PSCustomObject]@{
Gruppe = $g.DisplayName
Team = @($g.AdditionalProperties['resourceProvisioningOptions']) -contains 'Team'
Sichtbarkeit = $g.Visibility
Erstellt = $g.CreatedDateTime
AnzahlEigentuemer = $eigentuemer.Count
}
}
$bericht | Group-Object AnzahlEigentuemer | Sort-Object Name | Select-Object Name, Count
Die letzte Zeile liefert eine Verteilung. So viele Gruppen haben null Eigentümer, so viele einen, so viele zwei oder mehr. Das ist die Übersicht für das Gespräch mit der Geschäftsführung.
Der Bericht fragt die Eigentümer je Gruppe einzeln ab. In großen Tenants dauert das eine Weile.
Schritt 4. Nur exportieren, was eine Entscheidung braucht
$bericht |
Where-Object { $_.AnzahlEigentuemer -lt 2 } |
Sort-Object AnzahlEigentuemer, Gruppe |
Export-Csv .\gruppen-eigentuemer-klaeren.csv -NoTypeInformation -Encoding UTF8 -Delimiter ';'
Disconnect-MgGraph
Die Datei enthält bewusst keine Namen. Für die Frage, wo jemand fehlt, reicht die Zahl. Je weniger personenbezogene Daten in einer CSV auf dem Desktop liegen, desto besser. Leg trotzdem fest, wo die Datei liegt und wann sie gelöscht wird.
Eine Zahl ist noch keine Aussage
Jetzt beginnt die eigentliche Arbeit.
Null Eigentümer heißt nicht immer verwaist. Graph liefert keine Eigentümer für Gruppen, die in Exchange erstellt wurden, und für Gruppen, die aus dem lokalen Active Directory synchronisiert werden. Der Filter auf Microsoft-365-Gruppen nimmt die Verteiler raus. Die in Exchange angelegten Gruppen bleiben eine Lücke. Jede Gruppe mit null Eigentümern schaust du dir deshalb einzeln im Admin Center an, bevor du sie meldest.
Ein Eigentümer kann ein deaktiviertes Konto sein. Der Bericht zählt Einträge. Ob die Person noch im Unternehmen ist, zeigt er nicht.
Ein Eigentümer kann ein Dienstkonto sein. Formal versorgt, praktisch ohne Ansprechpartner.
Zwei Eigentümer heißt nicht „in Ordnung“. Es heißt nur, dass zwei Namen eingetragen sind.
Außerdem siehst du auch mit Group.Read.All nur, was deine Rolle im Verzeichnis zulässt. Und ob eine Gruppe überhaupt noch genutzt wird, beantwortet dieser Bericht nicht.
Daraus folgt meine Regel für die Weitergabe. Die CSV ist eine Liste von Fragen an die Fachbereiche, keine Liste von Befunden. Statt „27 Gruppen sind falsch“ sagst du „Bei diesen Gruppen hängt alles an einer Person. Bitte nennt mir einen zweiten Namen.“ Der zweite Satz bringt dir Antworten, der erste eine Diskussion.
Lesend heißt nicht folgenlos
Zwei Dinge solltest du wissen, auch wenn du nur liest. Die erste Anmeldung mit neuen Berechtigungen speichert eine Zustimmung im Tenant. Die bleibt, bis jemand sie entfernt. Und jeder Export ist eine Datei, für die du verantwortlich bist.
Schreibende Skripte sind ein anderes Kapitel. Die brauchen einen Test, eine Freigabe und einen Weg zurück.
Wer sehen will, wie ein lesender Bericht in einem anderen Bereich aussieht, findet ihn in PowerShell - Teams Planner Task Report.
Erst die Erwartung, dann die Abfrage. In der Reihenfolge fällt dir ein falsches Ergebnis auf.
Gruß Micha