> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-references/user/collab/pre-provision-onedrive.md).

# 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](#license-check)).
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 | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>PnP.PowerShell (>= 3.4.1)</p> |
| 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? |

[Volver al resumen de referencia de Runbook](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-references.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-references/user/collab/pre-provision-onedrive.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
