Corriger les autorisations SharePoint en masse à partir d’un rapport, et non élément par élément
Disclosure: Cognillo sponsors M365.FM. This page describes the company factually; paid partnerships and links are labelled as advertising.
Par Mirko Peters · · Mis à jour
Corriger les autorisations SharePoint en masse : exporter un rapport, marquer chaque ligne « conserver », « supprimer » ou « réinitialiser », tester d’abord un script PnP PowerShell sur un seul site, puis vérifier le résultat.
Traduit automatiquement par IA à partir de l'article original. Lire l'original en anglais
Pour corriger les autorisations SharePoint en masse, vous exportez un rapport indiquant qui a accès, vous marquez chaque ligne comme « conserver », « supprimer » ou « réinitialiser », puis vous exécutez un script qui lit vos décisions. Ce guide s’adresse aux administrateurs SharePoint confrontés à des centaines d’éléments dotés d’autorisations uniques, et qui ne souhaitent pas les parcourir un par un. Vous verrez comment construire la liste de décisions, quelles applets de commande PnP PowerShell effectuent le travail, ce que le rapport Microsoft omet, et comment tester, journaliser et contrôler une exécution. Un exemple concret, avec des chiffres fictifs, illustre le cycle complet.
Points clés
- Pour corriger les autorisations SharePoint en masse, partez d’un rapport : chaque modification d’un script doit pouvoir être rattachée à une seule ligne qu’une personne a marquée « conserver », « supprimer » ou « réinitialiser ».
- Le rapport de partage de site de Microsoft répertorie chaque fichier, utilisateur, autorisation et lien uniques, mais il omet les liens « Tout le monde » ainsi que les personnes individuelles présentes dans les groupes SharePoint.
- Trois applets de commande PnP PowerShell couvrent la plupart des corrections en masse : Remove-PnPGroupMember, Set-PnPListItemPermission et Remove-PnPSiteCollectionAdmin.
- Réinitialiser un élément pour qu’il hérite des autorisations de sa liste supprime ses autorisations uniques, et c’est souvent la correction la plus propre contre la dérive des autorisations.
- Testez le script sur un seul site, conservez un journal de chaque modification, puis exécutez un second rapport pour vérifier que le problème a bien disparu.
Pourquoi corriger élément par élément ne fonctionne pas
La plupart des problèmes d’autorisations SharePoint s’accumulent lentement. Quelqu’un partage un seul fichier avec un collègue. Une autre personne choisit d’interrompre l’héritage des autorisations d’un dossier pour un projet terminé depuis longtemps. Après quelques années, certaines bibliothèques de documents comptent des centaines d’éléments dotés d’autorisations uniques, et personne ne sait lesquels sont encore pertinents.
Corriger ces éléments un à un pose trois problèmes. C’est lent. Il est facile d’en oublier. Et cela ne laisse aucune trace de vos modifications, si bien qu’il est impossible d’annuler une erreur ou de répondre à un auditeur.
Une correction en masse inverse l’ordre. D’abord, vous rassemblez les faits dans un rapport. Ensuite, une personne décide. Ce n’est qu’alors qu’un script agit, et uniquement sur les lignes qui ont une décision. Vous conservez ainsi la rapidité de l’automatisation et le soin d’une revue manuelle.
Corriger les autorisations SharePoint en masse : cinq étapes
Suivez ces étapes dans l’ordre.
- Exportez les faits. Créez un rapport pour le site. Le guide Microsoft consacré au rapport de partage de fichiers et de dossiers indique qu’un administrateur de site l’exécute depuis Paramètres, Utilisation du site, dans la section Partagé avec des utilisateurs externes, avec Exécuter le rapport. Vous choisissez l’emplacement d’enregistrement du fichier CSV, et vous recevez un e-mail à la fin du traitement.
- Ajoutez une colonne de décision. Ouvrez le CSV dans Excel et ajoutez une colonne aux trois valeurs autorisées : conserver, supprimer, réinitialiser. Ajoutez une seconde colonne pour le motif. Demandez au propriétaire du site de revoir les lignes que vous ne pouvez pas juger vous-même.
- Écrivez le script autour des décisions. Lisez le fichier avec
Import-Csv, parcourez les lignes et exécutez une applet de commande par type de décision. Ignorez chaque ligne qui n’a pas de décision. - Testez d’abord sur un site, puis sur une bibliothèque. Exécutez le script sur un site de test ou sur une seule bibliothèque. Comparez le résultat avec ce que vous attendiez.
- Vérifiez avec un second rapport. Après l’exécution réelle, générez de nouveau le rapport. Les lignes que vous avez supprimées ne doivent plus apparaître, et les lignes conservées doivent être inchangées.
Ne sautez pas l’étape 2. Un script n’est aussi sûr que la liste qu’il lit.
Fonctionnement de l’héritage des autorisations avant toute réinitialisation
La page d’assistance de Microsoft sur la personnalisation des autorisations d’une liste ou d’une bibliothèque SharePoint explique que les dossiers, les listes et les documents héritent normalement des autorisations du site qui les contient. Pour donner à une liste ou à une bibliothèque ses propres autorisations, un propriétaire choisit Arrêter d’hériter des autorisations, et les éléments qui se trouvent en dessous héritent alors des nouveaux paramètres. Pour revenir en arrière, l’onglet Autorisations propose Supprimer les autorisations uniques, ce qui supprime les autorisations personnalisées que vous avez définies.
Trois mises en garde de la même page sont importantes pour les opérations en masse :
- La limite de 100 000 éléments. Vous ne pouvez pas interrompre ou restaurer l’héritage d’une liste, d’une bibliothèque ou d’un dossier qui contient plus de 100 000 éléments. Un fichier isolé dans une grande bibliothèque peut tout de même voir son héritage interrompu.
- La suppression d’un utilisateur atteint les éléments enfants. Supprimer un utilisateur ou un groupe le retire également des éléments enfants, y compris ceux dont l’héritage est interrompu, et il est impossible de le restaurer. Lisez votre journal avant d’effectuer une suppression.
- L’accès limité subsiste. Une personne avec laquelle un seul élément a été partagé obtient un accès limité au site, et annuler le partage de l’élément ne supprime pas cet accès.
Microsoft recommande les groupes SharePoint et considère que les autorisations au niveau des éléments sont prises en charge dans un usage raisonnable. Notre règle empirique est d’attribuer l’accès par l’intermédiaire d’un groupe, et non à des utilisateurs individuels, afin que les autorisations du site restent lisibles et qu’il reste moins d’autorisations uniques à corriger.
Quelle applet de commande corrige quel problème ?
PnP PowerShell propose des applets de commande pour la plupart des corrections en masse. Ces trois-là reviennent le plus souvent.
Retirer une personne d’un groupe SharePoint. La référence de Remove-PnPGroupMember présente la syntaxe : Remove-PnPGroupMember -LoginName user@company.com -Group 'Marketing Site Members'. Utilisez-la pour les problèmes d’appartenance à un groupe, par exemple un collaborateur parti qui figure toujours dans un groupe Membres.
Modifier ou réinitialiser les autorisations d’un élément. La référence de Set-PnPListItemPermission répertorie les options suivantes :
-AddRoleet-RemoveRoleajoutent ou retirent un niveau d’autorisation pour un utilisateur ou un groupe sur un seul élément. UtilisezGet-PnPRoleDefinitionpour afficher les rôles disponibles.-ClearExistingsupprime toutes les autorisations existantes de l’élément avant l’ajout du nouveau rôle.-InheritPermissionsréinitialise l’élément afin qu’il hérite des autorisations de sa liste, et supprime ses autorisations uniques.-SystemUpdatemodifie les autorisations sans créer de nouvelle version et sans déclencher Power Automate.
La réinitialisation est souvent la correction la plus propre. Si un élément ne possède des autorisations uniques que parce que quelqu’un l’a partagé une fois, une réinitialisation le ramène aux règles de la bibliothèque.
Retirer un administrateur de collection de sites. La référence de Remove-PnPSiteCollectionAdmin présente Remove-PnPSiteCollectionAdmin -Owners "user@contoso.onmicrosoft.com". Les administrateurs que vous ne nommez pas conservent leur accès. Une liste d’utilisateurs peut également être transmise.
Pour remplacer un utilisateur par un autre, exécutez deux étapes : ajoutez la nouvelle personne là où l’ancienne avait accès, puis retirez l’ancienne. Effectuez d’abord l’ajout, afin que personne ne perde son accès entre-temps.
Ce que le rapport n’affiche pas
Un rapport n’est qu’un point de départ, pas la vérité complète. La page de Microsoft consacrée au rapport de partage précise ce que le fichier CSV exclut :
- Les utilisateurs individuels membres de groupes SharePoint. Le groupe apparaît, mais pas ses membres.
- Les liens envoyés par e-mail mais jamais utilisés.
- Les liens anonymes (« Tout le monde »).
Cela a des conséquences réelles. Si votre objectif est de savoir où une personne dispose d’un accès, le rapport affichera le groupe. Il faut alors lire séparément les membres de ce groupe. Si votre objectif est de supprimer le partage public, le rapport ne listera pas du tout les liens Anyone. Il faut donc une autre source, comme les rapports Data access governance du centre d’administration SharePoint. Selon Microsoft, ceux-ci nécessitent SharePoint Advanced Management.
Pour un site unique dans SharePoint Online, examinez aussi les autorisations du site et les niveaux d’autorisation utilisés dans les Paramètres du site, avant de modifier quoi que ce soit dans les éléments. Vérifiez ensuite les options de SharePoint reporting pour l’ensemble du locataire, et pas seulement pour un site. Un export CSV par site ne passe pas à l’échelle lorsqu’il y a des centaines de sites.
Pour les sites connectés à un groupe Microsoft 365, l’appartenance au groupe se gère via le groupe lui-même, et non dans les groupes propres au site. Un script qui modifie les groupes du site ne corrigera pas l’accès d’une personne qui fait partie du groupe Microsoft 365.
Rendre le script sûr à exécuter
Un script de modification en masse peut causer beaucoup de dégâts en très peu de temps. Mettez en place les protections suivantes avant la première exécution réelle :
- Ajoutez un commutateur de simulation. Votre script peut accepter un paramètre
-DryRunqui affiche chaque action prévue sans rien modifier. Faites valider cette sortie avec le propriétaire du site. - Journalisez avant de modifier. Pour chaque ligne, écrivez d’abord l’état initial dans le journal : le chemin de l’élément, l’utilisateur et le niveau d’autorisation, comme Contrôle total, Modifier ou Lecture. Ce journal vous permettra de revenir en arrière.
- Travaillez par lots. Traitez 50 éléments, vérifiez-les, puis passez aux 500 suivants. Un premier lot réduit permet de détecter tôt une hypothèse erronée.
- Conservez le rapport d’origine. Stockez le CSV avec vos décisions et le journal dans un dossier auquel seuls les propriétaires du site ont accès. Microsoft recommande la même précaution pour le rapport lui-même, car il indique qui a accès à quoi.
- Modifiez l’appartenance aux groupes dans une exécution distincte. Corrigez les autorisations des éléments dans une exécution, et l’appartenance aux groupes dans une autre, afin de vérifier chaque type de modification séparément.
Exemple : nettoyer une bibliothèque de documents
Les chiffres sont fictifs.
Un site de projet contient une seule bibliothèque de documents. Le rapport compte 620 lignes. Après tri, un administrateur et le propriétaire du site les annotent :
- 410 lignes : conserver. Il s’agit des autorisations normales basées sur les groupes.
- 150 lignes : réinitialiser. Ce sont des fichiers isolés avec des autorisations uniques, issues d’anciens partages.
- 40 lignes : supprimer. Elles accordent un accès direct à un ancien prestataire.
- 20 lignes : incertain. Elles sont renvoyées au propriétaire avec une question.
L’administrateur écrit un script à deux branches. La branche de réinitialisation exécute Set-PnPListItemPermission avec -InheritPermissions pour chaque fichier. La branche de suppression exécute Remove-PnPGroupMember pour le prestataire, dans les groupes où il apparaît. Le script écrit une ligne de journal par action : la date, l’élément, l’état initial et le nouvel état.
Dans un premier temps, l’administrateur exécute le script sur une copie de la bibliothèque contenant 20 lignes. Le résultat correspond au plan. L’exécution complète prend une soirée. Un second rapport affiche 410 lignes plus 20 lignes, ce que l’administrateur attendait. Le journal est enregistré à côté du rapport, afin que chacun puisse voir ce qui s’est passé.
Erreurs courantes
- Exécuter un script sans liste de décisions. Vous ne pourrez pas expliquer plus tard pourquoi un élément a été modifié.
- Réinitialiser l’héritage sur une bibliothèque où des autorisations uniques sont voulues. Certains dossiers sont restreints intentionnellement. Marquez-les comme à conserver.
- Considérer le rapport comme complet. Il omet les liens Anyone et les membres des groupes SharePoint.
- Supprimer avant d’ajouter. Lorsque vous remplacez un utilisateur par un autre, ajoutez d’abord le nouveau.
- Accorder les accès personne par personne. Attribuez les autorisations via un groupe, et non à un utilisateur par élément. La prochaine revue en sera plus courte.
- Oublier le groupe Microsoft 365. Une personne peut conserver son accès par l’appartenance à un groupe, même après avoir nettoyé le site.
- Pas de journal et pas de second rapport. Sans eux, vous ne pouvez ni prouver la correction ni l’annuler.
Comment les logiciels peuvent aider
Commencez par les outils dont vous disposez déjà. Le rapport de partage du site et les rapports du centre d’administration vous fournissent les faits. PnP PowerShell effectue les modifications, et un tableur conserve les décisions et le journal.
Certains outils tiers regroupent le reporting et la correction sur un seul écran. C’est le cas de SharePoint Essentials Toolkit, de Cognillo. D’après la page produit de l’éditeur, cet outil génère des rapports d’autorisations pour les sites, les dossiers et les éléments, affiche tout ce à quoi un utilisateur peut accéder, remplace un utilisateur par un autre, et corrige les autorisations et les liens de partage à partir des rapports. L’éditeur indique également que les rapports et les tâches peuvent être planifiés et exportés. Ce sont les affirmations de l’éditeur, que M365.FM n’a pas testées. La méthode manuelle présentée plus haut fonctionne sans aucun de ces outils.
Déclaration d’intérêts : Cognillo sponsorise M365.FM.
Prochaine étape
Choisissez un site présentant un problème d’autorisations connu, exécutez le rapport de partage et ajoutez une colonne de décision au fichier CSV. Utilisez ensuite cette liste pour corriger les autorisations SharePoint en masse, d’abord sur une bibliothèque de test, et conservez le journal des opérations.