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

# OneDrive vorab bereitstellen

Das OneDrive dieses Benutzers vor der ersten Anmeldung anfordern

### Beschreibung

Fordert das OneDrive dieses Benutzers in SharePoint Online an, damit es vor der ersten Anmeldung verfügbar ist. Das Konto muss aktiviert sein und, wenn die Lizenzprüfung aktiviert ist, einen SharePoint-Dienstplan zugewiesen haben. Es wird nichts angefordert, wenn das OneDrive bereits existiert. SharePoint erstellt das OneDrive im Hintergrund, normalerweise innerhalb von Minuten und manchmal erst nach 24 Stunden, und der Lauf wartet nicht darauf.

### So funktioniert es

Bei jedem Lauf führt das Runbook Folgendes aus:

1. Stellt mit der verwalteten Identität des Automation-Kontos eine Verbindung zu Microsoft Graph und SharePoint Online (PnP PowerShell) her. Die URL des SharePoint admin centers wird automatisch von der Tenant-Root-Site abgeleitet.
2. Liest den ausgewählten Benutzer (`Benutzername`) aus Microsoft Entra ID und bricht ab, wenn das Konto nicht existiert oder ist **deaktivierten**.
3. Prüft optional, ob der Benutzer einen aktivierten **SharePoint** Dienstplan (siehe [Lizenzprüfung](#license-check)).
4. Prüft, ob das OneDrive des Benutzers bereits als aktive Site Collection existiert – falls ja, endet der Lauf, ohne eine Anforderung zu senden.
5. Sucht im Papierkorb des Tenants nach einem gelöschten OneDrive des Benutzers und zeigt eine Warnung an, wenn eines gefunden wird.
6. Stellt die OneDrive-Erstellung über `New-PnPPersonalSite` und gibt das Ergebnis aus.

Das Runbook wird aus dem Benutzerobjekt im RealmJoin-Portal gestartet, sodass der Benutzer immer vorab ausgewählt ist – es gibt keine Freitexteingabe.

#### Konto muss aktiviert sein

SharePoint erstellt ein OneDrive nur für Benutzer, die sich anmelden dürfen. Anfragen für blockierte Benutzer werden akzeptiert, aber stillschweigend ignoriert, was zu einer irreführenden Meldung "queued" führen würde. Das Runbook bricht daher mit einem Fehler ab, wenn `accountEnabled` ist `falsch`. Aktivieren Sie zuerst das Konto und führen Sie das Runbook dann erneut aus.

Eine Anmeldesperre, die durch **Conditional Access** verursacht wird, kann vom Runbook nicht erkannt werden.

#### Lizenzprüfung

Mit **Zuerst die SharePoint-Lizenz prüfen?** (`CheckSharePointLicense`(standardmäßig aktiviert) bricht das Runbook ab, wenn der Benutzer keinen aktivierten SharePoint-Dienstplan hat. Die Prüfung wertet die `assignedPlans`, sodass jede Lizenzquelle zählt:

* Microsoft 365 / Office 365-Suiten (z. B. E3, E5, F3, Business Standard)
* SharePoint Online Plan 1 / Plan 2 und eigenständige OneDrive-Pläne
* Direkte und gruppenbasierte Lizenzzuweisungen

Wenn die Prüfung deaktiviert ist, wird die Anforderung trotzdem in die Warteschlange gestellt – SharePoint erstellt das OneDrive jedoch nicht, solange keine SharePoint-Lizenz zugewiesen ist. Nachdem eine Lizenz zugewiesen wurde, lassen Sie etwas Zeit verstreichen, damit die Zuweisung wirksam wird, bevor Sie das Runbook ausführen.

#### Von Haus aus idempotent

* Wenn das OneDrive bereits als aktive Site Collection existiert, meldet das Runbook `AlreadyProvisioned` und sendet keine Anforderung.
* Das Senden einer Anforderung für einen Benutzer, der bereits über ein OneDrive verfügt, ist unbedenklich – SharePoint ignoriert sie.

#### Gelöschtes OneDrive im Papierkorb

Wenn im Papierkorb des Tenants ein gelöschtes OneDrive des Benutzers (über den Websitebesitzer abgeglichen) gefunden wird, zeigt das Runbook eine Warnung mit der URL und dem Löschzeitpunkt an. Die Wiederherstellung des vorhandenen OneDrive kann besser sein als das Erstellen eines neuen, leeren OneDrive. Die Warnung stoppt den Lauf nicht.

#### Asynchrone Bereitstellung

Das Runbook stellt nur **in die Warteschlange** die Anforderung. Das OneDrive wird später durch einen SharePoint-Zeitjob erstellt. Dies dauert normalerweise einige Minuten, kann aber bis zu 24 Stunden oder länger dauern. Das Runbook wartet nicht auf den Abschluss – verwenden Sie das Runbook **OneDrive-Status prüfen** (Org \ Collab), um das Ergebnis zu überprüfen.

Das Runbook gibt ein Objekt mit `UserPrincipalName`, `Status` (`AlreadyProvisioned` oder `ProvisioningRequested`), `OneDriveUrl` und `RequestedAt` (UTC).

#### Voraussetzungen

Die Berechtigungen für die **Office 365 SharePoint Online** API können nicht durch die automatische Berechtigungseinrichtung für Microsoft Graph zugewiesen werden. Gewähren Sie sie einmal pro Tenant der systemseitig zugewiesenen verwalteten Identität des Automation-Kontos vor dem ersten Lauf.

### Ort

Benutzer → Collab → OneDrive vorab bereitstellen

**Vollständiger Runbook-Name**

rjgit-user\_collab\_pre-provision-onedrive

### Details

| Eigenschaft          | Wert                                                                                                                  |
| -------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Version              | 1.0.1                                                                                                                 |
| Erforderliche Module | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>PnP.PowerShell (>= 3.4.1)</p> |
| Planbar              | nein                                                                                                                  |

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * Sites.Read.All
    * *Liest die Tenant-Root-Site (/sites/root), um die von Connect-PnPOnline verwendete URL des SharePoint admin centers abzuleiten.*
  * User.Read.All
    * *Liest den ausgewählten Benutzer (accountEnabled, userPrincipalName, assignedPlans), um zu überprüfen, dass das Konto aktiviert ist und, optional, dass vor dem Senden der Bereitstellungsanforderung ein aktivierter SharePoint-Dienstplan zugewiesen ist.*
* **Typ**: Office 365 SharePoint Online
  * Sites.FullControl.All
    * *Erforderlich für Connect-PnPOnline gegen das SharePoint admin center und für die tenant-admin-Cmdlets Get-PnPTenantSite, Get-PnPTenantDeletedSite und New-PnPPersonalSite, die OneDrive-Personalsites, den Papierkorb des Tenants überprüfen und die OneDrive-Erstellung in die Warteschlange stellen; niedrigere Site-Scopes reichen für den tenant-admin-Endpunkt nicht aus.*
  * User.ReadWrite.All
    * *Von PnP PowerShell als erforderlich für New-PnPPersonalSite mit Anwendungsberechtigungen (Benutzerprofildienst) dokumentiert; deckt außerdem das Lesen der PersonalUrl über Get-PnPUserProfileProperty ab.*

#### Hinweise zu Berechtigungen

SharePoint Online: Gewähren Sie die Anwendungsberechtigungen 'Sites.FullControl.All' und 'User.ReadWrite.All' auf der Office 365 SharePoint Online-API (AppId 00000003-0000-0ff1-ce00-000000000000) der systemseitig zugewiesenen verwalteten Identität des Automation-Kontos. Diese SharePoint-App-only-Berechtigung kann nicht über die standardmäßige Entra-App-Rollen-Zuweisungsautomatisierung erfolgen, die für Microsoft Graph verwendet wird, und muss pro Tenant manuell zugewiesen werden.

### Parameter

#### Benutzername

Der Benutzerprinzipalname des Benutzers, für den das Runbook ausgeführt wird. Vom Portal anhand des ausgewählten Benutzers festgelegt.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | wahr                                         |
| Standardwert           |                                              |
| Typ                    | Zeichenfolge                                 |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

#### CheckSharePointLicense

Wenn aktiviert, stoppt das Runbook, wenn dieser Benutzer aus keiner Lizenz einen aktivierten SharePoint-Dienstplan hat, der direkt oder über eine Gruppe zugewiesen wurde. Wenn deaktiviert, wird die Anforderung trotzdem gesendet, aber SharePoint erstellt das OneDrive erst, wenn eine Lizenz zugewiesen wurde.

| Eigenschaft           | Wert                                 |
| --------------------- | ------------------------------------ |
| Erforderlich          | falsch                               |
| Standardwert          | Wahr                                 |
| Typ                   | Boolesch                             |
| Anzeigename im Portal | Zuerst die SharePoint-Lizenz prüfen? |

[Zur Übersicht der Runbook-Referenz zurück](https://docs.realmjoin.com/de/automatisierung/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/de/automatisierung/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.
