For the complete documentation index, see llms.txt. This page is also available as Markdown.

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:

  1. 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.

  2. Lee el usuario seleccionado (Nombre de usuario) de Microsoft Entra ID y se detiene si la cuenta no existe o está deshabilitados.

  3. Opcionalmente verifica que el usuario tenga un SharePoint plan de servicio (véase Comprobación de licencia).

  4. 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.

  5. Busca un OneDrive eliminado del usuario en la papelera de reciclaje del Tenant y muestra una advertencia si encuentra uno.

  6. Encola la creación del OneDrive mediante New-PnPPersonalSite y 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 AlreadyProvisioned y 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

Propiedad
Valor

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.

Propiedad
Valor

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.

Propiedad
Valor

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?