> 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/report-sharepoint-tenant-storage_scheduled.md).

# Geplanter Bericht über den SharePoint-Tenant-Speicher

SharePoint-Speicher überwachen und warnen, wenn Limits überschritten werden

{% hint style="info" %}
Dies ist ein geplanter Runbook-Lauf. Er ist dafür ausgelegt, nach einem wiederkehrenden Zeitplan ausgeführt zu werden, anstatt für ein einzelnes Objekt ausgelöst zu werden. Siehe [Planung](/de/automatisierung/runbooks/scheduling.md) für Details dazu, wie Runbook-Zeitpläne konfiguriert werden.
{% endhint %}

### Beschreibung

Überprüft bei jedem Lauf den Speicher des SharePoint Online Tenant: das Kontingent, wie viel verwendet wird, und die Websitesammlungen, die am meisten Speicher nutzen. Das vollständige Inventar wird in die Laufausgabe geschrieben. Eine Warn-E-Mail wird nur gesendet, wenn der freie Speicher unter das niedrige Speicherlimit fällt oder der lizenzierte, aber ungenutzte Speicher das zurückforderbare Limit überschreitet.

### Häufige Anwendungsfälle

* Geplanter täglicher Gesundheitscheck des SharePoint Online Tenant-Speichers, der nur warnt, wenn ein Schwellenwert überschritten wird.
* Erkennen eines Tenant, der sich seinem Speicherkontingent nähert, bevor Benutzer daran gehindert werden, Dateien zu speichern.
* Erkennen einer großen Menge ungenutzten, potenziell zurückforderbaren lizenzierten Speichers.

### Planung und Ausgabe

Ein täglicher Zeitplan wird empfohlen. Die Speicherzusammenfassung, das Ergebnis beider Schwellenwertprüfungen und die größten Websitesammlungen werden in die **Ausgabedaten** Registerkarte des Jobs bei jedem Lauf geschrieben, unabhängig davon, ob ein Schwellenwert überschritten wird, damit der Jobverlauf auch an Tagen ohne Alarm nützlich bleibt. Es werden keine Berichtsdateien erstellt.

### Parameterinteraktionen

* `AlertLowStorageLimitInGB` warnt, wenn der freie Tenant-Speicher unter den konfigurierten Wert fällt.
* `AlertUnusedStorageLimitInGB` warnt, wenn der freie Tenant-Speicher über den konfigurierten Wert steigt, ein Hinweis auf zurückforderbaren lizenzierten Speicher. Setzen Sie ihn auf `0` um diese Prüfung zu deaktivieren.
* Beide Prüfungen können im selben Lauf nur ausgelöst werden, wenn `AlertLowStorageLimitInGB` höher konfiguriert ist als `AlertUnusedStorageLimitInGB`; überprüfen Sie beide Werte gemeinsam, wenn Sie die Schwellenwerte anpassen.
* Die Warn-E-Mail wird nur gesendet, wenn mindestens ein Schwellenwert überschritten wird. Ein Lauf ohne Überschreitung wird normal abgeschlossen und sendet nichts.
* Die Liste der größten Websitesammlungen umfasst nur SharePoint-Websitesammlungen. OneDrive for Business-Websites sind ausgeschlossen, da ihr Speicher nicht auf das Tenant-Speicherkontingent angerechnet wird, das dieses Runbook überwacht.

### Konfiguration für den E-Mail-Versand

Das Senden der Warn-E-Mail erfolgt nur, wenn ein Speicher-Schwellenwert überschritten wird; sie geht an den Empfänger (`AlertEmailTo`). Die Absenderadresse wird aus dem `RJReport.EmailSender` Mandanteneinstellung bezogen.

Dieses Runbook sendet E-Mails über die Microsoft Graph API. Um E-Mails über die Graph-API zu senden, müssen Sie eine vorhandene E-Mail-Adresse in der Runbook-Anpassung konfigurieren.

Siehe die [RealmJoin Report Settings Dokumentation](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) für Details zu allen verfügbaren Einstellungen.

#### E-Mail-Branding

Die Bericht-E-Mail berücksichtigt die optionalen `RJReport.Branding.*` Mandanteneinstellungen:

* **Kopf- und Fußzeilenbild** – öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB jeweils
* **Fußzeilenlink** – Ziel des Fußzeilenbildes
* **Akzent- und Textfarbe** – 6-stellige Hex-Werte, z. B. `#0052cc`

Wenn diese Einstellungen nicht konfiguriert sind, werden die Standardgrafiken und -farben von RealmJoin verwendet. Ein Bild, das nicht heruntergeladen oder validiert werden kann, oder ein ungültiger Farbwert verhindert niemals die Bericht-E-Mail – stattdessen wird der entsprechende Standardwert verwendet.

