Naprawa uprawnień SharePoint zbiorczo na podstawie raportu, a nie element po elemencie
Disclosure: Cognillo sponsors M365.FM. This page describes the company factually; paid partnerships and links are labelled as advertising.
By Mirko Peters · · Updated
Zbiorcza naprawa uprawnień SharePoint: wyeksportuj raport, oznacz każdy wiersz jako zachowaj, usuń lub zresetuj, przetestuj skrypt PnP PowerShell najpierw na jednej witrynie, a następnie sprawdź wynik.
Automatically translated with AI from the original post. Read the English original
Aby zbiorczo naprawić uprawnienia SharePoint, wyeksportuj raport o tym, kto ma dostęp, oznacz każdy wiersz jako zachowaj, usuń lub zresetuj, a następnie uruchom skrypt, który odczyta Twoje decyzje. Ten przewodnik jest przeznaczony dla administratorów SharePoint, którzy mają do czynienia z setkami elementów z unikatowymi uprawnieniami i nie chcą klikać ich pojedynczo. Dowiesz się, jak przygotować listę decyzji, które cmdlety PnP PowerShell wykonują pracę, czego nie uwzględnia raport Microsoft oraz jak testować, rejestrować i sprawdzać przebieg zmian. Przykład z wymyślonymi liczbami pokazuje pełny cykl.
Najważniejsze wnioski
- Aby zbiorczo naprawić uprawnienia SharePoint, zacznij od raportu: każda zmiana w skrypcie musi wynikać z jednego wiersza, który osoba oznaczyła jako zachowaj, usuń lub zresetuj.
- Raport udostępniania witryny Microsoft wymienia każdy unikatowy plik, użytkownika, uprawnienie i link, ale nie uwzględnia linków Anyone ani poszczególnych osób w grupach SharePoint.
- Trzy cmdlety PnP PowerShell obejmują większość zbiorczych napraw: Remove-PnPGroupMember, Set-PnPListItemPermission oraz Remove-PnPSiteCollectionAdmin.
- Zresetowanie elementu, aby dziedziczył uprawnienia z listy, usuwa jego unikatowe uprawnienia i często jest najczystszym sposobem na opanowanie narastającego rozrostu uprawnień.
- Przetestuj skrypt na jednej witrynie, prowadź dziennik każdej zmiany, a po wszystkim uruchom kolejny raport, aby potwierdzić, że problem zniknął.
Dlaczego naprawa element po elemencie zawodzi
Większość problemów z uprawnieniami SharePoint narasta powoli. Ktoś udostępnia pojedynczy plik koleżance. Ktoś inny przerywa dziedziczenie uprawnień w folderze na potrzeby projektu, który dawno się skończył. Po kilku latach w niektórych bibliotekach dokumentów znajdują się setki elementów z unikatowymi uprawnieniami i nikt nie wie, które z nich nadal mają znaczenie.
Naprawianie tego po jednym elemencie ma trzy wady. Jest powolne. Łatwo pominąć elementy. Nie zostawia też zapisu tego, co zmieniono, więc nie da się cofnąć błędu ani odpowiedzieć audytorowi.
Zbiorcza naprawa odwraca kolejność. Najpierw zbierasz fakty w raporcie. Następnie decyzję podejmuje człowiek. Dopiero wtedy skrypt działa, i to tylko na wierszach, które mają decyzję. Dzięki temu zachowujesz szybkość automatyzacji i staranność ręcznego przeglądu.
Jak zbiorczo naprawić uprawnienia SharePoint: pięć kroków
Wykonuj te kroki w podanej kolejności.
- Wyeksportuj fakty. Utwórz raport dla witryny. Przewodnik Microsoft po raporcie udostępniania plików i folderów wskazuje, że administrator witryny uruchamia go z menu Ustawienia, Użycie witryny, w sekcji Udostępniono użytkownikom zewnętrznym, przyciskiem Uruchom raport. Wybierasz lokalizację zapisu pliku CSV, a po zakończeniu otrzymujesz wiadomość e-mail.
- Dodaj kolumnę decyzji. Otwórz plik CSV w programie Excel i dodaj kolumnę z trzema dozwolonymi wartościami: zachowaj, usuń, zresetuj. Dodaj drugą kolumnę na uzasadnienie. Poproś właściciela witryny o przejrzenie wierszy, których sam nie potrafisz ocenić.
- Napisz skrypt wokół decyzji. Odczytaj plik za pomocą
Import-Csv, przejdź w pętli po wierszach i uruchom jeden cmdlet dla każdego typu decyzji. Pomijaj wiersze bez decyzji. - Najpierw test na jednej witrynie, potem na jednej bibliotece. Uruchom skrypt najpierw na witrynie testowej lub na pojedynczej bibliotece. Porównaj wynik z tym, czego się spodziewałeś.
- Sprawdź za pomocą drugiego raportu. Po rzeczywistym uruchomieniu utwórz raport ponownie. Wiersze, które usunąłeś, powinny zniknąć, a wiersze, które zachowałeś, powinny pozostać bez zmian.
Nie pomijaj kroku 2. Skrypt jest tylko tak bezpieczny, jak lista, którą odczytuje.
Jak działa dziedziczenie uprawnień, zanim cokolwiek zresetujesz
Strona pomocy Microsoft dotycząca dostosowywania uprawnień dla listy lub biblioteki SharePoint wyjaśnia, że foldery, listy i dokumenty zwykle dziedziczą uprawnienia z witryny, która je zawiera. Aby nadać liście lub bibliotece własne uprawnienia, właściciel wybiera opcję Zatrzymaj dziedziczenie uprawnień, a elementy znajdujące się poniżej dziedziczą wtedy nowe ustawienia. Aby cofnąć tę zmianę, na karcie Uprawnienia dostępna jest opcja Usuń unikatowe uprawnienia, która usuwa niestandardowe uprawnienia, które ustawiłeś.
Trzy ostrzeżenia z tej samej strony są istotne przy pracy zbiorczej:
- Limit 100 000 elementów. Nie można przerwać ani przywrócić dziedziczenia na liście, bibliotece lub folderze, które zawierają więcej niż 100 000 elementów. Pojedynczy plik w dużej bibliotece nadal może mieć przerwane dziedziczenie.
- Usunięcie użytkownika obejmuje elementy podrzędne. Usunięcie użytkownika lub grupy usuwa ich także z elementów podrzędnych, w tym z tych, które mają przerwane dziedziczenie, i nie da się tego cofnąć. Przed uruchomieniem usuwania przeczytaj swój dziennik.
- Dostęp ograniczony pozostaje. Osoba, z którą udostępniono tylko jeden element, otrzymuje dostęp ograniczony do witryny, a cofnięcie udostępnienia elementu tego nie zmienia.
Microsoft zaleca grupy SharePoint i uznaje uprawnienia na poziomie elementów za obsługiwane w rozsądnym zakresie użycia. Nasza własna zasada kciuka brzmi: przydzielaj dostęp przez grupę, a nie indywidualnym użytkownikom, dzięki czemu uprawnienia witryny pozostają czytelne, a do naprawy zostaje mniej unikatowych uprawnień.
Które polecenie cmdlet rozwiązuje który problem?
PnP PowerShell zawiera polecenia cmdlet do większości zbiorczych napraw. Te trzy pojawiają się najczęściej.
Usuń osobę z grupy SharePoint. Dokumentacja Remove-PnPGroupMember pokazuje składnię: Remove-PnPGroupMember -LoginName user@company.com -Group 'Marketing Site Members'. Użyj go w przypadku problemów z członkostwem w grupie, na przykład gdy osoba, która odeszła z firmy, nadal figuruje w grupie Members.
Zmień lub zresetuj uprawnienia elementu. Dokumentacja Set-PnPListItemPermission wymienia następujące opcje:
-AddRolei-RemoveRoledodają lub usuwają poziom uprawnień dla użytkownika lub grupy w jednym elemencie. UżyjGet-PnPRoleDefinition, aby zobaczyć dostępne role.-ClearExistingusuwa wszystkie istniejące uprawnienia elementu, zanim zostanie dodana nowa rola.-InheritPermissionsresetuje element tak, aby dziedziczył uprawnienia z listy, i usuwa jego unikatowe uprawnienia.-SystemUpdatezmienia uprawnienia bez tworzenia nowej wersji i bez uruchamiania Power Automate.
Resetowanie jest często najczystszym rozwiązaniem. Jeśli element ma unikatowe uprawnienia tylko dlatego, że ktoś raz go udostępnił, reset przywraca mu zasady obowiązujące w bibliotece.
Usuń administratora kolekcji witryn. Dokumentacja Remove-PnPSiteCollectionAdmin pokazuje Remove-PnPSiteCollectionAdmin -Owners "user@contoso.onmicrosoft.com". Administratorzy, których nie wymienisz, zachowują dostęp. Można również przekazać listę użytkowników.
Aby zastąpić jednego użytkownika innym, wykonaj dwa kroki: dodaj nową osobę tam, gdzie poprzednia miała dostęp, a następnie usuń poprzednią osobę. Najpierw wykonaj dodawanie, aby nikt nie stracił dostępu w międzyczasie.
Czego raport nie pokazuje
Raport jest punktem wyjścia, a nie pełnym obrazem. Strona Microsoft dotycząca raportu udostępniania określa, czego nie zawiera plik CSV:
- Poszczególni użytkownicy w grupach SharePoint. Grupa jest widoczna, ale jej członkowie już nie.
- Linki wysłane e-mailem, w które nikt nie kliknął.
- Linki anonimowe (dla dowolnej osoby).
To ma realne konsekwencje. Jeśli celem jest ustalenie, gdzie dana osoba ma dostęp, raport pokaże grupę, więc musisz osobno sprawdzić członków tej grupy. Jeśli celem jest usunięcie udostępniania publicznego, raport w ogóle nie wymieni linków Anyone, więc potrzebujesz innego źródła, na przykład raportów Data access governance w centrum administracyjnym SharePoint. Według Microsoftu wymagają one usługi SharePoint Advanced Management.
W przypadku pojedynczej witryny SharePoint w usłudze SharePoint Online przed zmianą elementów przejrzyj także uprawnienia witryny oraz poziomy uprawnień używane w obszarze Ustawienia witryny. Następnie sprawdź opcje raportowania w SharePoint dla całej dzierżawy, a nie tylko jednej witryny. Plik CSV dla pojedynczej witryny nie skaluje się do setek witryn.
W witrynach połączonych z grupami Microsoft 365 członkostwem zarządza się przez grupę, a nie w grupach witryny. Skrypt edytujący grupy witryny nie naprawi sytuacji, w której dana osoba należy do grupy Microsoft 365.
Jak bezpiecznie uruchomić skrypt
Skrypt zbiorczy może w krótkim czasie wyrządzić wiele szkód. Przed pierwszym rzeczywistym uruchomieniem wbuduj te zabezpieczenia:
- Dodaj przełącznik suchego przebiegu. Twój skrypt może przyjmować parametr
-DryRun, który wypisuje każde planowane działanie i niczego nie zmienia. Przejrzyj to wyjście razem z właścicielem witryny. - Zapisz do dziennika przed zmianą. Dla każdego wiersza najpierw zapisz do dziennika stary stan: ścieżkę elementu, użytkownika oraz poziom uprawnień, na przykład Pełna kontrola, Edytowanie lub Odczyt. Ten dziennik jest Twoją drogą powrotu.
- Pracuj partiami. Uruchom 50 elementów, sprawdź je, a następnie kolejne 500. Mała pierwsza partia pozwala wcześnie wychwycić błędne założenie.
- Zachowaj oryginalny raport. Przechowuj plik CSV z Twoimi decyzjami oraz dziennik w folderze, który mogą otwierać tylko właściciele witryny. Microsoft sugeruje to samo w odniesieniu do samego raportu, ponieważ zawiera on listę osób mających dostęp do poszczególnych zasobów.
- Zmieniaj członkostwo w grupach w osobnym przebiegu. Uprawnienia elementów napraw w jednym przebiegu, a członkostwo w grupach w innym, abyś mógł sprawdzić każdy rodzaj zmian osobno.
Przykład: porządkowanie jednej biblioteki dokumentów
Liczby są wymyślone.
Witryna projektu ma jedną bibliotekę dokumentów. Raport zawiera 620 wierszy. Po posortowaniu administrator i właściciel witryny oznaczają je:
- 410 wierszy: zachować. To normalne uprawnienia oparte na grupach.
- 150 wierszy: zresetować. To pojedyncze pliki z unikatowymi uprawnieniami ze starych udziałów.
- 40 wierszy: usunąć. Dają byłemu podwykonawcy bezpośredni dostęp.
- 20 wierszy: niejasne. Wracają do właściciela z pytaniem.
Administrator pisze skrypt z dwiema gałęziami. Gałąź resetowania uruchamia Set-PnPListItemPermission z -InheritPermissions dla każdego pliku. Gałąź usuwania uruchamia Remove-PnPGroupMember dla podwykonawcy w grupach, w których się pojawia. Skrypt zapisuje jedną linię dziennika na każde działanie: datę, element, stary stan i nowy stan.
Najpierw administrator uruchamia skrypt na kopii biblioteki z 20 wierszami. Wynik zgadza się z planem. Pełne uruchomienie zajmuje jeden wieczór. Drugi raport pokazuje 410 plus 20 wierszy, czyli dokładnie tyle, ile administrator oczekiwał. Dziennik zapisany jest obok raportu, więc każdy może zobaczyć, co się wydarzyło.
Częste błędy
- Uruchamianie skryptu bez listy decyzji. Nie będziesz w stanie później wyjaśnić, dlaczego element się zmienił.
- Resetowanie dziedziczenia w bibliotece, w której unikatowe uprawnienia są zamierzone. Niektóre foldery są celowo ograniczone. Oznacz je jako zachować.
- Traktowanie raportu jako kompletnego. Pomija on linki Anyone oraz członków grup SharePoint.
- Usuwanie przed dodawaniem. Gdy zastępujesz jednego użytkownika innym, najpierw dodaj nowego.
- Nadawanie dostępu osobno każdej osobie. Przydzielaj uprawnienia przez grupę, a nie jednemu użytkownikowi na każdy element, aby następny przegląd był krótszy.
- Zapominanie o grupie Microsoft 365. Osoba może zachować dostęp przez członkostwo w grupie nawet po oczyszczeniu witryny.
- Brak dziennika i drugiego raportu. Bez nich nie da się udowodnić poprawki ani jej cofnąć.
Jak oprogramowanie może pomóc
Zacznij od narzędzi, które już masz. Raport udostępniania witryny i raporty w centrum administracyjnym dostarczają faktów. PnP PowerShell wprowadza zmiany, a arkusz kalkulacyjny przechowuje decyzje i dziennik.
Niektóre narzędzia innych firm łączą raporty i naprawę na jednym ekranie. Przykładem jest SharePoint Essentials Toolkit firmy Cognillo's. Według strony produktu dostawcy narzędzie oferuje raporty uprawnień dla witryn, folderów i elementów, pokazuje wszystko, do czego dany użytkownik ma dostęp, zastępuje jednego użytkownika innym oraz naprawia uprawnienia i linki udostępniania na podstawie raportów. Dostawca twierdzi też, że raporty i zadania można planować i eksportować. To są stwierdzenia dostawcy, które nie zostały przetestowane przez M365.FM. Opisana wyżej ręczna ścieżka działa bez żadnego z tych narzędzi.
Ujawnienie: Cognillo sponsoruje M365.FM.
Następny krok
Wybierz jedną witrynę ze znanym problemem z uprawnieniami, uruchom raport udostępniania i dodaj do pliku CSV kolumnę decyzji. Następnie użyj tej listy, aby masowo naprawić uprawnienia w SharePoint, najpierw w bibliotece testowej, i zachowaj dziennik.