> 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/general/monitor-service-health_scheduled.md).

# Geplante Überwachung des Dienstzustands

Per E-Mail über neu angekündigte Probleme mit dem Microsoft 365-Dienstzustand benachrichtigen

{% hint style="info" %}
Dies ist ein geplantes Runbook. Es ist so konzipiert, dass es nach einem wiederkehrenden Zeitplan ausgeführt wird, 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

Fragt den Microsoft 365 Service Health-Problem-Feed nach einem Zeitplan ab und identifiziert Probleme, deren erster Service-Health-Beitrag innerhalb eines konfigurierbaren Rückblickfensters liegt, da Microsoft den offiziellen Startzeitpunkt häufig rückdatiert und eine Filterung nur danach Warnungen verpassen würde. Optional wird die Überwachung auf einen ausgewählten Satz von Diensten eingegrenzt, und für jedes neu erkannte Problem wird eine Warn-E-Mail gesendet, deren Betreff den Mandanten und den Problemtitel enthält. Alle Problemdetails werden im E-Mail-Text mitgeführt; das Runbook erzeugt keine Berichtdateien.

### Einstellungen zum E-Mail-Versand

Das Senden eines E-Mail-Berichts ist optional und erfolgt nur, wenn ein Empfänger (`EmailTo`) angegeben ist. Die Absenderadresse wird aus der `RJReport.EmailSender` Mandanteneinstellung übernommen.

Dieses Runbook sendet E-Mails über die Microsoft Graph API. Um E-Mails über die Graph API zu senden, müssen Sie in der Runbook-Anpassung eine vorhandene E-Mail-Adresse 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 optional die `RJReport.Branding.*` Mandanteneinstellungen:

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

Wenn diese Einstellungen nicht konfiguriert sind, werden die standardmäßigen RealmJoin-Grafiken und -Farben 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).

### Speicherort

Organisation → Allgemein → Service Health überwachen (geplant)

**Vollständiger Runbook-Name**

rjgit-org\_general\_monitor-service-health\_scheduled

### Details

| Eigenschaft          | Wert                                                                                    |
| -------------------- | --------------------------------------------------------------------------------------- |
| Version              | 1.3.0                                                                                   |
| Erforderliche Module | <p>RealmJoin.RunbookHelper (>= 0.8.9)<br>Microsoft.Graph.Authentication (>= 2.38.0)</p> |
| Planbar              | ja                                                                                      |

### Hinweise

Häufige Anwendungsfälle:

* Planen Sie das Runbook so ein, dass es im Abstand von LookbackHours oder etwas häufiger ausgeführt wird, um jedes neue Service Health-Problem genau einmal zu erfassen.
* Setzen Sie Services auf eine durch Kommas getrennte Liste von Dienstnamen oder Kurz-IDs (Groß-/Kleinschreibung wird nicht beachtet), um nur bestimmte Dienste wie Exchange Online oder Teams zu überwachen; lassen Sie das Feld leer, um alle Dienste zu überwachen.
* Lassen Sie IncludeAdvisories und IncludeResolvedIssues für die konfigurierteste Einrichtung mit möglichst wenig Störungen auf ihrem Standardwert von $false, wodurch nur nicht behobene Vorfälle gemeldet werden; setzen Sie eines von beiden auf $true, um auch Hinweise oder Probleme anzuzeigen, die Microsoft bereits als behoben markiert hat.

Wechselwirkungen der Parameter:

