> 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/org/collab/check-onedrive-status.md).

# OneDrive-Status prüfen

Prüfen, ob OneDrive eines Benutzers aktiv, gesperrt oder gelöscht ist

### Beschreibung

Sucht die persönliche OneDrive-Website eines Benutzers und meldet, ob sie aktiv oder archiviert ist, ob sie gesperrt ist und ob sie sich im Tenant-Papierkorb befindet. Funktioniert auch für Benutzer, deren Konto bereits gelöscht wurde, da sich deren OneDrive möglicherweise noch im Papierkorb befindet. Es werden keine Änderungen vorgenommen.

### Häufige Anwendungsfälle

* Prüft, ob das OneDrive eines aktiven Benutzers bereitgestellt ist und, falls ja, ob es gesperrt oder archiviert ist.
* Prüft, ob das OneDrive eines gelöschten Benutzers noch im Tenant-Papierkorb vorhanden ist und wann es endgültig gelöscht werden soll.

### Parameterverhalten

* `UserPrincipalName` akzeptiert die UPN eines bereits gelöschten Kontos, nicht nur von aktiven Benutzern. Das ist beabsichtigt: Ein Benutzer-Auswahlfeld kann kein gelöschtes Konto auswählen, daher ist der Parameter Freitext und kein Auswahlfeld.
* Bei einem gelöschten Benutzer erfolgt der Abgleich im Papierkorb anhand der gelöschten Website `SiteOwnerEmail`. Ein fehlender Wert oder eine frühere UPN-Umbenennung kann zu einem falschen Ergebnis "Nicht gefunden" führen.

Der Runbook ist strikt schreibgeschützt und nimmt keine Änderungen am Tenant vor.

### Speicherort

Organisation → Collab → OneDrive-Status prüfen

**Voller Runbook-Name**

rjgit-org\_collab\_check-onedrive-status

### Details

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

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Office 365 SharePoint Online
  * Sites.FullControl.All
    * *Erforderlich für Connect-PnPOnline gegenüber dem SharePoint-Admincenter und für die Tenant-Admin-Cmdlets Get-PnPTenantSite und Get-PnPTenantDeletedSite, die beliebige Websitesammlungen (einschließlich persönlicher OneDrive-Websites und des Tenant-Papierkorbs) auflisten/überprüfen und nicht unter den niedrigeren Anwendungsberechtigungen Sites.Read.All / Sites.ReadWrite.All verfügbar sind. Get-PnPUserProfileProperty und Get-PnPWeb werden ebenfalls von dieser Berechtigung abgedeckt.*

#### Hinweise zu Berechtigungen

SharePoint Online: Gewähren Sie der systemzugewiesenen verwalteten Identität des Automation-Kontos die Anwendungsberechtigung 'Sites.FullControl.All' für die Office 365 SharePoint Online-API (AppId 00000003-0000-0ff1-ce00-000000000000). Diese SharePoint-App-only-Berechtigung kann nicht über die standardmäßige Entra-Automatisierung zur App-Rollenzuweisung erteilt werden, die für Microsoft Graph verwendet wird, und muss pro Tenant manuell zugewiesen werden (z. B. über das SharePoint-Admincenter oder das entsprechende Grant-PnPAzureADAppSitePermission für verwaltete Identitäten).

### Parameter

#### UserPrincipalName

UPN des Benutzers, dessen OneDrive geprüft wird. Gelöschte Benutzer werden akzeptiert.

| Eigenschaft           | Wert                  |
| --------------------- | --------------------- |
| Erforderlich          | wahr                  |
| Standardwert          |                       |
| Typ                   | Zeichenfolge          |
| Anzeigename im Portal | Benutzerprinzipalname |

[Zurück zur Übersicht der Runbook-Referenz](/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/org/collab/check-onedrive-status.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.