> 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/fr/automatisation/runbooks/runbook-references/user/collab/pre-provision-onedrive.md).

# Préprovisionner OneDrive

Demander le OneDrive de cet utilisateur avant la première connexion

### Description

Demande le OneDrive de cet utilisateur dans SharePoint Online afin qu'il soit disponible avant la première connexion. Le compte doit être activé et, lorsque la vérification de licence est activée, disposer d'un plan de service SharePoint attribué. Rien n'est demandé si le OneDrive existe déjà. SharePoint crée le OneDrive en arrière-plan, généralement en quelques minutes et parfois seulement après 24 heures, et l'exécution n'attend pas sa création.

### Fonctionnement

À chaque exécution, le runbook :

1. Se connecte à Microsoft Graph et à SharePoint Online (PnP PowerShell) avec l'identité managée attribuée au compte Automation. L'URL du centre d'administration SharePoint est dérivée automatiquement à partir du site racine du tenant.
2. Lit l'utilisateur sélectionné (`UserName`) depuis Microsoft Entra ID et s'arrête si le compte n'existe pas ou est **désactivés**.
3. Vérifie éventuellement que l'utilisateur dispose d'un **SharePoint** plan de service (voir [Vérification de licence](#license-check)).
4. Vérifie si le OneDrive de l'utilisateur existe déjà en tant que collection de sites active - si c'est le cas, l'exécution se termine sans envoyer de demande.
5. Recherche un OneDrive supprimé de l'utilisateur dans la corbeille du tenant et affiche un avertissement si l'un est trouvé.
6. Planifie la création du OneDrive via `New-PnPPersonalSite` et affiche le résultat.

Le runbook est lancé à partir de l'objet utilisateur dans le portail RealmJoin, de sorte que l'utilisateur est toujours présélectionné - il n'y a aucune saisie libre.

#### Le compte doit être activé

SharePoint ne crée un OneDrive que pour les utilisateurs autorisés à se connecter. Les demandes pour les utilisateurs bloqués sont acceptées mais ignorées silencieusement, ce qui entraînerait un message trompeur « en file d'attente ». Le runbook s'interrompt donc avec une erreur lorsque `accountEnabled` est `false`. Activez d'abord le compte et relancez le runbook.

Un blocage de connexion imposé par **Conditional Access** ne peut pas être détecté par le runbook.

#### Vérification de licence

Avec **Vérifier d'abord la licence SharePoint ?** (`CheckSharePointLicense`, activée par défaut) le runbook s'interrompt lorsque l'utilisateur n'a aucun plan de service SharePoint activé. La vérification évalue les `assignedPlans`, donc chaque source de licence compte :

* Suites Microsoft 365 / Office 365 (p. ex. E3, E5, F3, Business Standard)
* Plans autonomes SharePoint Online Plan 1 / Plan 2 et OneDrive
* Attributions de licences directes et basées sur les groupes

Si la vérification est désactivée, la demande est quand même mise en file d'attente - mais SharePoint ne créera pas le OneDrive tant qu'aucune licence SharePoint n'est attribuée. Après l'attribution d'une licence, laissez un certain temps à l'attribution pour prendre effet avant d'exécuter le runbook.

#### Conçu pour être idempotent

* Si le OneDrive existe déjà en tant que collection de sites active, le runbook renvoie `AlreadyProvisioned` et n'envoie aucune demande.
* Envoyer une demande pour un utilisateur qui possède déjà un OneDrive est sans danger - SharePoint l'ignore.

#### OneDrive supprimé dans la corbeille

Si un OneDrive supprimé de l'utilisateur (correspondant au propriétaire du site) est trouvé dans la corbeille du tenant, le runbook affiche un avertissement avec l'URL et l'heure de suppression. Restaurer le OneDrive existant peut être préférable à la création d'un nouveau OneDrive vide. L'avertissement n'interrompt pas l'exécution.

#### Provisionnement asynchrone

Le runbook se contente de **mettre en file d'attente** la demande ; le OneDrive est créé plus tard par un travail de minuterie SharePoint. Cela prend généralement quelques minutes, mais peut prendre jusqu'à 24 heures ou plus. Le runbook n'attend pas la fin - utilisez le runbook **Vérifier l’état de OneDrive** (Org \\\ Collab) pour vérifier le résultat.

Le runbook renvoie un objet avec `UserPrincipalName`, `Statut` (`AlreadyProvisioned` ou `ProvisioningRequested`), `OneDriveUrl` et `RequestedAt` (UTC).

#### Prérequis

Les autorisations sur l' **Office 365 SharePoint Online** API ne peuvent pas être attribuées par la configuration automatique des autorisations pour Microsoft Graph. Accordez-les une seule fois par tenant à l'identité managée attribuée par le système du compte Automation avant la première exécution.

### Emplacement

Utilisateur → Collab → Préprovisionnement du OneDrive

**Nom complet du runbook**

rjgit-user\_collab\_pre-provision-onedrive

### Détails

| Propriété      | Valeur                                                                                                                |
| -------------- | --------------------------------------------------------------------------------------------------------------------- |
| Version        | 1.0.1                                                                                                                 |
| Modules requis | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>PnP.PowerShell (>= 3.4.1)</p> |
| Planifiable    | non                                                                                                                   |

### Autorisations

#### Autorisations d'application

* **Type**: Microsoft Graph
  * Sites.Read.All
    * *Lit le site racine du tenant (/sites/root) pour déduire l'URL du centre d'administration SharePoint utilisée par Connect-PnPOnline.*
  * User.Read.All
    * *Lit l'utilisateur sélectionné (accountEnabled, userPrincipalName, assignedPlans) pour vérifier que le compte est activé et, éventuellement, qu'un plan de service SharePoint activé est attribué avant l'envoi de la demande de provisionnement.*
* **Type**: Office 365 SharePoint Online
  * Sites.FullControl.All
    * *Requis par Connect-PnPOnline auprès du centre d'administration SharePoint et par les cmdlets d'administration du tenant Get-PnPTenantSite, Get-PnPTenantDeletedSite et New-PnPPersonalSite, qui inspectent les sites personnels OneDrive, la corbeille du tenant et mettent en file d'attente la création du OneDrive ; des étendues de site inférieures ne suffisent pas pour le point de terminaison d'administration du tenant.*
  * User.ReadWrite.All
    * *Documenté par PnP PowerShell comme requis pour New-PnPPersonalSite avec des autorisations d'application (service de profil utilisateur) ; couvre également la lecture de PersonalUrl via Get-PnPUserProfileProperty.*

#### Remarques sur les autorisations

SharePoint Online : accordez les autorisations d'application 'Sites.FullControl.All' et 'User.ReadWrite.All' sur l'API Office 365 SharePoint Online (AppId 00000003-0000-0ff1-ce00-000000000000) à l'identité managée attribuée par le système du compte Automation. Cette attribution d'application uniquement pour SharePoint ne peut pas être effectuée via l'automatisation standard d'attribution de rôles d'application Entra utilisée pour Microsoft Graph et doit être attribuée manuellement par tenant.

### Paramètres

#### UserName

Nom principal de l'utilisateur sur lequel le runbook agit. Défini par le portail à partir de l'utilisateur sélectionné.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | vrai                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### CheckSharePointLicense

Lorsque cette option est activée, le runbook s'arrête si cet utilisateur ne dispose d'aucun plan de service SharePoint activé issu d'une licence, attribué directement ou via un groupe. Lorsqu'elle est désactivée, la demande est quand même envoyée, mais SharePoint ne crée le OneDrive qu'une fois qu'une licence est attribuée.

| Propriété                  | Valeur                                   |
| -------------------------- | ---------------------------------------- |
| Obligatoire                | false                                    |
| Valeur par défaut          | Vrai                                     |
| Type                       | Booléen                                  |
| Nom d'affichage du portail | Vérifier d'abord la licence SharePoint ? |

[Retour à l'aperçu de la référence du runbook](https://docs.realmjoin.com/fr/automatisation/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/fr/automatisation/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.
