M365Con 2027 – die kostenlose Online-Konferenz · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

SharePoint-Berechtigungen gesammelt aus einem Bericht korrigieren, nicht Element für Element

Transparenzhinweis: Cognillo sponsert M365.FM. Diese Seite beschreibt das Unternehmen sachlich; bezahlte Partnerschaften und Links sind als Anzeige gekennzeichnet.

Von · · Aktualisiert

SharePoint-Berechtigungen gesammelt korrigieren: Bericht exportieren, jede Zeile als behalten, entfernen oder zurücksetzen markieren, ein PnP-PowerShell-Skript zuerst auf einer Website testen und danach prüfen.

Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen

Um SharePoint-Berechtigungen gesammelt zu korrigieren, exportieren Sie einen Bericht darüber, wer Zugriff hat. Markieren Sie jede Zeile als behalten, entfernen oder zurücksetzen. Danach führen Sie ein Skript aus, das Ihre Entscheidungen einliest. Diese Anleitung richtet sich an SharePoint-Admins, die hunderte Elemente mit eindeutigen Berechtigungen vorfinden und diese nicht einzeln anklicken wollen. Sie erfahren, wie Sie die Entscheidungsliste aufbauen, welche PnP-PowerShell-Cmdlets die Arbeit erledigen, was der Microsoft-Bericht auslässt und wie Sie einen Lauf testen, protokollieren und prüfen. Ein durchgerechnetes Beispiel mit fiktiven Zahlen zeigt den gesamten Ablauf.

Das Wichtigste in Kürze

  • Um SharePoint-Berechtigungen gesammelt zu korrigieren, beginnen Sie mit einem Bericht: Jede Änderung im Skript muss auf eine Zeile zurückzuführen sein, die eine Person als behalten, entfernen oder zurücksetzen markiert hat.
  • Der Freigabebericht der Website von Microsoft listet jede eindeutige Datei, jeden Benutzer, jede Berechtigung und jeden Link auf. Er lässt jedoch Links für „Jeder“ und die einzelnen Personen in SharePoint-Gruppen aus.
  • Drei PnP-PowerShell-Cmdlets decken die meisten Massenkorrekturen ab: Remove-PnPGroupMember, Set-PnPListItemPermission und Remove-PnPSiteCollectionAdmin.
  • Ein Element auf die Vererbung der Berechtigungen seiner Liste zurückzusetzen entfernt seine eindeutigen Berechtigungen. Das ist oft die sauberste Lösung gegen schleichende Berechtigungsausweitung.
  • Testen Sie das Skript auf einer Website, protokollieren Sie jede Änderung und erstellen Sie danach einen zweiten Bericht. So belegen Sie, dass das Problem behoben ist.

Warum das Korrigieren Element für Element scheitert

Die meisten SharePoint-Berechtigungsprobleme entstehen schleichend. Jemand teilt eine einzelne Datei mit einer Kollegin. Eine andere Person unterbricht die Berechtigungsvererbung für einen Ordner aus einem Projekt, das längst beendet ist. Nach einigen Jahren enthalten manche Bibliotheken hunderte Elemente mit eindeutigen Berechtigungen, und niemand kann sagen, welche davon noch relevant sind.

Diese Probleme einzeln zu beheben hat drei Nachteile. Es dauert lange. Elemente werden leicht übersehen. Und es gibt kein Protokoll der Änderungen, sodass Sie Fehler nicht rückgängig machen oder Prüfern keine Auskunft geben können.

Ein gesammelter Ansatz dreht die Reihenfolge um. Zuerst sammeln Sie die Fakten in einem Bericht. Dann entscheidet eine Person. Erst danach führt ein Skript Änderungen aus, und zwar nur bei Zeilen mit einer Entscheidung. So bleiben die Geschwindigkeit der Automatisierung und die Sorgfalt einer manuellen Prüfung erhalten.

SharePoint-Berechtigungen gesammelt korrigieren: fünf Schritte

