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

# Dienstzustand überwachen, geplant

Per E-Mail über neue Microsoft 365-Dienstzustandsprobleme warnen

{% 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 den Microsoft 365-Dienstintegritätsfeed auf Probleme, die Microsoft innerhalb der ausgewählten Anzahl von Stunden angekündigt hat. Jedes neue Problem wird als separate Warn-E-Mail gesendet, wobei der Tenant und der Problemtitel in der Betreffzeile und alle Details im Text stehen. Die Überwachung kann auf bestimmte Dienste beschränkt werden, und Hinweise sowie bereits behobene Probleme können einbezogen werden. Es werden keine Berichtsdateien erstellt.

### Häufige Anwendungsfälle

* Planen Sie den Lauf des Runbooks so, dass er zu oder etwas häufiger als `Rückblickstunden` um jedes neue Service-Health-Problem genau einmal zu erfassen.
* Setze `Dienste` zu einer durch Kommas getrennten Liste von Dienstnamen oder kurzen IDs (Groß-/Kleinschreibung wird nicht berücksichtigt), um nur bestimmte Dienste zu überwachen, z. B. Exchange Online oder Teams; lassen Sie es leer, um alle Dienste zu überwachen.
* Lassen Sie `Hinweise einbeziehen` und `Behobene Probleme einbeziehen` auf ihren Standardwert von `falsch` für die Einrichtung mit dem geringsten Benachrichtigungsaufkommen, die nur bei nicht behobenen Vorfällen warnt; setzen Sie einen der beiden Werte auf `wahr` um auch Hinweise oder Probleme anzuzeigen, die Microsoft bereits als behoben markiert hat.

### Parameterinteraktionen

* Ein Problem gilt als neu angekündigt, wenn sein erster Service-Health-Beitrag innerhalb des `Rückblickstunden` Fensters liegt (falls auf `startDateTime` abgefangen wird, wenn das Problem keine Beiträge hat), nicht allein anhand von `lastModifiedDateTime` Dies verhindert, dass rückdatierte Probleme übersehen werden, und vermeidet gleichzeitig erneute Warnungen bei jeder Statusaktualisierung eines laufenden Vorfalls.
* Das Runbook behält zwischen den Läufen keinen Zustand bei, daher bedeutet ein fehlgeschlagener oder übersprungener Lauf, dass diese Warnungen nie gesendet werden, es sei denn `Rückblickstunden` wird für einen Nachhollauf vorübergehend erweitert.
* Pro neuem Problem wird eine E-Mail gesendet, sodass an einem geschäftigen Service-Health-Tag mehrere E-Mails pro Lauf entstehen können.

### Laufausgabe

Jeder Lauf schreibt eine Zusammenfassung der Filterstufen und die Liste der neuen Probleme, einschließlich der Frage, ob die Warn-E-Mail für jedes Problem gesendet wurde, auf die **Ausgabedaten** Registerkarte des Auftrags. Es werden keine Berichtsdateien erstellt.

### Konfiguration für den 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 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).

### Speicherort

Organisation → Allgemein → Service Health überwachen (geplant)

**Voller Runbook-Name**

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

### Details

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

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * Organization.Read.All
    * *Liest /organization, um den Tenant-Namen 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*
  * Mail.Send *(optional — Funktion: E-Mail-Bericht)*
    * *Sendet pro neu erkanntem Problem eine Warn-E-Mail über Send-RjRbReportEmail, wenn EmailTo konfiguriert ist*

### Parameter

#### Dienste

Zu überwachende Dienste, durch Kommas getrennt, z. B. Microsoft Intune, Microsoft Entra, Exchange Online. Leer lassen für alle Dienste. Kurznamen wie Intune funktionieren ebenfalls.

| Eigenschaft           | Wert                    |
| --------------------- | ----------------------- |
| Erforderlich          | falsch                  |
| Standardwert          |                         |
| Typ                   | Zeichenfolge            |
| Anzeigename im Portal | Zu überwachende Dienste |

#### Rückblickstunden

Wie viele Stunden zurück nach neu angekündigten Problemen gesucht werden soll, 1 bis 168. Verwenden Sie das gleiche Intervall wie den Zeitplan, z. B. 24 für einen täglichen Lauf, damit nichts übersehen oder zweimal gemeldet wird.

| Eigenschaft           | Wert                       |
| --------------------- | -------------------------- |
| Erforderlich          | falsch                     |
| Standardwert          | 24                         |
| Typ                   | Int32                      |
| Anzeigename im Portal | Rückblickfenster (Stunden) |

#### Hinweise einbeziehen

Warnt außerdem vor Hinweisen, nicht nur vor Vorfällen.

| Eigenschaft           | Wert                  |
| --------------------- | --------------------- |
| Erforderlich          | falsch                |
| Standardwert          | Falsch                |
| Typ                   | Boolesch              |
| Anzeigename im Portal | Hinweise einbeziehen? |

#### Behobene Probleme einbeziehen

Warnt auch vor Problemen, die Microsoft bereits behoben hat, wenn das Runbook ausgeführt wird.

| Eigenschaft           | Wert                           |
| --------------------- | ------------------------------ |
| Erforderlich          | falsch                         |
| Standardwert          | Falsch                         |
| Typ                   | Boolesch                       |
| Anzeigename im Portal | Behobene Probleme einbeziehen? |

#### 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) |

#### EmailTo

Adressen, die die Warn-E-Mails erhalten, durch Kommas getrennt. Mindestens eine ist erforderlich.

| Eigenschaft           | Wert                        |
| --------------------- | --------------------------- |
| Erforderlich          | wahr                        |
| Standardwert          |                             |
| Typ                   | Zeichenfolge                |
| Anzeigename im Portal | Empfänger-E-Mail-Adresse(n) |

[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/general/monitor-service-health_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.