> 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/devices/notify-users-about-low-diskspace_scheduled.md).
# Benutzer über niedrigen Speicherplatz benachrichtigen, geplant
Primäre Benutzer per E-Mail über knappen Speicherplatz auf ihren Geräten benachrichtigen
{% hint style="info" %}
Dies ist ein geplantes Runbook. Es ist dafür ausgelegt, nach einem wiederkehrenden Zeitplan zu laufen, statt für ein einzelnes Objekt ausgelöst zu werden. Siehe [Zeitplanung](/de/automatisierung/runbooks/scheduling.md) für Details zur Konfiguration von Runbook-Zeitplänen.
{% endhint %}
### Beschreibung
Identifiziert von Intune verwaltete Windows- und macOS-Geräte, deren freier Speicherplatz unter einem konfigurierbaren Grenzwert liegt, entweder einem festen freien Speicherplatz in Gigabyte oder einem Prozentsatz der gesamten Festplattengröße, und sendet eine personalisierte E-Mail pro primärem Benutzer. Die E-Mail listet alle betroffenen Geräte des Benutzers mit freiem und gesamtem Festplattenspeicher auf, stuft jedes Gerät als Kritisch oder Warnung ein und enthält praktische, plattformspezifische Schritte, um Speicherplatz freizugeben. Die Auswertung kann auf kritische Geräte, auf Geräte mit einem aktuellen Intune-Inventar, auf Mitglieder einer Entra-Gerätegruppe sowie auf Benutzer eingeschränkt werden, die über eine Gruppe ein- oder ausgeschlossen sind. Ein Simulationsmodus listet die betroffenen Benutzer und Geräte auf, ohne etwas zu senden, und ein globaler Übersteuerungsempfänger leitet alle Benachrichtigungen an ein Test- oder gemeinsam genutztes Postfach um.
### Aktualität der Daten und Einschränkungen
Die Werte für freien und gesamten Festplattenspeicher werden aus dem Intune-Hardwareinventar jedes verwalteten Geräts gelesen. Dieses Inventar wird mit dem regulären Geräte-Check-in aktualisiert, sodass das Runbook den Zustand des letzten erfolgreichen Inventars und nicht den aktuellen Zustand des Geräts sieht. Um zu vermeiden, dass Benutzer auf Grundlage veralteter Zahlen benachrichtigt werden, werden Geräte übersprungen, deren letzte Intune-Synchronisierung älter ist als `MaxInventoryAgeDays` (Standard: 14 Tage) werden separat übersprungen und gezählt. Geräte ohne Datum der letzten Synchronisierung gelten ebenfalls als veraltet. Setzen Sie den Parameter auf `0` 0, um diese Prüfung zu deaktivieren.
Das begleitende **Report Devices Low Diskspace** Runbook wendet diesen Filter bewusst nicht an, sodass es ebenfalls Geräte mit veraltetem Inventar auflistet und mehr Geräte anzeigen kann, als hier benachrichtigt werden. Beide Runbooks verwenden denselben Grenzwert und dieselbe Kritisch/Warnung-Bewertung, sodass ein Gerät in beiden identisch eingestuft wird; der Unterschied in der Geräteanzahl sind genau die Geräte, die wegen eines veralteten Inventars übersprungen werden und die dieses Runbook als separate Zahl in seiner Ausgabe meldet.
Geräte, die eine Gesamtfestplattengröße von null Bytes melden, verfügen über kein nutzbares Speicherinventar, beispielsweise Geräte, für die noch kein Inventar abgeschlossen wurde. Solche Geräte werden von der Auswertung ausgeschlossen, statt als "0 GB frei" behandelt zu werden, und ihre Anzahl wird in der Konsolenausgabe angezeigt.
Es werden nur Windows- und macOS-Geräte ausgewertet. Das Speicherinventar von Mobilgeräten ist weniger zuverlässig, der Standardgrenzwert in Gigabyte ist für Desktop-Festplatten ausgelegt, und die Bereinigungshinweise in der E-Mail sind auf Desktop-Betriebssysteme zugeschnitten.
Dieses Runbook ist die benutzerseitige Entsprechung von **Report Devices Low Diskspace**. Beide verwenden dieselben Grenzwert-Einstellungen und dieselbe Kritisch/Warnung-Bewertung. Verwenden Sie den Bericht für die administrative Übersicht, einschließlich Geräten ohne primären Benutzer, und dieses Runbook, um die betroffenen Benutzer aufzufordern, selbst Speicherplatz freizugeben.
### Grenzwert und Schweregrad
`ThresholdType` legt fest, ob ein Gerät anhand eines festen freien Speicherplatzes (`FreeSpaceThresholdGB`) oder anhand des Anteils freien Speicherplatzes im Verhältnis zur Festplattengröße (`FreeSpacePercentThreshold`) berücksichtigt wird. Im Portal wird nur das Feld angezeigt, das zum ausgewählten Typ gehört.
Jedes Gerät unterhalb des Grenzwerts wird eingestuft: Geräte, die unter der Hälfte des konfigurierten Grenzwerts liegen, werden als **Kritisch** markiert, alle anderen Geräte unterhalb des Grenzwerts als **Warnung**. Die Bewertung wird pro Gerät in der E-Mail angezeigt, und mit den integrierten englischen und deutschen Vorlagen wechseln Betreff und Einleitung zu einer dringlichen Formulierung, sobald eines der Geräte des Benutzers Kritisch ist. Die `Benutzerdefiniert` Vorlage hat nur einen Betreff und eine Einleitung, die beide wörtlich aus der Runbook-Anpassung übernommen werden, sodass dort eine Kritisch- und eine Warnung-Benachrichtigung identisch aussehen - formulieren Sie den benutzerdefinierten Text so, dass er für beide funktioniert.
`NotifyOnSeverity` steuert, welche Geräte eine Benachrichtigung auslösen. Standardmäßig tut dies jedes Gerät unterhalb des Grenzwerts (*Warnung und Kritisch*). Mit *Nur Kritisch* werden Benutzer nur kontaktiert, wenn ein Gerät unter der Hälfte des Grenzwerts liegt. Dies ermöglicht einen zweistufigen Ansatz: Melden Sie alle Geräte unterhalb des Grenzwerts über das Report-Runbook an Administratoren, und benachrichtigen Sie nur die Benutzer, deren Geräte kritisch sind.
### Benachrichtigungsverhalten
Das Runbook sendet **eine E-Mail pro primärem Benutzer** mit allen betroffenen Geräten dieses Benutzers inklusive Betriebssystem, Modell, freiem und gesamtem Festplattenspeicher, Bewertung und Datum des letzten Inventars. Die E-Mail enthält praktische Bereinigungsschritte für die Plattformen der aufgelisteten Geräte: Der Windows-Abschnitt wird für Windows-Geräte eingefügt, der macOS-Abschnitt für macOS-Geräte, und beide, wenn der Benutzer betroffene Geräte beider Arten hat.
Empfänger werden über Microsoft Graph aufgelöst: Der primäre Benutzer eines Geräts wird anhand der Entra-Objekt-ID nachgeschlagen, die Intune in `userId` meldet, sodass Gastkonten und Benutzer, deren aktuelles UPN von der bei der Registrierung gespeicherten Adresse abweicht, korrekt aufgelöst werden; Geräte ohne eine `userId` greifen auf eine Suche über den Benutzerprinzipalnamen zurück. Die E-Mail wird dann an das `mail` -Attribut des Benutzers gesendet, wobei der Benutzerprinzipalname als Fallback verwendet wird, wenn kein mail-Attribut festgelegt ist. Deaktivierte Konten und Benutzer, die nicht aufgelöst werden können, werden übersprungen und in der Konsolenausgabe aufgelistet. Geräte ohne primären Benutzer können nicht benachrichtigt werden; sie werden für die zentrale Nachverfolgung in der Konsolenausgabe aufgelistet (das Report-Runbook deckt sie ebenfalls ab).
`SimulationMode` listet die betroffenen Benutzer, ihre Geräte und die vorgesehenen Empfänger in der Konsolenausgabe auf, ohne eine E-Mail zu senden. Verwenden Sie es, um Grenzwerte und Scope-Filter vor dem ersten produktiven Lauf zu validieren.
`OverrideEmailRecipient` leitet **ALLE** Benachrichtigungen an die angegebene Adresse (bei mehreren Empfängern kommagetrennt) statt an die Endbenutzer um. Bei jedem Lauf wird eine Warnung protokolliert, solange die Umleitung aktiv ist, und jede umgeleitete E-Mail nennt den betroffenen Benutzer im Betreff und im Text. Verwenden Sie dies zum Testen des E-Mail-Inhalts oder um alles an ein gemeinsames Postfach zu leiten.
### Bereichsoptionen
* **Benutzerbereich:** Mit `UseUserScope` aktiviert, `IncludeUserGroup` beschränkt die Benachrichtigungen auf Benutzer, die Mitglieder dieser Gruppe sind, und `ExcludeUserGroup` unterdrückt Benachrichtigungen für Mitglieder dieser Gruppe. Beide verwenden die transitive Mitgliedschaft, sodass verschachtelte Gruppen aufgelöst werden, und beide werden einmal zu Beginn des Laufs gelesen.
* **Gerätebereich:** `IncludeDeviceGroup` beschränkt die Auswertung auf Geräte, die (transitive) Mitglieder der angegebenen Entra-Gerätegruppe sind. Geräte werden über ihre Entra-Geräte-ID abgeglichen.
Wenn ein Benutzerbereich und ein Gerätebereich konfiguriert sind, muss ein Gerät beide Bedingungen erfüllen. Schlägt die Gruppenauflösung fehl, beendet das Runbook den Lauf mit einem Fehler, statt stillschweigend jeden Benutzer zu benachrichtigen.
### Einrichtung des E-Mail-Versands
Die Benachrichtigungs-E-Mails werden an die betroffenen Benutzer gesendet; die Absenderadresse wird aus dem `RJReport.EmailSender` Mandanten-Setting entnommen und ist erforderlich.
Dieses Runbook sendet E-Mails über die Microsoft Graph API. Um E-Mails über Graph API zu senden, müssen Sie in der Runbook-Anpassung eine vorhandene E-Mail-Adresse konfigurieren.
Siehe die [Dokumentation zu RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) für Details zu allen verfügbaren Einstellungen.
#### E-Mail-Branding
Die Benachrichtigungs-E-Mail berücksichtigt die optionalen `RJReport.Branding.*` Mandanten-Einstellungen:
* **Header- und Footerbild** – öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB je Datei
* **Footer-Link** – Ziel des Footerbilds
* **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 die E-Mail niemals – stattdessen wird der entsprechende Standard verwendet.
Einrichtungsanweisungen und Bildanforderungen: [E-Mail-Branding](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).
#### Service-Desk-Kontaktinformationen
Die optionalen `RJReport.ServiceDesk_DisplayName`, `RJReport.ServiceDesk_EMail`, `RJReport.ServiceDesk_Phone` und `RJReport.ServiceDesk_PortalUrl` Mandanten-Einstellungen fügen am Ende jeder E-Mail einen Kontaktblock hinzu. `ServiceDeskTicketUrl` kann zusätzlich mit einem Ticket verlinken.
### Sprachauswahl der E-Mail-Vorlage
Dieses Runbook unterstützt drei Optionen für E-Mail-Vorlagen:
1. **EN (Englisch - Standard)**: Verwendet die integrierte englische Vorlage
2. **DE (Deutsch)**: Verwendet die integrierte deutsche Vorlage
3. **Benutzerdefiniert**: Verwendet eine benutzerdefinierte Vorlage aus den Runbook-Anpassungen
#### Benutzerdefinierte E-Mail-Vorlagen verwenden
Um eine benutzerdefinierte E-Mail-Vorlage zu verwenden (z. B. auf Niederländisch, Spanisch oder in einer anderen Sprache), müssen Sie den Vorlagentext in den Runbook-Anpassungen konfigurieren. Wenn ein Parameter der benutzerdefinierten Vorlage fehlt, fällt das Runbook automatisch auf die englische Vorlage zurück.
Die benutzerdefinierte Vorlage besteht aus einem Betreff, einem Text vor der Geräteliste und einem Text nach der Geräteliste. Die integrierten Bereinigungsschritte, der Abschnitt "Why is this important" und der Abschnitt "Questions" werden bei der **nicht** benutzerdefinierten Vorlage nicht gerendert, daher sollte der Text nach der Geräteliste Ihre eigenen Bereinigungshinweise enthalten.
**Beispiel: Benutzerdefinierte Vorlage**
```json
{
"Runbooks": {
"rjgit-org_devices_notify-users-about-low-diskspace_scheduled": {
"Parameters": {
"CustomMailTemplateSubject": {
"Default": "Dies ist ein benutzerdefinierter Betreff - Aktion erforderlich: Wenig Speicherplatz"
},
"CustomMailTemplateBeforeDeviceDetails": {
"Default": "**Dies steht über den Gerätedetails.** \n\nLiebe/r Benutzer/in, die folgenden Geräte haben nicht mehr viel Speicherplatz:"
},
"CustomMailTemplateAfterDeviceDetails": {
"Default": "**Dies steht unter den Gerätedetails.** \n\n## Was Sie jetzt tun können\n\n1. Leeren Sie den Papierkorb\n2. ..."
}
}
}
}
}
```
**Wichtige Hinweise:**
* Verwenden Sie `\n` für Zeilenumbrüche in der JSON-Konfiguration
* Markdown-Formatierung (##, ###, \*\*, -) wird im Vorlagentext unterstützt
* Alle drei Parameter der benutzerdefinierten Vorlage (Subject, BeforeDeviceDetails, AfterDeviceDetails) sollten konfiguriert werden
* Wenn ein Parameter fehlt, fällt das Runbook automatisch auf die englische (EN) Vorlage zurück
* Wenn Sie die benutzerdefinierte Vorlage verwenden, wählen Sie im Mail-Vorlagen-Dropdown "Benutzerdefiniert - Vorlage aus Runbook-Anpassungen verwenden"
* Die Beschriftungen der Geräteliste werden bei der benutzerdefinierten Vorlage auf Englisch dargestellt
### Speicherort
Organisation → Geräte → Benutzer über wenig Speicherplatz benachrichtigen (geplant)
**Vollständiger Runbook-Name**
rjgit-org\_devices\_notify-users-about-low-diskspace\_scheduled
### Details
| Eigenschaft | Wert |
| -------------------- | --------------------------------------------------------------------------------------- |
| Version | 1.0.0 |
| Erforderliche Module | RealmJoin.RunbookHelper (>= 0.8.9)
Microsoft.Graph.Authentication (>= 2.39.0)
|
| Planbar | ja |
### Hinweise
Dieses Runbook ist die benutzerseitige Entsprechung des Runbooks "Report Devices Low Diskspace". Beide verwenden dieselben Grenzwert-Einstellungen und dieselbe Kritisch/Warnung-Bewertung, sodass der Bericht Administratoren die Übersicht liefert, während dieses Runbook die betroffenen Benutzer auffordert, selbst Speicherplatz freizugeben.
Auflösung der Empfänger: Der primäre Benutzer eines Geräts wird über die Entra-Objekt-ID aufgelöst, die Intune in managedDevice.userId meldet, sodass Gastkonten und Benutzer, deren aktuelles UPN von der bei der Registrierung gespeicherten Adresse abweicht, korrekt aufgelöst werden. Geräte, für die Intune keine userId meldet, greifen auf eine Suche über den Benutzerprinzipalnamen zurück. Die Benachrichtigung wird an das mail-Attribut des Benutzers gesendet, wobei das UPN als Fallback dient.
Voraussetzungen:
* Der Parameter EmailFrom muss in der Runbook-Anpassung konfiguriert werden (Einstellung RJReport.EmailSender)
* Optional: Service-Desk-Kontaktinformationen können konfiguriert werden (ServiceDesk\_DisplayName, ServiceDesk\_EMail, ServiceDesk\_Phone, ServiceDesk\_PortalUrl, ServiceDesk\_TicketUrl)
Datenquelle und Aktualität: Die Werte für freien und gesamten Festplattenspeicher werden aus dem Intune-Hardwareinventar jedes Geräts übernommen, das mit dem regulären Geräte-Check-in aktualisiert wird. Sie beschreiben den Zustand des letzten erfolgreichen Inventars und nicht notwendigerweise den aktuellen Zustand des Geräts. Um zu vermeiden, dass Benutzer auf Grundlage veralteter Zahlen benachrichtigt werden, werden Geräte übersprungen, deren letzte Intune-Synchronisierung älter als MaxInventoryAgeDays ist (0 deaktiviert diese Prüfung). Das Runbook "Report Devices Low Diskspace" wendet diesen Filter bewusst nicht an, sodass es ebenfalls Geräte mit veraltetem Inventar auflistet - es kann daher mehr Geräte anzeigen, als hier benachrichtigt werden. Die Anzahl, die wegen veraltetem Inventar übersprungen wird, wird in der Ausgabe dieses Runbooks gemeldet; dadurch erklärt sich der Unterschied. Geräte, die eine Gesamtfestplattengröße von null Bytes melden, verfügen über kein nutzbares Speicherinventar und werden von der Auswertung ausgeschlossen, ihre Anzahl wird jedoch gemeldet. Es werden nur Windows- und macOS-Geräte ausgewertet, weil das Speicherinventar von Mobilgeräten weniger zuverlässig ist und die Bereinigungshinweise abweichen.
Typische Anwendungsfälle:
* Wiederkehrende Erinnerungen an Benutzer, deren Geräte kurz davor sind, keinen Speicherplatz mehr zu haben, bevor Updates und App-Installationen fehlschlagen
* Zweistufige Kampagnen: Alle Geräte unterhalb des Grenzwerts an Administratoren melden, nur die kritischen benachrichtigen (NotifyOnSeverity)
* Gestaffelte Rollouts pro Abteilung oder Pilotgruppe über die Optionen für den Benutzer- und Gerätebereich
* Ausschluss von Service- oder gemeinsam genutzten Konten über die Ausschlussgruppe
Pilot- und Testoptionen:
* Verwenden Sie SimulationMode, um die betroffenen Benutzer und Geräte aufzulisten, ohne eine E-Mail zu senden
* Verwenden Sie OverrideEmailRecipient, um alle Benachrichtigungen an ein Testpostfach statt an die Endbenutzer zu senden
* Ideal zum Validieren des E-Mail-Inhalts sowie zum Testen von Grenzwerten und Filtern vor der Einführung in die Produktion
### Berechtigungen
#### Anwendungsberechtigungen
* **Typ**: Microsoft Graph
* DeviceManagementManagedDevices.Read.All
* *Liest von Intune verwaltete Geräte einschließlich freeStorageSpaceInBytes, totalStorageSpaceInBytes, lastSyncDateTime und des primären Benutzers (userId und userPrincipalName), um Geräte unterhalb des Grenzwerts für wenig Speicherplatz zu finden*
* User.Read.All
* *Löst jeden betroffenen primären Benutzer (E-Mail-Adresse, Anzeigename und accountEnabled) auf, bevor die Benachrichtigung gesendet wird*
* Mail.Send
* *Sendet die Benachrichtigungs-E-Mail zu wenig Speicherplatz an jeden primären Benutzer oder an den Übersteuerungsempfänger*
* Organization.Read.All *(optional — Funktion: Tenant-Name in der E-Mail-Fußzeile)*
* *Liest /organization für den in der E-Mail-Fußzeile angezeigten Tenant-Namen; ohne diese Berechtigung fällt das Runbook auf "Unbekannter Tenant" zurück*
* Directory.Read.All *(optional — Funktion: Filterung des Gruppenbereichs)*
* *Liest die transitiven Benutzer-Mitglieder der Einschluss-/Ausschluss-Benutzergruppen und die transitiven Geräte-Mitglieder (Entra-Geräte-ID) der optionalen Gerätegruppe*
### Parameter
#### ThresholdType
Legt fest, wie wenig Speicherplatz erkannt wird, entweder über einen festen freien Speicherplatz in Gigabyte oder über den Prozentsatz des freien Speicherplatzes relativ zur Festplattengröße.
| Eigenschaft | Wert |
| --------------------- | ---------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | Freier Speicherplatz in GB |
| Typ | Zeichenfolge |
| Anzeigename im Portal | Wie soll wenig Speicherplatz ermittelt werden? |
**Portaloptionen**
| Portaloption | Wert |
| --------------------------------------------------------------------- | ---- |
| Freier Speicherplatz unter einer festen Größe (GB) | |
| Freier Speicherplatz unter einem Prozentsatz der Festplattengröße (%) | |
#### FreeSpaceThresholdGB
Geräte mit weniger freiem Festplattenspeicher als dieser Wert in Gigabyte werden berücksichtigt. Wird nur verwendet, wenn der Grenzwerttyp auf freien Speicherplatz in Gigabyte gesetzt ist.
| Eigenschaft | Wert |
| --------------------- | ------------------------------------------------------ |
| Erforderlich | falsch |
| Standardwert | 20 |
| Typ | Int32 |
| Anzeigename im Portal | Schwellenwert für wenig Speicherplatz (freier GB-Wert) |
#### FreeSpacePercentThreshold
Geräte mit einem geringeren Prozentsatz an freiem Festplattenspeicher als dieser Wert werden berücksichtigt. Wird nur verwendet, wenn der Grenzwerttyp auf freien Speicherplatz in Prozent gesetzt ist.
| Eigenschaft | Wert |
| ---------------------- | ----------------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | 10 |
| Typ | Int32 |
| Anzeigename im Portal | Schwellenwert für wenig Speicherplatz (freier %-Wert) |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### NotifyOnSeverity
Legt fest, welche Geräte eine Benachrichtigung auslösen: jedes Gerät unterhalb des Grenzwerts (Warnung und Kritisch) oder nur Geräte unterhalb der Hälfte des Grenzwerts (Nur Kritisch).
| Eigenschaft | Wert |
| --------------------- | ---------------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | Warnung und Kritisch |
| Typ | Zeichenfolge |
| Anzeigename im Portal | Welche Geräte sollen eine Benachrichtigung auslösen? |
**Portaloptionen**
| Portaloption | Wert |
| ----------------------------------------------------------- | ---- |
| Warnung und Kritisch - jedes Gerät unterhalb des Grenzwerts | |
| Nur Kritisch - Geräte unterhalb der Hälfte des Grenzwerts | |
#### Windows
Windows-Geräte in die Auswertung einbeziehen.
| Eigenschaft | Wert |
| --------------------- | -------------------------- |
| Erforderlich | falsch |
| Standardwert | Wahr |
| Typ | Boolesch |
| Anzeigename im Portal | Windows-Geräte einbeziehen |
#### macOS
macOS-Geräte in die Auswertung einbeziehen.
| Eigenschaft | Wert |
| --------------------- | ------------------------ |
| Erforderlich | falsch |
| Standardwert | Wahr |
| Typ | Boolesch |
| Anzeigename im Portal | macOS-Geräte einbeziehen |
#### MaxInventoryAgeDays
Geräte, deren letzte Intune-Synchronisierung älter ist als diese Anzahl von Tagen, werden übersprungen, da ihr Speicherinventar als veraltet gilt. Geräte ohne Datum der letzten Synchronisierung werden ebenfalls übersprungen. Setzen Sie den Wert auf 0, um die Prüfung zu deaktivieren.
| Eigenschaft | Wert |
| --------------------- | ---------------------------------------------------------------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | 14 |
| Typ | Int32 |
| Anzeigename im Portal | Geräte überspringen, deren letzte Intune-Synchronisierung älter ist als (Tage, 0 = keine Begrenzung) |
#### EmailFrom
Die Absender-E-Mail-Adresse. Diese muss in den Runbook-Anpassungen konfiguriert werden.
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### BrandingHeaderImageUrl
Optionale öffentliche HTTPS-URL eines benutzerdefinierten Headerbilds (PNG/JPEG/GIF, max. 200 KB) für die Benachrichtigungs-E-Mail. Stammt aus der Mandanten-Einstellung RJReport.Branding.HeaderImageUrl. Wenn leer, wird die Standard-Headergrafik von RealmJoin verwendet.
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### BrandingFooterImageUrl
Optionale öffentliche HTTPS-URL eines benutzerdefinierten Footerbilds (PNG/JPEG/GIF, max. 200 KB) für die Benachrichtigungs-E-Mail. Stammt aus der Mandanten-Einstellung RJReport.Branding.FooterImageUrl. Wenn leer, wird die Standard-Footergrafik von RealmJoin verwendet.
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### BrandingFooterLink
Optionale URL, auf die das Footerbild verlinkt. Stammt aus der Mandanten-Einstellung RJReport.Branding.FooterLink. Wenn leer, wird der Standardlink () verwendet.
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### BrandingAccentColor
Optionale Überschreibung der Akzentfarbe (6-stelliges Hex, z. B. '#0052cc') für die Vorlage der Benachrichtigungs-E-Mail. Stammt aus der Mandanten-Einstellung RJReport.Branding.AccentColor. Wenn leer oder ungültig, wird die Standard-Akzentfarbe von RealmJoin verwendet.
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### BrandingTextColor
Optionale Überschreibung der Textfarbe (6-stelliges Hex) für die Vorlage der Benachrichtigungs-E-Mail. Stammt aus der Mandanten-Einstellung RJReport.Branding.TextColor. Wenn leer oder ungültig, wird die Standard-Textfarbe von RealmJoin verwendet.
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### ServiceDeskDisplayName
Anzeigename des Service Desks für Benutzer-Kontaktinformationen (optional).
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### ServiceDeskEmail
E-Mail-Adresse des Service Desks für Benutzer-Kontaktinformationen (optional).
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### ServiceDeskPhone
Telefonnummer des Service Desks für Benutzer-Kontaktinformationen (optional).
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### ServiceDeskPortalUrl
Portal-URL des Service Desks für Benutzer-Kontaktinformationen, als klickbarer Link dargestellt (optional).
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### ServiceDeskTicketUrl
Direkter Link zu einem Service-Desk-Ticket, als klickbarer Link dargestellt (optional). Standardmäßig leer, daher wird kein Ticketlink hinzugefügt.
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### UseUserScope
Aktiviert die Benutzerbereichsfilterung, um Benutzer basierend auf der Gruppenmitgliedschaft ein- oder auszuschließen.
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | Falsch |
| Typ | Boolesch |
| Anzeigename im Portal | Benutzerbereichsfilterung verwenden |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### IncludeUserGroup
Benachrichtigt nur Benutzer, die (transitive) Mitglieder dieser Gruppe sind. Erfordert, dass UseUserScope aktiviert ist.
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Anzeigename im Portal | Einzuschließende Benutzer (Gruppe) |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### ExcludeUserGroup
Benachrichtigt keine Benutzer, die (transitive) Mitglieder dieser Gruppe sind. Erfordert, dass UseUserScope aktiviert ist.
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Anzeigename im Portal | Auszuschließende Benutzer (Gruppe) |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### IncludeDeviceGroup
Optionale Entra-Gerätegruppe. Wenn gesetzt, werden nur Geräte ausgewertet, die (transitive) Mitglieder dieser Gruppe sind. Kann mit dem Benutzerbereich kombiniert werden.
| Eigenschaft | Wert |
| --------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Anzeigename im Portal | Auf Geräte in Gruppe beschränken (optional) |
#### OverrideEmailRecipient
Optional: Globale Umleitung - wenn gesetzt, werden ALLE Benachrichtigungen an diese Adresse statt an die Endbenutzer gesendet. Kann für mehrere Empfänger kommagetrennt angegeben werden. Ideal zum Testen und für Pilotierungen oder um alles an ein gemeinsames Postfach zu leiten. Wenn leer gelassen, wird jeder Benutzer direkt per E-Mail angeschrieben.
| Eigenschaft | Wert |
| --------------------- | ------------------------------------------------ |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Anzeigename im Portal | ALLE E-Mails an Übersteuerungsempfänger umleiten |
#### SimulationMode
Wenn aktiviert, listet das Runbook die betroffenen Benutzer und Geräte in der Ausgabe auf, sendet jedoch keine E-Mail.
| Eigenschaft | Wert |
| --------------------- | ---------------------- |
| Erforderlich | falsch |
| Standardwert | Falsch |
| Typ | Boolesch |
| Anzeigename im Portal | Benachrichtigungsmodus |
**Portaloptionen**
| Portaloption | Wert |
| ------------------------------------------------------------- | ------ |
| Benachrichtigungen an Benutzer senden | falsch |
| Simulation - nur betroffene Benutzer auflisten, nichts senden | wahr |
#### MailTemplateLanguage
Wählen Sie aus, welche E-Mail-Vorlage verwendet werden soll: EN (Englisch, Standard), DE (Deutsch) oder Custom (aus den Runbook-Anpassungen).
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | EN |
| Typ | Zeichenfolge |
| Anzeigename im Portal | E-Mail-Vorlage |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### CustomMailTemplateSubject
Benutzerdefinierte Betreffzeile für die E-Mail (wird nur verwendet, wenn MailTemplateLanguage auf 'Custom' gesetzt ist). Sie wird sowohl für Warnung- als auch für Kritisch-Benachrichtigungen verwendet, da die benutzerdefinierte Vorlage keine Entsprechung zur dringlichen Betreffzeile der integrierten Vorlagen hat.
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Anzeigename im Portal | Benutzerdefiniert: E-Mail-Betreff |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### CustomMailTemplateBeforeDeviceDetails
Benutzerdefinierter Text, der vor der Geräteliste angezeigt wird (wird nur verwendet, wenn MailTemplateLanguage auf 'Custom' gesetzt ist). Unterstützt Markdown-Formatierung.
| Eigenschaft | Wert |
| ---------------------- | ------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Anzeigename im Portal | Benutzerdefiniert: Text vor der Geräteliste |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
#### CustomMailTemplateAfterDeviceDetails
Benutzerdefinierter Text, der nach der Geräteliste angezeigt wird (wird nur verwendet, wenn MailTemplateLanguage auf 'Custom' gesetzt ist). Unterstützt Markdown-Formatierung. Ersetzt die integrierten Bereinigungsschritte, daher sollte er eigene Hinweise enthalten.
| Eigenschaft | Wert |
| ---------------------- | -------------------------------------------- |
| Erforderlich | falsch |
| Standardwert | |
| Typ | Zeichenfolge |
| Anzeigename im Portal | Benutzerdefiniert: Text nach der Geräteliste |
| Im Portal ausgeblendet | ja (vorkonfiguriert über Runbook-Anpassung) |
[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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/devices/notify-users-about-low-diskspace_scheduled.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.