Gehen Sie diese Schritte der Reihe nach durch.

  1. Fakten exportieren. Erstellen Sie einen Bericht für die Website. Laut Microsofts Anleitung zum Freigabebericht für Dateien und Ordner führt ein Websiteadmin ihn unter Einstellungen, Websitenutzung im Abschnitt Mit externen Benutzern freigegeben über Bericht ausführen aus. Sie wählen den Speicherort der CSV-Datei, und nach Abschluss erhalten Sie eine E-Mail.
  2. Entscheidungsspalte hinzufügen. Öffnen Sie die CSV-Datei in Excel und fügen Sie eine Spalte mit drei zulässigen Werten hinzu: behalten, entfernen, zurücksetzen. Fügen Sie eine zweite Spalte für die Begründung hinzu. Bitten Sie den Websiteinhaber, die Zeilen zu prüfen, die Sie selbst nicht beurteilen können.
  3. Skript um die Entscheidungen herum schreiben. Lesen Sie die Datei mit Import-Csv ein, durchlaufen Sie die Zeilen und führen Sie pro Entscheidungstyp ein Cmdlet aus. Überspringen Sie jede Zeile ohne Entscheidung.
  4. Zuerst auf einer Website, dann auf einer Bibliothek testen. Führen Sie das Skript zuerst auf einer Testwebsite oder einer einzelnen Bibliothek aus. Vergleichen Sie das Ergebnis mit dem, was Sie erwartet haben.
  5. Mit einem zweiten Bericht prüfen. Erstellen Sie nach dem eigentlichen Lauf den Bericht erneut. Die Zeilen, die Sie entfernt haben, sollten verschwunden sein, und die Zeilen, die Sie behalten haben, sollten unverändert sein.

Überspringen Sie Schritt 2 nicht. Ein Skript ist nur so sicher wie die Liste, die es liest.

Wie die Vererbung von Berechtigungen funktioniert, bevor Sie etwas zurücksetzen

Die Microsoft-Supportseite zum Anpassen von Berechtigungen für eine SharePoint-Liste oder -Bibliothek erklärt, dass Ordner, Listen und Dokumente ihre Berechtigungen normalerweise von der Website übernehmen, die sie enthält. Um einer Liste oder Bibliothek eigene Berechtigungen zu geben, wählt ein Besitzer die Option „Vererbung beenden“. Die Elemente darunter übernehmen dann die neuen Einstellungen. Um dies rückgängig zu machen, bietet die Registerkarte „Berechtigungen“ die Option „Eindeutige Berechtigungen löschen“, die die benutzerdefinierten Berechtigungen entfernt, die Sie festgelegt haben.

Drei Warnhinweise auf derselben Seite sind für Massenarbeiten wichtig:

  • Das Limit von 100.000 Elementen. Sie können die Vererbung bei einer Liste, Bibliothek oder einem Ordner, der mehr als 100.000 Elemente enthält, weder unterbrechen noch wiederherstellen. Eine einzelne Datei in einer großen Bibliothek kann aber weiterhin eine unterbrochene Vererbung haben.
  • Das Entfernen eines Benutzers wirkt sich auf untergeordnete Elemente aus. Wenn Sie einen Benutzer oder eine Gruppe entfernen, werden diese auch aus untergeordneten Elementen entfernt, einschließlich solcher mit unterbrochener Vererbung. Eine Wiederherstellung ist nicht möglich. Lesen Sie Ihr Protokoll, bevor Sie eine Entfernung ausführen.
  • Eingeschränkter Zugriff bleibt bestehen. Eine Person, für die nur ein einzelnes Element freigegeben wurde, erhält eingeschränkten Zugriff auf die Website. Das Aufheben der Freigabe des Elements entfernt diesen Zugriff nicht.

Microsoft empfiehlt SharePoint-Gruppen und bezeichnet Berechtigungen auf Elementebene bei vernünftiger Nutzung als unterstützt. Unsere eigene Faustregel lautet: Zugriff über eine Gruppe vergeben, nicht an einzelne Benutzer. So bleiben die Websiteberechtigungen übersichtlich, und es gibt weniger eindeutige Berechtigungen, die später korrigiert werden müssen.

Welches Cmdlet behebt welches Problem?

PnP PowerShell bietet Cmdlets für die meisten Massenkorrekturen. Diese drei kommen am häufigsten vor.

Eine Person aus einer SharePoint-Gruppe entfernen. Die Referenz zu Remove-PnPGroupMember zeigt die Syntax: Remove-PnPGroupMember -LoginName user@company.com -Group 'Marketing Site Members'. Verwenden Sie es bei Problemen mit Gruppenmitgliedschaften, etwa wenn ein ausgeschiedener Mitarbeiter noch in einer Mitgliedergruppe steht.

Berechtigungen für ein Element ändern oder zurücksetzen. Die Referenz zu Set-PnPListItemPermission listet diese Optionen auf:

  • -AddRole und -RemoveRole fügen eine Berechtigungsstufe für einen Benutzer oder eine Gruppe zu einem Element hinzu bzw. entfernen sie. Mit Get-PnPRoleDefinition sehen Sie die verfügbaren Rollen.
  • -ClearExisting entfernt alle vorhandenen Berechtigungen des Elements, bevor die neue Rolle hinzugefügt wird.
  • -InheritPermissions setzt das Element so zurück, dass es seine Berechtigungen von seiner Liste erbt, und entfernt seine eindeutigen Berechtigungen.
  • -SystemUpdate ändert Berechtigungen, ohne eine neue Version zu erstellen oder Power Automate auszulösen.

