Preaprovisionar OneDrive
Solicitar el OneDrive de este usuario antes del primer inicio de sesión
Descripción
Solicita el OneDrive de este usuario en SharePoint Online para que esté disponible antes del primer inicio de sesión. La cuenta debe estar habilitada y, cuando la comprobación de licencia está activada, tener asignado un plan de servicio de SharePoint. No se solicita nada si el OneDrive ya existe. SharePoint crea el OneDrive en segundo plano, normalmente en minutos y a veces solo después de 24 horas, y la ejecución no espera a que finalice.
Cómo funciona
En cada ejecución, el runbook:
Se conecta a Microsoft Graph y SharePoint Online (PnP PowerShell) con la identidad administrada de la cuenta de Automation. La URL del centro de administración de SharePoint se deriva automáticamente del sitio raíz del Tenant.
Lee el usuario seleccionado (
Nombre de usuario) de Microsoft Entra ID y se detiene si la cuenta no existe o está deshabilitados.Opcionalmente verifica que el usuario tenga un SharePoint plan de servicio (véase Comprobación de licencia).
Comprueba si el OneDrive del usuario ya existe como una colección de sitios activa; si es así, la ejecución finaliza sin enviar una solicitud.
Busca un OneDrive eliminado del usuario en la papelera de reciclaje del Tenant y muestra una advertencia si encuentra uno.
Encola la creación del OneDrive mediante
New-PnPPersonalSitey muestra el resultado.
El runbook se inicia desde el objeto de usuario en el portal de RealmJoin, por lo que el usuario siempre está preseleccionado; no hay entrada de texto libre.
La cuenta debe estar habilitada
SharePoint solo crea un OneDrive para usuarios a los que se les permite iniciar sesión. Las solicitudes para usuarios bloqueados se aceptan, pero se ignoran silenciosamente, lo que daría como resultado un mensaje engañoso de "en cola". Por lo tanto, el runbook se interrumpe con un error cuando accountEnabled esté falso. Habilite primero la cuenta y ejecute el runbook de nuevo.
Un bloqueo de inicio de sesión impuesto por Conditional Access no puede ser detectado por el runbook.
Comprobación de licencia
Con ¿Comprobar primero la licencia de SharePoint? (CheckSharePointLicense, habilitado de forma predeterminada) el runbook se interrumpe cuando el usuario no tiene ningún plan de servicio de SharePoint habilitado. La comprobación evalúa los assignedPlans, por lo que cuenta cualquier origen de licencia:
Las suites de Microsoft 365 / Office 365 (p. ej., E3, E5, F3, Business Standard)
SharePoint Online Plan 1 / Plan 2 y los planes independientes de OneDrive
Asignaciones de licencias directas y basadas en grupos
Si la comprobación está deshabilitada, la solicitud se pone en cola de todos modos, pero SharePoint no creará el OneDrive mientras no se asigne ninguna licencia de SharePoint. Después de asignar una licencia, espere un tiempo a que la asignación surta efecto antes de ejecutar el runbook.
Idempotente por diseño
Si el OneDrive ya existe como una colección de sitios activa, el runbook informa
AlreadyProvisionedy no envía ninguna solicitud.Enviar una solicitud para un usuario que ya tiene un OneDrive no es perjudicial; SharePoint la ignora.
OneDrive eliminado en la papelera de reciclaje
Si se encuentra un OneDrive eliminado del usuario (coincidente con el propietario del sitio) en la papelera de reciclaje del Tenant, el runbook muestra una advertencia con la URL y la hora de eliminación. Restaurar el OneDrive existente puede ser preferible a crear uno nuevo y vacío. La advertencia no detiene la ejecución.
Aprovisionamiento asincrónico
El runbook solo pone en cola la solicitud; el OneDrive se crea más tarde mediante un trabajo de temporizador de SharePoint. Esto normalmente tarda unos minutos, pero puede tardar hasta 24 horas o más. El runbook no espera a que termine; use el runbook Comprobar estado de OneDrive (Org \ Collab) para verificar el resultado.
El runbook devuelve un objeto con UserPrincipalName, Estado (AlreadyProvisioned o ProvisioningRequested), OneDriveUrl y RequestedAt (UTC).
Requisitos previos
Los permisos en la Office 365 SharePoint Online API no pueden asignarse mediante la configuración automática de permisos para Microsoft Graph. Concédalos una vez por Tenant a la identidad administrada asignada por el sistema de la cuenta de Automation antes de la primera ejecución.
Ubicación
Usuario → Collab → Preaprovisionar OneDrive
Nombre completo del runbook
rjgit-user_collab_pre-provision-onedrive
Detalles
Versión
1.0.1
Módulos requeridos
RealmJoin.RunbookHelper (>= 0.8.10) Microsoft.Graph.Authentication (>= 2.41.2) PnP.PowerShell (>= 3.4.1)
Programable
no
Permisos
Permisos de aplicación
Tipo: Microsoft Graph
Sites.Read.All
Lee el sitio raíz del Tenant (/sites/root) para derivar la URL del centro de administración de SharePoint que usa Connect-PnPOnline.
User.Read.All
Lee el usuario seleccionado (accountEnabled, userPrincipalName, assignedPlans) para verificar que la cuenta está habilitada y, opcionalmente, que se haya asignado un plan de servicio de SharePoint habilitado antes de enviar la solicitud de aprovisionamiento.
Tipo: Office 365 SharePoint Online
Sites.FullControl.All
Requerido por Connect-PnPOnline contra el centro de administración de SharePoint y por los cmdlets de administrador del Tenant Get-PnPTenantSite, Get-PnPTenantDeletedSite y New-PnPPersonalSite, que inspeccionan los sitios personales de OneDrive, la papelera de reciclaje del Tenant y encolan la creación de OneDrive; los ámbitos de sitio inferiores no son suficientes para el extremo de administrador del Tenant.
User.ReadWrite.All
PnP PowerShell documenta que es necesario para New-PnPPersonalSite con permisos de aplicación (servicio de perfil de usuario); también cubre la lectura de PersonalUrl mediante Get-PnPUserProfileProperty.
Notas sobre permisos
SharePoint Online: conceda los permisos de aplicación 'Sites.FullControl.All' y 'User.ReadWrite.All' en la API de Office 365 SharePoint Online (AppId 00000003-0000-0ff1-ce00-000000000000) a la identidad administrada asignada por el sistema de la cuenta de Automation. Esta concesión de solo aplicación de SharePoint no puede realizarse mediante la automatización estándar de asignación de roles de aplicación de Entra usada para Microsoft Graph y debe asignarse manualmente por Tenant.
Parámetros
Nombre de usuario
Nombre principal de usuario del usuario sobre el que actúa el runbook. Lo establece el portal a partir del usuario seleccionado.
Obligatorio
true
Valor predeterminado
Tipo
Cadena
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
CheckSharePointLicense
Cuando está habilitado, el runbook se detiene si este usuario no tiene ningún plan de servicio de SharePoint habilitado de ninguna licencia, asignado directamente o por grupo. Cuando está deshabilitado, la solicitud se envía de todos modos, pero SharePoint crea el OneDrive solo cuando se asigna una licencia.
Obligatorio
falso
Valor predeterminado
Verdadero
Tipo
Booleano
Nombre para mostrar en el portal
¿Comprobar primero la licencia de SharePoint?
Última actualización
¿Te fue útil?