Correggere le autorizzazioni di SharePoint in blocco a partire da un report, non elemento per elemento
Disclosure: Cognillo sponsors M365.FM. This page describes the company factually; paid partnerships and links are labelled as advertising.
By Mirko Peters · · Updated
Correggere le autorizzazioni di SharePoint in blocco: esporta un report, contrassegna ogni riga come mantieni, rimuovi o reimposta, testa prima uno script PnP PowerShell su un sito, poi verifica.
Automatically translated with AI from the original post. Read the English original
Per correggere le autorizzazioni di SharePoint in blocco, esporti un report su chi ha accesso, contrassegni ogni riga come mantieni, rimuovi o reimposta, e poi esegui uno script che legge le tue decisioni. Questa guida è pensata per gli amministratori di SharePoint che si trovano davanti a centinaia di elementi con autorizzazioni univoche e non vogliono cliccare su ciascuno di essi. Vedrai come costruire l'elenco delle decisioni, quali cmdlet di PnP PowerShell svolgono il lavoro, cosa tralascia il report di Microsoft e come testare, registrare e verificare un'esecuzione. Un esempio pratico con numeri inventati mostra l'intero ciclo.
Punti chiave
- Per correggere le autorizzazioni di SharePoint in blocco, parti da un report: ogni modifica in uno script deve risalire a una sola riga che una persona ha contrassegnato come mantieni, rimuovi o reimposta.
- Il report di condivisione del sito di Microsoft elenca ogni file, utente, autorizzazione e link univoci, ma tralascia i link Anyone e le singole persone all'interno dei gruppi di SharePoint.
- Tre cmdlet di PnP PowerShell coprono la maggior parte delle correzioni in blocco: Remove-PnPGroupMember, Set-PnPListItemPermission e Remove-PnPSiteCollectionAdmin.
- Reimpostare un elemento per ereditare le autorizzazioni dalla sua lista elimina le sue autorizzazioni univoche ed è spesso la correzione più pulita contro il permission creep.
- Testa lo script su un solo sito, registra ogni modifica ed esegui un secondo report al termine per dimostrare che il problema è stato risolto.
Perché correggere elemento per elemento non funziona
La maggior parte dei problemi di autorizzazioni di SharePoint si accumula lentamente. Qualcuno condivide un singolo file con un collega. Qualcun altro decide di interrompere l'ereditarietà delle autorizzazioni su una cartella per un progetto terminato da tempo. Dopo qualche anno, alcune librerie di documenti contengono centinaia di elementi con autorizzazioni univoche, e nessuno sa dire quali siano ancora importanti.
Correggerli uno alla volta presenta tre problemi. È lento. È facile dimenticare degli elementi. E non lascia traccia di ciò che hai modificato, quindi non puoi annullare un errore né rispondere a un auditor.
Una correzione in blocco inverte l'ordine. Prima raccogli i fatti in un report. Poi una persona decide. Solo a quel punto uno script agisce, e agisce soltanto sulle righe che hanno una decisione. Così si mantengono la rapidità dell'automazione e la cura di una revisione manuale.
Come correggere le autorizzazioni di SharePoint in blocco: cinque passaggi
Segui questi passaggi nell'ordine indicato.
- Esporta i fatti. Crea un report per il sito. La guida di Microsoft al report di condivisione di file e cartelle indica che un amministratore del sito lo esegue da Impostazioni, Utilizzo sito, nella sezione Condiviso con utenti esterni, con Esegui report. Scegli dove salvare il CSV e ricevi un'email al termine.
- Aggiungi una colonna per le decisioni. Apri il CSV in Excel e aggiungi una colonna con tre valori ammessi: mantieni, rimuovi, reimposta. Aggiungi una seconda colonna per il motivo. Chiedi al proprietario del sito di rivedere le righe che non sai valutare da solo.
- Scrivi lo script intorno alle decisioni. Leggi il file con
Import-Csv, scorri le righe ed esegui un cmdlet per ogni tipo di decisione. Salta ogni riga priva di decisione. - Prova su un sito, poi su una libreria. Esegui lo script prima su un sito di test o su una singola libreria. Confronta il risultato con quello che ti aspettavi.
- Controlla con un secondo report. Dopo l'esecuzione reale, crea di nuovo il report. Le righe che hai rimosso non devono più esserci, e quelle che hai mantenuto devono essere invariate.
Non saltare il passaggio 2. Uno script è sicuro solo quanto l'elenco che legge.
Come funziona l'ereditarietà delle autorizzazioni prima di reimpostare qualsiasi cosa
La pagina di supporto Microsoft su come personalizzare le autorizzazioni per un elenco o una libreria di SharePoint spiega che cartelle, elenchi e documenti ereditano normalmente le autorizzazioni dal sito che li contiene. Per assegnare a un elenco o a una libreria autorizzazioni proprie, un proprietario sceglie Interrompi ereditarietà delle autorizzazioni, e gli elementi sottostanti ereditano poi le nuove impostazioni. Per tornare indietro, la scheda Autorizzazioni offre Elimina autorizzazioni univoche, che rimuove le autorizzazioni personalizzate impostate.
Tre avvertenze della stessa pagina sono importanti per le operazioni in blocco:
- Il limite di 100.000 elementi. Non puoi interrompere o ripristinare l'ereditarietà su un elenco, una libreria o una cartella che contiene più di 100.000 elementi. Un singolo file in una libreria di grandi dimensioni può comunque avere l'ereditarietà interrotta.
- La rimozione di un utente raggiunge gli elementi figlio. Rimuovere un utente o un gruppo lo elimina anche dagli elementi figlio, compresi quelli con ereditarietà interrotta, e non è possibile ripristinarlo. Leggi il log prima di eseguire una rimozione.
- L'accesso limitato resta. Una persona con cui è stato condiviso un solo elemento ottiene un accesso limitato al sito, e annullare la condivisione dell'elemento non glielo toglie.
Microsoft consiglia i gruppi di SharePoint e definisce le autorizzazioni a livello di elemento supportate entro un utilizzo ragionevole. La nostra regola pratica è assegnare l'accesso tramite un gruppo, non ai singoli utenti, così le autorizzazioni del sito restano leggibili e restano da correggere meno autorizzazioni univoche.
Quale cmdlet risolve quale problema?
PnP PowerShell offre cmdlet per la maggior parte delle correzioni in blocco. Questi tre sono quelli che ricorrono più spesso.
Rimuovere una persona da un gruppo di SharePoint. La documentazione di Remove-PnPGroupMember mostra la sintassi: Remove-PnPGroupMember -LoginName user@company.com -Group 'Marketing Site Members'. Usalo per i problemi di appartenenza ai gruppi, ad esempio un utente uscito dall'organizzazione che risulta ancora in un gruppo Membri.
Modificare o reimpostare le autorizzazioni di un elemento. La documentazione di Set-PnPListItemPermission elenca queste opzioni:
-AddRolee-RemoveRoleaggiungono o rimuovono un livello di autorizzazione per un utente o un gruppo su un singolo elemento. UsaGet-PnPRoleDefinitionper vedere i ruoli disponibili.-ClearExistingrimuove tutte le autorizzazioni esistenti sull'elemento prima di aggiungere il nuovo ruolo.-InheritPermissionsreimposta l'elemento in modo che erediti le autorizzazioni dal proprio elenco e rimuove le sue autorizzazioni univoche.-SystemUpdatemodifica le autorizzazioni senza creare una nuova versione e senza attivare Power Automate.
Reimpostare è spesso la correzione più pulita. Se un elemento ha autorizzazioni univoche solo perché qualcuno lo ha condiviso una volta, la reimpostazione lo riporta alle regole della libreria.
Rimuovere un amministratore della raccolta siti. La documentazione di Remove-PnPSiteCollectionAdmin mostra Remove-PnPSiteCollectionAdmin -Owners "user@contoso.onmicrosoft.com". Gli amministratori che non indichi mantengono il loro accesso. È possibile passare anche un elenco di utenti.
Per sostituire un utente con un altro, esegui due passaggi: aggiungi la nuova persona dove aveva accesso quella vecchia, poi rimuovi quella vecchia. Esegui prima l'aggiunta, così nessuno perde l'accesso nel frattempo.
Cosa non mostra il report
Un report è un punto di partenza, non la verità completa. La pagina Microsoft sul report di condivisione indica cosa esclude il CSV:
- I singoli utenti all'interno dei gruppi di SharePoint. Il gruppo compare, ma non i suoi membri.
- I link inviati via email ma mai cliccati.
- I link anonimi (per chiunque).
Questo ha conseguenze reali. Se il tuo obiettivo è scoprire dove una persona ha accesso, il report mostrerà il gruppo, quindi devi leggere separatamente i membri del gruppo. Se il tuo obiettivo è rimuovere la condivisione pubblica, il report non elencherà affatto i link "Chiunque", quindi ti serve un'altra fonte, come i report di governance dell'accesso ai dati nell'interfaccia di amministrazione di SharePoint. Secondo Microsoft, questi richiedono SharePoint Advanced Management.
Per un singolo sito SharePoint in SharePoint Online, prima di intervenire sugli elementi controlla anche le autorizzazioni del sito e i livelli di autorizzazione in uso in Impostazioni sito. Poi verifica le opzioni di report di SharePoint per l'intero tenant, non solo per un sito. Un CSV per singolo sito non scala con centinaia di siti.
Per i siti collegati a un gruppo di Microsoft 365, l'appartenenza al gruppo si gestisce tramite il gruppo, non nei gruppi propri del sito. Uno script che modifica i gruppi del sito non risolverà il caso di una persona che fa parte del gruppo di Microsoft 365.
Rendi lo script sicuro da eseguire
Uno script di modifica massiva può causare molti danni in poco tempo. Prima della prima esecuzione reale, inserisci queste protezioni:
- Aggiungi un'opzione di simulazione. Il tuo script può accettare un parametro
-DryRunche stampa ogni azione pianificata senza modificare nulla. Verifica questo output con il proprietario del sito. - Registra prima di modificare. Per ogni riga, scrivi prima nel log lo stato precedente: il percorso dell'elemento, l'utente e il livello di autorizzazione, come Controllo completo, Modifica o Lettura. Quel log è il modo per tornare indietro.
- Lavora a lotti. Esegui 50 elementi, verificali, poi esegui i successivi 500. Un primo lotto piccolo intercetta presto un'ipotesi sbagliata.
- Conserva il report originale. Salva il CSV con le tue decisioni e il log in una cartella accessibile solo ai proprietari del sito. Microsoft suggerisce la stessa cosa per il report stesso, perché elenca chi ha accesso a cosa.
- Modifica l'appartenenza ai gruppi in un'esecuzione separata. Correggi le autorizzazioni degli elementi in una esecuzione e l'appartenenza ai gruppi in un'altra, così puoi verificare ogni tipo di modifica separatamente.
Esempio: pulizia di una raccolta documenti
I numeri sono inventati.
Un sito di progetto ha una sola raccolta documenti. Il report contiene 620 righe. Dopo l'ordinamento, un amministratore e il proprietario del sito le contrassegnano:
- 410 righe: mantieni. Sono le normali autorizzazioni basate sui gruppi.
- 150 righe: reimposta. Sono singoli file con autorizzazioni univoche derivate da vecchie condivisioni.
- 40 righe: rimuovi. Danno a un ex collaboratore l'accesso diretto.
- 20 righe: non chiaro. Tornano al proprietario con una domanda.
L'amministratore scrive uno script con due rami. Il ramo di reimpostazione esegue Set-PnPListItemPermission con -InheritPermissions per ogni file. Il ramo di rimozione esegue Remove-PnPGroupMember per il collaboratore nei gruppi in cui compare. Lo script scrive una riga di log per ogni azione: la data, l'elemento, lo stato precedente e il nuovo stato.
Per prima cosa, l'amministratore esegue lo script su una copia della raccolta con 20 righe. Il risultato corrisponde al piano. L'esecuzione completa richiede una sera. Un secondo report mostra 410 più 20 righe, che è quanto l'amministratore si aspettava. Il log viene salvato accanto al report, così chiunque può vedere cosa è successo.
Errori comuni
- Eseguire uno script senza un elenco delle decisioni. Non potrai spiegare in seguito perché un elemento è stato modificato.
- Reimpostare l'ereditarietà su una raccolta in cui le autorizzazioni univoche sono intenzionali. Alcune cartelle sono limitate di proposito. Contrassegnale come da mantenere.
- Considerare il report come completo. Esclude i link "Chiunque" e i membri dei gruppi di SharePoint.
- Rimuovere prima di aggiungere. Quando sostituisci un utente con un altro, aggiungi prima il nuovo.
- Concedere l'accesso persona per persona. Assegna le autorizzazioni tramite un gruppo, non a un utente per volta su ogni elemento, così la prossima revisione sarà più breve.
- Dimenticare il gruppo di Microsoft 365. Una persona può mantenere l'accesso tramite l'appartenenza al gruppo anche dopo che hai ripulito il sito.
- Nessun log e nessun secondo report. Senza di essi, non puoi dimostrare la correzione né annullarla.
Come può aiutare il software
Inizia con gli strumenti che hai già. Il report di condivisione del sito e i report dell'interfaccia di amministrazione ti forniscono i fatti. PnP PowerShell esegue le modifiche e un foglio di calcolo contiene le decisioni e il log.
Alcuni strumenti di terze parti combinano reporting e correzione in un'unica schermata. Un esempio è il SharePoint Essentials Toolkit di Cognillo. Secondo la pagina del prodotto del fornitore, offre report sulle autorizzazioni per siti, cartelle ed elementi, mostra tutto ciò a cui un singolo utente può accedere, sostituisce un utente con un altro e corregge le autorizzazioni e i link di condivisione a partire dai report. Il fornitore afferma inoltre che report e attività possono essere pianificati ed esportati. Si tratta di dichiarazioni del fornitore, non verificate da M365.FM. Il metodo manuale descritto sopra funziona senza nessuno di questi strumenti.
Nota di trasparenza: Cognillo sponsorizza M365.FM.
Prossimo passo
Scegli un sito con un problema di autorizzazioni noto, esegui il report di condivisione e aggiungi una colonna per la decisione al file CSV. Poi usa questo elenco per correggere in blocco le autorizzazioni di SharePoint, prima su una libreria di prova, e conserva il log.