Enumerar permisos de la colección de sitios de SharePoint

Enumerar los administradores y miembros de un sitio de SharePoint

Descripción

Muestra quién tiene acceso a una colección de sitios de SharePoint Online: los administradores de la colección de sitios y los miembros de los grupos Owners, Members y Visitors. Cada entrada muestra su tipo, como usuario, grupo de Entra ID, grupo de seguridad o grupo de SharePoint. No se modifica nada.

Comportamiento del parámetro

• SiteUrl debe apuntar a la raíz de una colección de sitios (por ejemplo https://contoso.sharepoint.com/sites/marketing), no a un subsitio. Una URL de subsitio aún devuelve resultados, pero estos describen la colección de sitios principal; el runbook registra una advertencia cuando esto sucede.
• Los grupos Owners, Members y Visitors se resuelven mediante las propiedades de grupos asociados del sitio, no comparando los nombres localizados de los grupos, por lo que el informe es exacto independientemente del idioma del Tenant. Cualquiera de los tres grupos puede estar ausente (algo habitual en los sitios conectados a Teams) y, en ese caso, se informa como "no configurado" en lugar de provocar un error.

Ubicación

Organización → Colab → Enumerar permisos de la colección de sitios de SharePoint

Nombre completo del runbook

rjgit-org_collab_list-sharepoint-sitecollection-permission

Detalles

Propiedad	Valor
Versión	1.2.0
Módulos requeridos	RealmJoin.RunbookHelper (>= 0.8.9) PnP.PowerShell (>= 3.4.1)
Programable	no

Permisos

Permisos de aplicación

• Tipo: Office 365 SharePoint Online

  • Sites.FullControl.All

    • Conecta mediante Connect-PnPOnline -ManagedIdentity y llama a Get-PnPWeb, Get-PnPSite, Get-PnPSiteCollectionAdmin y Get-PnPGroupMember contra la colección de sitios de destino; Get-PnPSiteCollectionAdmin, en particular, requiere más que acceso de solo lectura al sitio, por lo que Sites.Read.All no es suficiente. No se usó Sites.Selected porque requeriría que el consentimiento por sitio se concediera previamente fuera del control de este runbook, algo que este runbook no puede garantizar para un $SiteUrl arbitrario.

Notas sobre permisos

Concede consentimiento de administrador para el permiso de aplicación 'Sites.FullControl.All' en la API de Office 365 SharePoint Online (Id. de aplicación 00000003-0000-0ff1-ce00-000000000000) a la identidad administrada asignada por el sistema de la cuenta de Azure Automation; este consentimiento de SharePoint solo para aplicación mediante identidad administrada no puede asignarse a través de la automatización estándar de roles de aplicación de Microsoft Graph utilizada para permisos de Graph. Consulta el archivo de documentación del runbook para los comandos de asignación.

Parámetros

SiteUrl

URL completa del sitio, por ejemplo https://contoso.sharepoint.com/sites/marketing.

Propiedad	Valor
Requerido	verdadero
Valor predeterminado
Tipo	Cadena
Nombre para mostrar en el portal	URL de la colección de sitios

Volver a la vista general de la referencia del runbook