Herstel SharePoint-machtigingen in bulk op basis van een rapport, niet item voor item
Disclosure: Cognillo sponsors M365.FM. This page describes the company factually; paid partnerships and links are labelled as advertising.
By Mirko Peters · · Updated
Herstel SharePoint-machtigingen in bulk: exporteer een rapport, markeer elke rij als behouden, verwijderen of resetten, test een PnP PowerShell-script eerst op één site en controleer daarna het resultaat.
Automatically translated with AI from the original post. Read the English original
Om SharePoint-machtigingen in bulk te herstellen, exporteer je een rapport van wie toegang heeft, markeer je elke rij als behouden, verwijderen of resetten, en voer je daarna een script uit dat je beslissingen inleest. Deze gids is bedoeld voor SharePoint-beheerders die te maken hebben met honderden items met unieke machtigingen en die die niet één voor één willen aanklikken. Je leest hoe je de beslissingenlijst opbouwt, welke PnP PowerShell-cmdlets het werk doen, wat het rapport van Microsoft weglaat, en hoe je een run test, logt en controleert. Een uitgewerkt voorbeeld met verzonnen getallen laat de volledige cyclus zien.
Belangrijkste punten
- Om SharePoint-machtigingen in bulk te herstellen, begin je met een rapport: elke wijziging in een script moet terug te voeren zijn op één rij die iemand heeft gemarkeerd als behouden, verwijderen of resetten.
- Het sitedeelrapport van Microsoft somt elk uniek bestand, elke gebruiker, machtiging en link op, maar laat links voor iedereen en de afzonderlijke personen binnen SharePoint-groepen weg.
- Drie PnP PowerShell-cmdlets dekken de meeste bulkherstellingen: Remove-PnPGroupMember, Set-PnPListItemPermission en Remove-PnPSiteCollectionAdmin.
- Een item resetten zodat het de machtigingen van de lijst overneemt, verwijdert de eigen machtigingen van het item. Dat is vaak de schoonste oplossing voor machtigingenwildgroei.
- Test het script op één site, houd een logboek bij van elke wijziging en draai daarna een tweede rapport om aan te tonen dat het probleem verholpen is.
Waarom item voor item oplossen mislukt
De meeste SharePoint-machtigingen-problemen ontstaan langzaam. Iemand deelt één bestand met een collega. Iemand anders verbreekt de overerving van machtigingen op een map voor een project dat al lang voorbij is. Na een paar jaar bevatten sommige documentbibliotheken honderden items met unieke machtigingen, en niemand weet meer welke er nog echt nodig zijn.
Dit één voor één oplossen heeft drie nadelen. Het kost veel tijd. Het is makkelijk om items te missen. En er blijft geen overzicht van wat je hebt gewijzigd, waardoor je een fout niet kunt terugdraaien en een auditor niet kunt antwoorden.
Een bulkherstel draait de volgorde om. Eerst verzamel je de feiten in een rapport. Daarna beslist een persoon. Pas dan voert een script iets uit, en alleen op rijen met een beslissing. Zo behoud je de snelheid van automatisering en de zorgvuldigheid van een handmatige controle.
Bulkherstel van SharePoint-machtigingen: vijf stappen
Volg deze stappen in volgorde.
- Exporteer de feiten. Maak een rapport voor de site. Microsoft's gids over het rapport over het delen van bestanden en mappen zegt dat een sitebeheerder het uitvoert via Instellingen, Siteverbruik, in de sectie Gedeeld met externe gebruikers, met Rapport uitvoeren. Je kiest waar je het CSV-bestand opslaat, en je krijgt een e-mail zodra het klaar is.
- Voeg een beslissingskolom toe. Open het CSV-bestand in Excel en voeg een kolom toe met drie toegestane waarden: behouden, verwijderen en resetten. Voeg een tweede kolom toe voor de reden. Vraag de site-eigenaar de rijen na te kijken die jij zelf niet kunt beoordelen.
- Schrijf het script rond de beslissingen. Lees het bestand in met
Import-Csv, loop over de rijen en voer per beslissingstype één cmdlet uit. Sla elke rij zonder beslissing over. - Test eerst op één site, daarna op één bibliotheek. Voer het script eerst uit op een testsite of op één enkele bibliotheek. Vergelijk het resultaat met wat je verwachtte.
- Controleer met een tweede rapport. Maak na de echte uitvoering het rapport opnieuw aan. De rijen die je hebt verwijderd, moeten weg zijn, en de rijen die je hebt behouden, moeten ongewijzigd zijn.
Sla stap 2 niet over. Een script is pas zo veilig als de lijst die het inleest.
Hoe overerving van machtigingen werkt voordat je iets reset
De supportpagina van Microsoft over het aanpassen van machtigingen voor een SharePoint-lijst of -bibliotheek legt uit dat mappen, lijsten en documenten machtigingen normaal gesproken overerven van de site waarin ze zich bevinden. Om een lijst of bibliotheek eigen machtigingen te geven, kiest een eigenaar voor Overerving van machtigingen stoppen, waarna de items eronder de nieuwe instellingen overnemen. Om terug te gaan, biedt het tabblad Machtigingen de optie Unieke machtigingen verwijderen, waarmee de aangepaste machtigingen die je hebt ingesteld, worden verwijderd.
Drie waarschuwingen op dezelfde pagina zijn belangrijk bij bulkwerk:
- De limiet van 100.000 items. Je kunt de overerving niet doorbreken of herstellen op een lijst, bibliotheek of map met meer dan 100.000 items. Een enkel bestand in een grote bibliotheek kan wel een doorbroken overerving hebben.
- Een gebruiker verwijderen heeft effect op onderliggende items. Als je een gebruiker of groep verwijdert, wordt die ook uit onderliggende items verwijderd, inclusief items met doorbroken overerving, en herstellen is niet mogelijk. Lees je logboek voordat je een verwijdering uitvoert.
- Beperkte toegang blijft bestaan. Een persoon met wie alleen één item is gedeeld, krijgt beperkte toegang tot de site, en als je het item niet meer deelt, verdwijnt die toegang niet vanzelf.
Microsoft raadt SharePoint-groepen aan en noemt machtigingen op itemniveau ondersteund binnen redelijk gebruik. Onze eigen vuistregel is om toegang via een groep toe te kennen, niet aan afzonderlijke gebruikers, zodat sitemachtigingen overzichtelijk blijven en er minder unieke machtigingen zijn om op te lossen.
Welke cmdlet lost welk probleem op?
PnP PowerShell heeft cmdlets voor de meeste bulkoplossingen. Deze drie komen het vaakst voor.
Een persoon uit een SharePoint-groep verwijderen. In de referentie voor Remove-PnPGroupMember staat de syntaxis: Remove-PnPGroupMember -LoginName user@company.com -Group 'Marketing Site Members'. Gebruik dit bij problemen met groepslidmaatschappen, bijvoorbeeld een vertrokken medewerker die nog in een Members-groep staat.
Machtigingen op een item wijzigen of resetten. In de referentie voor Set-PnPListItemPermission staan deze opties:
-AddRoleen-RemoveRolevoegen een machtigingsniveau voor een gebruiker of groep toe aan één item of verwijderen het. GebruikGet-PnPRoleDefinitionom de beschikbare rollen te bekijken.-ClearExistingverwijdert alle bestaande machtigingen op het item voordat de nieuwe rol wordt toegevoegd.-InheritPermissionsreset het item zodat het machtigingen van de lijst overneemt, en verwijdert de unieke machtigingen van het item.-SystemUpdatewijzigt machtigingen zonder een nieuwe versie aan te maken of Power Automate te activeren.
Resetten is vaak de eenvoudigste oplossing. Als een item alleen unieke machtigingen heeft omdat iemand het ooit heeft gedeeld, brengt een reset het terug naar de regels van de bibliotheek.
Een sitecollectiebeheerder verwijderen. In de referentie voor Remove-PnPSiteCollectionAdmin staat Remove-PnPSiteCollectionAdmin -Owners "user@contoso.onmicrosoft.com". Beheerders die je niet noemt, behouden hun toegang. Je kunt ook een lijst met gebruikers meegeven.
Om de ene gebruiker door een andere te vervangen, voer je twee stappen uit: voeg de nieuwe persoon toe waar de oude persoon toegang had, en verwijder daarna de oude persoon. Voeg eerst toe, zodat niemand tussentijds toegang verliest.
Wat het rapport niet laat zien
Een rapport is een begin, niet de volledige waarheid. De pagina van Microsoft over het deelrapport vermeldt wat het CSV-bestand niet bevat:
- Individuele gebruikers binnen SharePoint-groepen. De groep verschijnt, maar niet de leden ervan.
- Links die per e-mail zijn verzonden maar nooit zijn geopend.
- Anonieme links (voor iedereen).
Dit heeft echte gevolgen. Als je wilt weten waar een persoon toegang heeft, toont het rapport de groep, dus moet je de leden van die groep apart uitlezen. Als je openbare delingen wilt verwijderen, vermeldt het rapport helemaal geen Iedereen-links, dus heb je een andere bron nodig, zoals de rapporten voor Data access governance in het SharePoint-beheercentrum. Volgens Microsoft vereisen die SharePoint Advanced Management.
Voor een afzonderlijke SharePoint-site in SharePoint Online kun je, voordat je items aanraakt, ook de sitemachtigingen en de machtigingsniveaus controleren die onder Sitio-instellingen in gebruik zijn. Bekijk daarna de opties voor SharePoint-rapportage voor de hele tenant, niet alleen voor één site. Een CSV per site schaalt niet naar honderden sites.
Voor sites die aan een Microsoft 365-groep zijn gekoppeld, wordt het lidmaatschap van de groep beheerd via de groep en niet via de eigen groepen van de site. Een script dat sitegroepen bewerkt, lost een persoon die lid is van de Microsoft 365-groep niet op.
Zorg dat het script veilig kan worden uitgevoerd
Een bulkscript kan in korte tijd veel schade aanrichten. Bouw deze beveiligingen in voordat je de eerste echte run uitvoert:
- Voeg een dry-run-schakelaar toe. Je eigen script kan een parameter
-DryRunhebben die elke geplande actie afdrukt en niets wijzigt. Bekijk die uitvoer samen met de siteeigenaar. - Log voordat je iets wijzigt. Schrijf per rij eerst de oude situatie naar het logbestand: het itempad, de gebruiker en het machtigingsniveau, zoals Volledig beheer, Bewerken of Lezen. Dat logbestand is je weg terug.
- Werk in batches. Voer eerst 50 items uit, controleer ze en voer daarna de volgende 500 uit. Een kleine eerste batch vangt een verkeerde aanname vroeg op.
- Bewaar het oorspronkelijke rapport. Sla de CSV met je beslissingen en het logbestand op in een map die alleen siteeigenaren kunnen openen. Microsoft adviseert hetzelfde voor het rapport zelf, omdat het laat zien wie toegang heeft tot wat.
- Wijzig het groepslidmaatschap in een aparte run. Pas itemmachtigingen in de ene run aan en groepslidmaatschap in een andere, zodat je elk type wijziging afzonderlijk kunt controleren.
Voorbeeld: een documentbibliotheek opschonen
De getallen zijn verzonnen.
Een projectsite heeft één documentbibliotheek. Het rapport bevat 620 rijen. Na het sorteren markeren een beheerder en de siteeigenaar ze:
- 410 rijen: behouden. Dit zijn de normale, op groepen gebaseerde machtigingen.
- 150 rijen: resetten. Het zijn afzonderlijke bestanden met unieke machtigingen uit oude deelacties.
- 40 rijen: verwijderen. Ze geven een voormalige externe medewerker directe toegang.
- 20 rijen: onduidelijk. Die gaan terug naar de eigenaar met een vraag.
De beheerder schrijft een script met twee takken. De resettak voert voor elk bestand Set-PnPListItemPermission uit met -InheritPermissions. De verwijdertak voert Remove-PnPGroupMember uit voor de externe medewerker in de groepen waarin die voorkomt. Het script schrijft één logregel per actie: de datum, het item, de oude situatie en de nieuwe situatie.
Eerst voert de beheerder het script uit op een kopie van de bibliotheek met 20 rijen. Het resultaat komt overeen met het plan. De volledige run duurt één avond. Een tweede rapport toont 410 plus 20 rijen, wat de beheerder had verwacht. Het logbestand wordt naast het rapport bewaard, zodat iedereen kan zien wat er is gebeurd.
Veelgemaakte fouten
- Een script uitvoeren zonder beslissingenlijst. Je kunt later niet verklaren waarom een item is gewijzigd.
- Overerving resetten op een bibliotheek waar unieke machtigingen bedoeld zijn. Sommige mappen zijn met opzet beperkt. Markeer ze als behouden.
- Het rapport als volledig beschouwen. Het laat Iedereen-links en leden van SharePoint-groepen weg.
- Eerst verwijderen, dan toevoegen. Wanneer je de ene gebruiker door een andere vervangt, voeg dan eerst toe.
- Persoon voor persoon toegang verlenen. Ken machtigingen toe via een groep, niet aan één gebruiker per item, zodat de volgende controle korter is.
- De Microsoft 365-groep vergeten. Een persoon kan via groepslidmaatschap toegang behouden, ook nadat je de site hebt opgeschoond.
- Geen log en geen tweede rapport. Zonder die twee kun je de oplossing niet aantonen of ongedaan maken.
Hoe software kan helpen
Begin met de tools die je al hebt. Het rapport over sitedeling en de rapporten in het beheercentrum geven je de feiten. PnP PowerShell voert de wijzigingen door, en een spreadsheet bevat de beslissingen en het logbestand.
Sommige tools van derden combineren rapportage en oplossing in één scherm. Een voorbeeld is de SharePoint Essentials Toolkit van Cognillo. Volgens de productpagina van de leverancier biedt die machtigingsrapporten voor sites, mappen en items, toont die alles waar één persoon toegang toe heeft, vervangt die de ene gebruiker door de andere, en repareert die machtigingen en deellinks op basis van de rapporten. De leverancier zegt ook dat rapporten en taken kunnen worden ingepland en geëxporteerd. Dit zijn de uitspraken van de leverancier en M365.FM heeft ze niet getest. De handmatige aanpak hierboven werkt zonder deze tools.
Openbaarmaking: Cognillo sponsort M365.FM.
Volgende stap
Kies één site met een bekend machtigingsprobleem, draai het deelrapport en voeg een beslissingskolom toe aan de CSV. Gebruik die lijst vervolgens om SharePoint-machtigingen in bulk te repareren, eerst op een testbibliotheek, en bewaar het logboek.