Das Zurücksetzen ist oft die sauberste Lösung. Hat ein Element nur deshalb eindeutige Berechtigungen, weil jemand es einmal freigegeben hat, bringt ein Zurücksetzen es wieder in Einklang mit den Regeln der Bibliothek.

Eine Websitesammlungsadministration entfernen. Die Referenz zu Remove-PnPSiteCollectionAdmin zeigt Remove-PnPSiteCollectionAdmin -Owners "user@contoso.onmicrosoft.com". Administratoren, die Sie nicht angeben, behalten ihren Zugriff. Sie können auch eine Liste von Benutzern übergeben.

Um einen Benutzer durch einen anderen zu ersetzen, führen Sie zwei Schritte aus: Fügen Sie die neue Person dort hinzu, wo die alte Person Zugriff hatte, und entfernen Sie danach die alte Person. Führen Sie zuerst das Hinzufügen aus, damit niemand zwischendurch den Zugriff verliert.

Was der Bericht nicht zeigt

Ein Bericht ist ein Ausgangspunkt, nicht die vollständige Wahrheit. Die Microsoft-Seite zum Freigabebericht nennt, was die CSV-Datei ausschließt:

  • Einzelne Benutzer innerhalb von SharePoint-Gruppen. Die Gruppe erscheint, ihre Mitglieder jedoch nicht.
  • Links, die per E-Mail versendet, aber nie angeklickt wurden.
  • Links für beliebige Personen (anonyme Links).

Das hat echte Konsequenzen. Wenn Sie herausfinden wollen, wo eine Person Zugriff hat, zeigt der Bericht die Gruppe an. Deshalb müssen Sie die Mitglieder der Gruppe separat prüfen. Wenn Sie öffentliche Freigaben entfernen wollen, listet der Bericht „Jeder“-Links überhaupt nicht auf. Dafür brauchen Sie eine andere Quelle, etwa die Berichte zu Data access governance im SharePoint Admin Center. Laut Microsoft setzen diese Berichte SharePoint Advanced Management voraus.

Für eine einzelne SharePoint-Website in SharePoint Online sollten Sie vor dem Ändern von Elementen außerdem die Websiteberechtigungen und die verwendeten Berechtigungsstufen unter Websiteeinstellungen prüfen. Prüfen Sie anschließend die Optionen für SharePoint-Berichte für den gesamten Mandanten, nicht nur für eine Website. Eine CSV-Datei pro Website skaliert nicht für Hunderte Websites.

Bei SharePoint-Websites, die mit einer Microsoft 365-Gruppe verbunden sind, wird die Gruppenmitgliedschaft über die Gruppe verwaltet, nicht in den eigenen Gruppen der Website. Ein Skript, das die Websitegruppen bearbeitet, behebt daher nicht den Fall einer Person, die in der Microsoft 365-Gruppe ist.

Das Skript sicher ausführbar machen

Ein Massenskript kann in kurzer Zeit großen Schaden anrichten. Bauen Sie diese Schutzmaßnahmen ein, bevor Sie den ersten echten Lauf starten:

  1. Einen Probelauf-Schalter hinzufügen. Ihr Skript kann einen Parameter -DryRun annehmen, der jede geplante Aktion ausgibt und nichts ändert. Prüfen Sie diese Ausgabe gemeinsam mit dem Websitebesitzer.
  2. Vor der Änderung protokollieren. Schreiben Sie für jede Zeile zuerst den alten Zustand ins Protokoll: den Elementpfad, den Benutzer und die Berechtigungsstufe, etwa Vollzugriff, Bearbeiten oder Lesen. Dieses Protokoll ist Ihr Weg zurück.
  3. In Batches arbeiten. Führen Sie zuerst 50 Elemente aus, prüfen Sie sie und führen Sie dann die nächsten 500 aus. Ein kleiner erster Batch deckt falsche Annahmen früh auf.
  4. Den Originalbericht aufbewahren. Speichern Sie die CSV-Datei mit Ihren Entscheidungen und dem Protokoll in einem Ordner, den nur Websitebesitzer öffnen können. Microsoft empfiehlt dasselbe für den Bericht selbst, da er auflistet, wer worauf Zugriff hat.
  5. Gruppenmitgliedschaften in einem separaten Lauf ändern. Korrigieren Sie die Elementberechtigungen in einem Lauf und die Gruppenmitgliedschaften in einem anderen, damit Sie jede Art von Änderung einzeln prüfen können.