* Ein Problem gilt als neu angekündigt, wenn sein erster Service-Health-Beitrag innerhalb des LookbackHours-Fensters liegt (und auf startDateTime zurückgegriffen wird, wenn das Problem keine Beiträge hat) - nicht allein anhand von lastModifiedDateTime. So werden rückdatierte Probleme nicht übersehen, ohne bei jeder Statusaktualisierung eines laufenden Vorfalls erneut zu alarmieren.
* Das Runbook behält zwischen den Läufen keinen Zustand bei, daher bedeutet ein fehlgeschlagener oder übersprungener Lauf, dass diese Alarme nie gesendet werden, es sei denn, LookbackHours wird vorübergehend für einen Nachhollauf vergrößert.
* Pro neuem Problem wird eine E-Mail gesendet, daher kann ein ereignisreicher Service Health-Tag pro Lauf mehrere E-Mails erzeugen.

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * Mail.Send *(optional — Funktion: E-Mail-Bericht)*
    * *Sendet pro neu erkanntem Problem eine Warn-E-Mail über Send-RjReportEmail, wenn EmailTo konfiguriert ist*
  * Organization.Read.All
    * *Liest /organization aus, um den Mandantennamen in den Betreff und die Fußzeile der Warn-E-Mail aufzunehmen*
  * ServiceHealth.Read.All
    * *Liest /admin/serviceAnnouncement healthOverviews und issues, um neu angekündigte Service Health-Probleme zu erkennen*

### Parameter

#### Dienste

Durch Kommas getrennte Liste von Microsoft 365-Dienstnamen zur Überwachung, zum Beispiel Microsoft Intune, Microsoft Entra, Exchange Online. Leer lassen, um alle Dienste zu überwachen. Die Übereinstimmung erfolgt unabhängig von der Groß-/Kleinschreibung sowohl mit dem Anzeigenamen des Dienstes als auch mit seiner Kurz-ID, sodass Intune Microsoft Intune entspricht. Gültige Namen finden Sie auf der Seite "Service Health" im Microsoft 365 Admin Center.

| Eigenschaft           | Wert                                                                  |
| --------------------- | --------------------------------------------------------------------- |
| Erforderlich          | falsch                                                                |
| Standardwert          |                                                                       |
| Typ                   | Zeichenfolge                                                          |
| Anzeigename im Portal | Zu überwachende Dienste (durch Kommas getrennt, leer lassen für alle) |

#### LookbackHours

Wie viele Stunden rückwärts nach neu angekündigten Problemen gesucht werden soll. Stellen Sie dies auf dasselbe Intervall wie den Runbook-Zeitplan ein, z. B. 24 für einen täglichen Zeitplan, damit kein Problem übersehen wird und keines zweimal gemeldet wird.

| Eigenschaft           | Wert                                                                   |
| --------------------- | ---------------------------------------------------------------------- |
| Erforderlich          | falsch                                                                 |
| Standardwert          | 24                                                                     |
| Typ                   | Int32                                                                  |
| Anzeigename im Portal | Rückblickfenster (Stunden 1 - 168) - an das Zeitplanintervall anpassen |

#### IncludeAdvisories

Wenn auf false gesetzt, lösen nur Vorfälle eine Benachrichtigung aus. Wenn auf true gesetzt, werden auch Hinweise gemeldet.

| Eigenschaft           | Wert                                      |
| --------------------- | ----------------------------------------- |
| Erforderlich          | falsch                                    |
| Standardwert          | Falsch                                    |
| Typ                   | Boolesch                                  |
| Anzeigename im Portal | Hinweise einbeziehen (nicht nur Vorfälle) |

#### IncludeResolvedIssues

Wenn auf false gesetzt, werden Probleme übersprungen, die Microsoft zum Zeitpunkt der Ausführung des Runbooks bereits als behoben markiert hat. Wenn auf true gesetzt, werden behobene Probleme weiterhin gemeldet.

| Eigenschaft           | Wert                                  |
| --------------------- | ------------------------------------- |
| Erforderlich          | falsch                                |
| Standardwert          | Falsch                                |
| Typ                   | Boolesch                              |
| Anzeigename im Portal | Bereits behobene Probleme einbeziehen |

#### EmailFrom

Die Absender-E-Mail-Adresse, die für die E-Mails mit den einzelnen Problemwarnungen verwendet wird. Diese muss in der Runbook-Anpassung konfiguriert werden.