Einrichtungsanweisungen und Bildanforderungen: [E-Mail-Branding](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Einschränkungen

* Das Auflisten aller Websitesammlungen kann in Tenants mit einer großen Anzahl von Websites mehrere Minuten dauern.

### Speicherort

Organisation → Collab → SharePoint Tenant-Speicherbericht (geplant)

**Voller Runbook-Name**

rjgit-org\_collab\_report-sharepoint-tenant-storage\_scheduled

### Details

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

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * Mail.Send
    * *Sendet die Speicher-Schwellenwert-Warn-E-Mail über Send-RjRbReportEmail; der gesamte Zweck dieses Runbooks ist der Alarm, daher ist das Senden bei einer Überschreitung bedingungslos und kein Umschalter*
  * Organization.Read.All
    * *Liest /organization, um den Anzeigenamen des Tenant aufzulösen, der im Betreff und Branding der Warn-E-Mail verwendet wird*
  * Sites.Read.All
    * *Liest die Tenant-Root-Website (/sites/root), um die von Connect-PnPOnline verwendete URL des SharePoint Admin Centers abzuleiten*
* **Typ**: Office 365 SharePoint Online
  * Sites.FullControl.All
    * *Dieses Runbook stellt mit Connect-PnPOnline -ManagedIdentity eine Verbindung zur URL des SharePoint Admin Centers her und ruft die Tenant-Admin-Cmdlets Get-PnPGeoStorageQuota und Get-PnPTenantSite auf, die tenantweite vollständige Kontrolle erfordern; das schreibgeschützte Sites.Read.All reicht für den Tenant-Admin-Endpunkt nicht aus*

#### Hinweise zu Berechtigungen

SharePoint Online: Weisen Sie der verwalteten Identität des Automation Accounts für die Ressource 'Office 365 SharePoint Online' (appId 00000003-0000-0ff1-ce00-000000000000) Sites.FullControl.All zu — diese App-only-Zuweisung kann nicht über den standardmäßigen Entra-App-Rollen-Zuweisungsfluss erfolgen, der für Microsoft Graph verwendet wird, und muss manuell pro Tenant zugewiesen werden.

### Parameter

#### AlertLowStorageLimitInGB

Sendet einen Alarm, wenn der freie Tenant-Speicher unter diese Anzahl Gigabyte fällt.

| Eigenschaft           | Wert                                           |
| --------------------- | ---------------------------------------------- |
| Erforderlich          | wahr                                           |
| Standardwert          | 200                                            |
| Typ                   | Int32                                          |
| Anzeigename im Portal | Warnung, wenn freier Speicher unter (GB) fällt |

#### AlertUnusedStorageLimitInGB

Sendet einen Alarm, wenn der lizenzierte Speicher, den keine Website nutzt, diese Anzahl Gigabyte überschreitet. Dieser Speicher könnte zurückgewonnen werden.

| Eigenschaft           | Wert                                                |
| --------------------- | --------------------------------------------------- |
| Erforderlich          | falsch                                              |
| Standardwert          | 1024                                                |
| Typ                   | Int32                                               |
| Anzeigename im Portal | Warnung, wenn ungenutzter Speicher über (GB) steigt |

#### TopSiteCount

Wie viele der größten Websitesammlungen aufgelistet werden.

| Eigenschaft           | Wert                                              |
| --------------------- | ------------------------------------------------- |
| Erforderlich          | falsch                                            |
| Standardwert          | 10                                                |
| Typ                   | Int32                                             |
| Anzeigename im Portal | Anzahl der zu meldenden größten Websitesammlungen |

#### EmailFrom

Absenderadresse der Warn-E-Mail. Wird aus der Tenant-Einstellung RJReport.EmailSender übernommen.

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

#### BrandingHeaderImageUrl

Kopfzeilenbild der Bericht-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanteneinstellung RJReport.Branding.HeaderImageUrl übernommen; wenn leer, wird der standardmäßige RealmJoin-Kopfbereich verwendet.

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

#### BrandingFooterImageUrl

Fußzeilenbild der Bericht-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanteneinstellung RJReport.Branding.FooterImageUrl übernommen; wenn leer, wird die standardmäßige RealmJoin-Fußzeile verwendet.

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

#### BrandingFooterLink

Link hinter dem Fußzeilenbild der Bericht-E-Mail. Wird aus der Mandanteneinstellung RJReport.Branding.FooterLink übernommen; wenn leer, wird realmjoin.com verwendet.

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

#### BrandingAccentColor

Akzentfarbe der Bericht-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanteneinstellung RJReport.Branding.AccentColor übernommen; wenn leer oder ungültig, wird der standardmäßige RealmJoin-Wert verwendet.

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

#### BrandingTextColor

Textfarbe der Bericht-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanteneinstellung RJReport.Branding.TextColor übernommen; wenn leer oder ungültig, wird der standardmäßige RealmJoin-Wert verwendet.

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

#### AlertEmailTo

Adresse, an die der Alarm gesendet wird, wenn ein Grenzwert überschritten wird.

| Eigenschaft           | Wert                               |
| --------------------- | ---------------------------------- |
| Erforderlich          | wahr                               |
| Standardwert          |                                    |
| Typ                   | Zeichenfolge                       |
| Anzeigename im Portal | E-Mail-Adresse des Alarmempfängers |

#### AlertEmailSubject

Betreffzeile der Warn-E-Mail.

| Eigenschaft           | Wert                                          |
| --------------------- | --------------------------------------------- |
| Erforderlich          | wahr                                          |
| Standardwert          | RealmJoin - SharePoint Online-Speicherwarnung |
| Typ                   | Zeichenfolge                                  |
| Anzeigename im Portal | Betreff der Warn-E-Mail                       |

[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/report-sharepoint-tenant-storage_scheduled.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.