Beispiel: Aufräumen einer Dokumentbibliothek

Die Zahlen sind erfunden.

Eine Projektwebsite hat eine Dokumentbibliothek. Der Bericht enthält 620 Zeilen. Nach dem Sortieren markieren ein Administrator und der Websitebesitzer sie:

  • 410 Zeilen: behalten. Das sind die üblichen gruppenbasierten Berechtigungen.
  • 150 Zeilen: zurücksetzen. Es handelt sich um einzelne Dateien mit eigenen Berechtigungen aus alten Freigaben.
  • 40 Zeilen: entfernen. Sie gewähren einem ehemaligen externen Auftragnehmer direkten Zugriff.
  • 20 Zeilen: unklar. Sie gehen mit einer Rückfrage an den Besitzer zurück.

Der Administrator schreibt ein Skript mit zwei Zweigen. Der Zweig zum Zurücksetzen führt für jede Datei Set-PnPListItemPermission mit -InheritPermissions aus. Der Zweig zum Entfernen führt Remove-PnPGroupMember für den externen Auftragnehmer in allen Gruppen aus, in denen dieser auftaucht. Das Skript schreibt pro Aktion eine Protokollzeile: Datum, Element, alter Zustand und neuer Zustand.

Zuerst führt der Administrator das Skript auf einer Kopie der Bibliothek mit 20 Zeilen aus. Das Ergebnis entspricht dem Plan. Der vollständige Lauf dauert einen Abend. Ein zweiter Bericht zeigt 410 + 20 Zeilen, wie der Administrator erwartet hatte. Das Protokoll wird neben dem Bericht gespeichert, sodass jeder nachvollziehen kann, was passiert ist.

Häufige Fehler

  • Ein Skript ohne Entscheidungsliste ausführen. Sie können später nicht erklären, warum sich ein Element geändert hat.
  • Die Vererbung auf einer Bibliothek zurücksetzen, auf der eindeutige Berechtigungen beabsichtigt sind. Manche Ordner sind absichtlich eingeschränkt. Markieren Sie sie als behalten.
  • Dem Bericht als vollständig vertrauen. Er lässt „Jeder“-Links und Mitglieder von SharePoint-Gruppen aus.
  • Entfernen vor Hinzufügen. Wenn Sie einen Benutzer durch einen anderen ersetzen, fügen Sie zuerst den neuen hinzu.
  • Zugriff Person für Person vergeben. Vergeben Sie Berechtigungen über eine Gruppe statt einzeln pro Benutzer und Element. So fällt die nächste Überprüfung kürzer aus.
  • Die Microsoft 365-Gruppe vergessen. Eine Person kann über ihre Gruppenmitgliedschaft auch dann Zugriff behalten, wenn Sie die Website bereinigt haben.
  • Kein Protokoll und kein zweiter Bericht. Ohne beides können Sie die Korrektur weder nachweisen noch rückgängig machen.

Wie Software helfen kann

Beginnen Sie mit den Werkzeugen, die Sie bereits haben. Der Freigabebericht der Website und die Berichte im Admin Center liefern die Fakten. PnP PowerShell führt die Änderungen durch, und eine Tabellenkalkulation enthält die Entscheidungen und das Protokoll.

Einige Tools von Drittanbietern vereinen Berichterstellung und Korrektur auf einem Bildschirm. Ein Beispiel ist Cognillo's SharePoint Essentials Toolkit. Laut der Produktseite des Anbieters bietet es Berechtigungsberichte für Websites, Ordner und Elemente, zeigt alle Zugriffe einer Person an, ersetzt einen Benutzer durch einen anderen und korrigiert Berechtigungen und Freigabelinks auf Basis der Berichte. Der Anbieter erklärt außerdem, dass Berichte und Aufgaben zeitgesteuert ausgeführt und exportiert werden können. Dabei handelt es sich um Angaben des Anbieters, die M365.FM nicht überprüft hat. Der oben beschriebene manuelle Weg funktioniert auch ohne diese Tools.

Offenlegung: Cognillo sponsert M365.FM.

Nächster Schritt

Wählen Sie eine Website mit einem bekannten Berechtigungsproblem aus, führen Sie den Freigabebericht aus und ergänzen Sie die CSV-Datei um eine Entscheidungsspalte. Verwenden Sie diese Liste anschließend, um die SharePoint-Berechtigungen zunächst in einer Testbibliothek massenhaft zu korrigieren, und bewahren Sie das Protokoll auf.

Entitäten in diesem Artikel

SharePoint permissions SharePoint reporting SharePoint Essentials Toolkit PnP PowerShell

Verwandte Artikel

RSS