| Eigenschaft            | Wert                                                    |
| ---------------------- | ------------------------------------------------------- |
| Erforderlich           | falsch                                                  |
| Standardwert           |                                                         |
| Typ                    | Zeichenfolge                                            |
| Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) |

#### BrandingHeaderImageUrl

Optionale öffentliche HTTPS-URL eines benutzerdefinierten Kopfzeilenbilds (PNG/JPEG/GIF, max. 200 KB) für die Warn-E-Mails. Stammt aus der Mandanteneinstellung RJReport.Branding.HeaderImageUrl. Wenn leer, wird die Standard-Kopfzeilengrafik von RealmJoin verwendet.

| Eigenschaft            | Wert                                                    |
| ---------------------- | ------------------------------------------------------- |
| Erforderlich           | falsch                                                  |
| Standardwert           |                                                         |
| Typ                    | Zeichenfolge                                            |
| Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) |

#### BrandingFooterImageUrl

Optionale öffentliche HTTPS-URL eines benutzerdefinierten Fußzeilenbilds (PNG/JPEG/GIF, max. 200 KB) für die Warn-E-Mails. Stammt aus der Mandanteneinstellung RJReport.Branding.FooterImageUrl. Wenn leer, wird die Standard-Fußzeilengrafik von RealmJoin verwendet.

| Eigenschaft            | Wert                                                    |
| ---------------------- | ------------------------------------------------------- |
| Erforderlich           | falsch                                                  |
| Standardwert           |                                                         |
| Typ                    | Zeichenfolge                                            |
| Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) |

#### BrandingFooterLink

Optionale URL, auf die das Fußzeilenbild verweist. Stammt aus der Mandanteneinstellung RJReport.Branding.FooterLink. Wenn leer, wird der Standardlink (<https://www.realmjoin.com>) verwendet.

| Eigenschaft            | Wert                                                    |
| ---------------------- | ------------------------------------------------------- |
| Erforderlich           | falsch                                                  |
| Standardwert           |                                                         |
| Typ                    | Zeichenfolge                                            |
| Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) |

#### BrandingAccentColor

Optionale Überschreibung der Akzentfarbe (6-stelliger Hex-Wert, z. B. '#0052cc') für die Bericht-E-Mail-Vorlage. Stammt aus der Mandanteneinstellung RJReport.Branding.AccentColor. Wenn leer oder ungültig, wird die standardmäßige RealmJoin-Akzentfarbe verwendet.

| Eigenschaft            | Wert                                                    |
| ---------------------- | ------------------------------------------------------- |
| Erforderlich           | falsch                                                  |
| Standardwert           |                                                         |
| Typ                    | Zeichenfolge                                            |
| Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) |

#### BrandingTextColor

Optionale Überschreibung der Textfarbe (6-stelliger Hex-Wert) für die Bericht-E-Mail-Vorlage. Stammt aus der Mandanteneinstellung RJReport.Branding.TextColor. Wenn leer oder ungültig, wird die standardmäßige RealmJoin-Textfarbe verwendet.

| Eigenschaft            | Wert                                                    |
| ---------------------- | ------------------------------------------------------- |
| Erforderlich           | falsch                                                  |
| Standardwert           |                                                         |
| Typ                    | Zeichenfolge                                            |
| Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) |

#### EmailTo

Durch Kommas getrennte Liste von Empfänger-E-Mail-Adressen für die E-Mails mit den einzelnen Problemwarnungen. Mindestens ein gültiger Empfänger ist erforderlich.

| Eigenschaft           | Wert                                             |
| --------------------- | ------------------------------------------------ |
| Erforderlich          | wahr                                             |
| Standardwert          |                                                  |
| Typ                   | Zeichenfolge                                     |
| Anzeigename im Portal | E-Mail-Adresse(n) der Empfänger für Warn-E-Mails |

[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/general/monitor-service-health_scheduled.md?ask=<question>&goal=<endgoal>
```

`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.