Corrige los permisos de SharePoint en lote a partir de un informe, no elemento por elemento
Disclosure: Cognillo sponsors M365.FM. This page describes the company factually; paid partnerships and links are labelled as advertising.
Por Mirko Peters · · Actualizado
Corrige los permisos de SharePoint en lote: exporta un informe, marca cada fila como conservar, quitar o restablecer, prueba primero un script de PnP PowerShell en un solo sitio y, después, verifica el resultado.
Traducido automáticamente con IA a partir de la publicación original. Lee el original en inglés
Para corregir los permisos de SharePoint en lote, exportas un informe de quién tiene acceso, marcas cada fila como conservar, quitar o restablecer y, después, ejecutas un script que lee tus decisiones. Esta guía va dirigida a administradores de SharePoint que se enfrentan a cientos de elementos con permisos únicos y no quieren hacer clic en cada uno por separado. Verás cómo crear la lista de decisiones, qué cmdlets de PnP PowerShell hacen el trabajo, qué deja fuera el informe de Microsoft, y cómo probar, registrar y comprobar una ejecución. Un ejemplo práctico con cifras ficticias muestra el ciclo completo.
Puntos clave
- Para corregir los permisos de SharePoint en lote, parte de un informe: cada cambio de un script debe poder rastrearse hasta una fila que una persona haya marcado como conservar, quitar o restablecer.
- El informe de uso compartido del sitio de Microsoft enumera cada archivo, usuario, permiso y vínculo único, pero deja fuera los vínculos de Cualquier persona y las personas individuales dentro de los grupos de SharePoint.
- Tres cmdlets de PnP PowerShell cubren la mayoría de las correcciones en lote: Remove-PnPGroupMember, Set-PnPListItemPermission y Remove-PnPSiteCollectionAdmin.
- Restablecer un elemento para heredar los permisos de su lista elimina sus permisos únicos y, a menudo, es la solución más limpia para la acumulación de permisos.
- Prueba el script en un solo sitio, lleva un registro de cada cambio y ejecuta un segundo informe después para demostrar que el problema ha desaparecido.
Por qué fallan las correcciones elemento por elemento
La mayoría de los problemas de permisos de SharePoint se acumulan poco a poco. Alguien comparte un archivo con un compañero. Otra persona decide romper la herencia de permisos en una carpeta para un proyecto que terminó hace mucho tiempo. Con los años, algunas bibliotecas de documentos acumulan cientos de elementos con permisos únicos, y nadie sabe cuáles siguen siendo importantes.
Corregir estos casos uno a uno tiene tres problemas. Es lento. Es fácil pasar por alto elementos. Y no deja constancia de lo que cambiaste, así que no puedes deshacer un error ni responder a una auditoría.
Una corrección en lote invierte el orden. Primero reúnes los datos en un informe. Después decide una persona. Solo entonces actúa un script, y lo hace únicamente sobre las filas que tienen una decisión. Así se conserva la velocidad de la automatización y el cuidado de una revisión manual.
Cómo corregir los permisos de SharePoint en lote: cinco pasos
Sigue estos pasos en orden.
- Exporta los datos. Crea un informe del sitio. La guía de Microsoft sobre el informe de uso compartido de archivos y carpetas indica que un administrador del sitio lo ejecuta desde Configuración, Uso del sitio, en la sección Compartido con usuarios externos, con Ejecutar informe. Eliges dónde guardar el CSV y recibes un correo cuando termina.
- Añade una columna de decisión. Abre el CSV en Excel y añade una columna con tres valores permitidos: conservar, quitar y restablecer. Añade una segunda columna para el motivo. Pide al propietario del sitio que revise las filas que tú no puedas valorar.
- Escribe el script en torno a las decisiones. Lee el archivo con
Import-Csv, recorre las filas y ejecuta un cmdlet por tipo de decisión. Omite cada fila que no tenga decisión. - Prueba primero en un sitio y luego en una biblioteca. Ejecuta el script en un sitio de prueba o en una única biblioteca antes que nada. Compara el resultado con lo que esperabas.
- Comprueba con un segundo informe. Después de la ejecución real, vuelve a crear el informe. Las filas que eliminaste deberían haber desaparecido, y las que conservaste deberían seguir igual.
No omitas el paso 2. Un script es tan seguro como la lista que lee.
Cómo funciona la herencia de permisos antes de restablecer nada
La página de soporte de Microsoft sobre personalizar permisos para una lista o biblioteca de SharePoint explica que las carpetas, listas y documentos normalmente heredan los permisos del sitio que los contiene. Para dar a una lista o biblioteca sus propios permisos, un propietario elige Dejar de heredar permisos, y los elementos que contiene pasan a heredar la nueva configuración. Para volver atrás, la pestaña Permisos ofrece Eliminar permisos únicos, que quita los permisos personalizados que configuraste.
Tres advertencias de la misma página son importantes para el trabajo masivo:
- El límite de 100 000 elementos. No puedes romper ni restaurar la herencia en una lista, biblioteca o carpeta que contenga más de 100 000 elementos. Aun así, en una biblioteca grande sí puedes romper la herencia de un único archivo.
- Eliminar un usuario afecta a los elementos secundarios. Quitar un usuario o grupo también lo elimina de los elementos secundarios, incluidos los que tienen la herencia rota, y no es posible restaurarlo. Revisa tu registro antes de ejecutar una eliminación.
- El acceso limitado permanece. Una persona con la que solo se compartió un elemento obtiene acceso limitado al sitio, y dejar de compartir el elemento no le quita ese acceso.
Microsoft recomienda los grupos de SharePoint y considera que los permisos a nivel de elemento son compatibles dentro de un uso razonable. Nuestra regla práctica es asignar el acceso mediante un grupo, no a usuarios individuales, para que los permisos del sitio sigan siendo legibles y queden menos permisos únicos por corregir.
¿Qué cmdlet soluciona cada problema?
PnP PowerShell tiene cmdlets para la mayoría de las correcciones masivas. Estos tres son los que más aparecen.
Quitar a una persona de un grupo de SharePoint. La referencia de Remove-PnPGroupMember muestra la sintaxis: Remove-PnPGroupMember -LoginName user@company.com -Group 'Marketing Site Members'. Úsalo para problemas de pertenencia a grupos, como un empleado que ya no está en la empresa pero sigue en un grupo de miembros.
Cambiar o restablecer permisos de un elemento. La referencia de Set-PnPListItemPermission enumera estas opciones:
-AddRoley-RemoveRoleañaden o quitan un nivel de permiso para un usuario o un grupo en un elemento. UsaGet-PnPRoleDefinitionpara ver los roles disponibles.-ClearExistingelimina todos los permisos existentes del elemento antes de añadir el nuevo rol.-InheritPermissionsrestablece el elemento para que herede los permisos de su lista y elimina sus permisos únicos.-SystemUpdatecambia los permisos sin crear una nueva versión ni activar Power Automate.
Restablecer suele ser la solución más limpia. Si un elemento solo tiene permisos únicos porque alguien lo compartió una vez, restablecerlo lo devuelve a las reglas de la biblioteca.
Quitar a un administrador de colección de sitios. La referencia de Remove-PnPSiteCollectionAdmin muestra Remove-PnPSiteCollectionAdmin -Owners "user@contoso.onmicrosoft.com". Los administradores que no nombres conservan su acceso. También se puede pasar una lista de usuarios.
Para sustituir a un usuario por otro, ejecuta dos pasos: añade a la nueva persona donde tenía acceso la anterior y, después, quita a la persona anterior. Haz primero la adición, para que nadie pierda el acceso en medio.
Lo que el informe no muestra
Un informe es un punto de partida, no la verdad completa. La página de informes de uso compartido de Microsoft indica lo que excluye el CSV:
- Los usuarios individuales dentro de grupos de SharePoint. El grupo aparece, pero no sus miembros.
- Los enlaces que se enviaron por correo electrónico pero que nunca se abrieron.
- Los enlaces para cualquier persona (anónimos).
Esto tiene consecuencias reales. Si tu objetivo es averiguar dónde tiene acceso una persona, el informe mostrará el grupo, así que tienes que revisar los miembros del grupo por separado. Si tu objetivo es eliminar el uso compartido público, el informe no enumerará en absoluto los vínculos de "Cualquier persona", así que necesitas otra fuente, como los informes de gobernanza del acceso a los datos del Centro de administración de SharePoint. Según Microsoft, esos informes requieren SharePoint Advanced Management.
En el caso de un único sitio de SharePoint en SharePoint Online, revisa también los permisos del sitio y los niveles de permiso en uso en Configuración del sitio antes de tocar cualquier elemento. Después, consulta las opciones de informes de SharePoint para todo el inquilino, no solo para un sitio. Un CSV por sitio no escala a cientos de sitios.
En los sitios conectados a un grupo de Microsoft 365, la pertenencia al grupo se gestiona a través del grupo, no en los grupos propios del sitio. Un script que edite los grupos del sitio no solucionará el caso de una persona que forma parte del grupo de Microsoft 365.
Haz que el script sea seguro de ejecutar
Un script masivo puede causar mucho daño en poco tiempo. Antes de la primera ejecución real, incorpora estas protecciones:
- Añade un modo de simulación. Tu script puede aceptar un parámetro
-DryRunque muestre cada acción planificada sin realizar ningún cambio. Revisa esa salida con el propietario del sitio. - Registra antes de cambiar. Para cada fila, escribe primero en el registro el estado anterior: la ruta del elemento, el usuario y el nivel de permiso, como Control total, Edición o Lectura. Ese registro es tu forma de volver atrás.
- Trabaja por lotes. Ejecuta 50 elementos, compruébalos y después ejecuta los siguientes 500. Un primer lote pequeño detecta pronto una suposición errónea.
- Conserva el informe original. Guarda el CSV con tus decisiones y el registro en una carpeta a la que solo puedan acceder los propietarios del sitio. Microsoft recomienda lo mismo para el propio informe, porque enumera quién tiene acceso a qué.
- Cambia la pertenencia a grupos en una ejecución aparte. Corrige los permisos de los elementos en una ejecución y la pertenencia a grupos en otra, para poder comprobar cada tipo de cambio por separado.
Ejemplo: limpieza de una biblioteca de documentos
Las cifras son ficticias.
Un sitio de proyecto tiene una biblioteca de documentos. El informe tiene 620 filas. Tras ordenarlas, un administrador y el propietario del sitio las marcan:
- 410 filas: conservar. Son los permisos normales basados en grupos.
- 150 filas: restablecer. Son archivos individuales con permisos únicos heredados de comparticiones antiguas.
- 40 filas: eliminar. Dan acceso directo a un antiguo contratista.
- 20 filas: no está claro. Se devuelven al propietario con una pregunta.
El administrador escribe un script con dos ramas. La rama de restablecimiento ejecuta Set-PnPListItemPermission con -InheritPermissions para cada archivo. La rama de eliminación ejecuta Remove-PnPGroupMember para el contratista en los grupos en los que aparece. El script escribe una línea de registro por acción: la fecha, el elemento, el estado anterior y el nuevo estado.
Primero, el administrador ejecuta el script en una copia de la biblioteca con 20 filas. El resultado coincide con el plan. La ejecución completa dura una tarde. Un segundo informe muestra 410 más 20 filas, que es lo que el administrador esperaba. El registro se guarda junto al informe, para que cualquiera pueda ver qué ocurrió.
Errores comunes
- Ejecutar un script sin una lista de decisiones. Después no podrás explicar por qué cambió un elemento.
- Restablecer la herencia en una biblioteca donde los permisos únicos son intencionados. Algunas carpetas están restringidas a propósito. Márcalas para conservar.
- Dar por completo el informe. No incluye los vínculos de "Cualquier persona" ni los miembros de los grupos de SharePoint.
- Eliminar antes de añadir. Cuando sustituyas a un usuario por otro, añade primero el nuevo.
- Conceder acceso persona por persona. Asigna los permisos a través de un grupo, no a un usuario por elemento, para que la próxima revisión sea más corta.
- Olvidar el grupo de Microsoft 365. Una persona puede conservar el acceso mediante la pertenencia a un grupo incluso después de limpiar el sitio.
- No tener registro ni segundo informe. Sin ellos, no puedes demostrar la corrección ni deshacerla.
Cómo puede ayudar el software
Empieza con las herramientas que ya tienes. El informe de uso compartido del sitio y los informes del Centro de administración te dan los datos. PnP PowerShell realiza los cambios, y una hoja de cálculo guarda las decisiones y el registro.
Algunas herramientas de terceros combinan los informes y las correcciones en una misma pantalla. Un ejemplo es el SharePoint Essentials Toolkit de Cognillo. Según la página de producto del proveedor, ofrece informes de permisos para sitios, carpetas y elementos, muestra todo a lo que puede acceder una persona, sustituye a un usuario por otro y corrige los permisos y los vínculos para compartir a partir de los informes. El proveedor también indica que los informes y las tareas se pueden programar y exportar. Son afirmaciones del proveedor y M365.FM no las ha probado. La ruta manual descrita arriba funciona sin ninguna de estas herramientas.
Aviso: Cognillo patrocina M365.FM.
Siguiente paso
Elige un sitio con un problema de permisos conocido, ejecuta el informe de uso compartido y añade una columna de decisión al CSV. Después, usa esa lista para corregir los permisos de SharePoint en bloque, primero en una biblioteca de pruebas, y guarda el registro.