> 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

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

### Beschreibung

Fragt den Microsoft 365 Service-Health-Feed zeitgesteuert ab und erkennt Probleme, deren erster Service-Health-Beitrag innerhalb eines konfigurierbaren Rückblickfensters liegt, da Microsoft den offiziellen Startzeitpunkt häufig rückdatiert und eine Filterung allein nach diesem Wert Warnungen verpassen würde. Optional wird die Überwachung auf eine ausgewählte Gruppe von Diensten eingegrenzt, und für jedes neu erkannte Problem wird eine Warn-E-Mail gesendet, deren Betreff den Tenant-Namen und den Problemtitel enthält. Alle Problemdetails werden im E-Mail-Text mitgegeben; das Runbook erzeugt keine Berichtdateien.

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

Der Versand eines E-Mail-Berichts ist optional und erfolgt nur, wenn ein Empfänger (`EmailTo`) angegeben ist. Die Absenderadresse wird aus der `RJReport.EmailSender` Tenant-Einstellung ü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 [Dokumentation zu RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) für Details.

#### E-Mail-Branding

Die Bericht-E-Mail berücksichtigt die optionalen `RJReport.Branding.*` Tenant-Einstellungen: ein benutzerdefiniertes Headerbild, ein benutzerdefiniertes Footerbild (öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB jeweils), einen benutzerdefinierten Footer-Link sowie benutzerdefinierte Akzent- und Textfarben (6-stellige Hex-Werte, z. B. `#0052cc`). Wenn diese Einstellungen nicht konfiguriert sind, werden die Standardgrafiken und -farben von RealmJoin verwendet. Ein Branding-Bild, das nicht heruntergeladen oder validiert werden kann, oder ein Farbwert, der keine gültige Hex-Farbe ist, verhindert niemals die Bericht-E-Mail – stattdessen wird der entsprechende Standard verwendet.

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

### Ort

Organisation → Allgemein → Service Health überwachen (zeitgesteuert)

**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, dass es in einem Intervall von oder etwas häufiger als LookbackHours ausgeführt wird, damit jedes neue Service-Health-Problem genau einmal erfasst wird.
* Setzen Sie Services auf eine durch Kommas getrennte Liste von Dienstnamen oder Kurz-IDs (ohne Berücksichtigung der Groß-/Kleinschreibung abgeglichen), 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 geräuschärmste Konfiguration auf ihrem Standardwert $false; dann werden nur ungelöste Vorfälle gemeldet. Setzen Sie eines von beiden auf $true, um zusätzlich Hinweise oder Probleme anzuzeigen, die Microsoft bereits als behoben markiert hat.

Parameterwechselwirkungen:

* Ein Problem gilt als neu angekündigt, wenn sein erster Service-Health-Beitrag innerhalb des LookbackHours-Fensters liegt (mit startDateTime als Fallback, falls das Problem keine Beiträge hat) – nicht allein aufgrund von lastModifiedDateTime. Dadurch werden rückdatierte Probleme nicht übersehen, während gleichzeitig erneute Warnungen bei jeder Statusaktualisierung eines laufenden Vorfalls vermieden werden.
* Das Runbook speichert zwischen den Ausführungen keinen Zustand. Daher bedeutet eine fehlgeschlagene oder übersprungene Ausführung, dass diese Warnungen nie gesendet werden, es sei denn, LookbackHours wird vorübergehend für einen Nachhollauf vergrößert.
* Für jedes neue Problem wird eine E-Mail gesendet, daher kann ein an Service Health ereignisreicher Tag pro Lauf mehrere E-Mails erzeugen.

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * Mail.Send *(optional — Funktion: E-Mail-Bericht)*
    * *Sendet bei konfiguriertem EmailTo über Send-RjReportEmail eine Warn-E-Mail pro neu erkanntem Problem*
  * Organization.Read.All
    * *Liest /organization aus, 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*

### 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 wird ohne Berücksichtigung der Groß-/Kleinschreibung sowohl gegen den angezeigten Dienstnamen als auch gegen die Kurz-ID geprüft, sodass Intune zu Microsoft Intune passt. Gültige Namen finden Sie auf der Seite zum 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 zurück nach neu angekündigten Problemen gesucht werden soll. Setzen Sie dies auf dasselbe Intervall wie den Runbook-Zeitplan, beispielsweise 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 Warnung aus. Wenn auf true gesetzt, werden auch Hinweise gemeldet.

| Eigenschaft           | Wert                                       |
| --------------------- | ------------------------------------------ |
| Erforderlich          | falsch                                     |
| Standardwert          | Falsch                                     |
| Typ                   | Boolescher Wert                            |
| Anzeigename im Portal | Hinweise einschließen (nicht nur Vorfälle) |

#### IncludeResolvedIssues

Wenn auf false gesetzt, werden Probleme übersprungen, die Microsoft bereits als behoben markiert hat, wenn das Runbook ausgeführt wird. Wenn auf true gesetzt, werden auch behobene Probleme gemeldet.

| Eigenschaft           | Wert                                   |
| --------------------- | -------------------------------------- |
| Erforderlich          | falsch                                 |
| Standardwert          | Falsch                                 |
| Typ                   | Boolescher Wert                        |
| Anzeigename im Portal | Bereits behobene Probleme einschließen |

#### EmailFrom

Die Absender-E-Mail-Adresse, die für die Warn-E-Mails pro Problem verwendet wird. Diese muss in der Runbook-Anpassung konfiguriert werden.

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

#### BrandingHeaderImageUrl

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

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

#### BrandingFooterImageUrl

Optionale öffentliche HTTPS-URL eines benutzerdefinierten Fußzeilenbilds (PNG/JPEG/GIF, max. 200 KB) für die Warn-E-Mails. Stammt aus der Mandanten-Einstellung RJReport.Branding.FooterImageUrl. Wenn leer, wird die standardmäßige RealmJoin-Fußzeilengrafik 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 Tenant-Einstellung RJReport.Branding.FooterLink. Wenn leer, wird der Standardlink (<https://www.realmjoin.com>) verwendet.

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

#### BrandingAccentColor

Optionale Überschreibung der Akzentfarbe (6-stelliger Hex-Wert, z. B. '#0052cc') für die Vorlage der Bericht-E-Mail. Stammt aus der Tenant-Einstellung RJReport.Branding.AccentColor. Wenn leer oder ungültig, wird die standardmäßige 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-stelliger Hex-Wert) für die Vorlage der Bericht-E-Mail. Stammt aus der Tenant-Einstellung RJReport.Branding.TextColor. Wenn leer oder ungültig, wird die standardmäßige Textfarbe von RealmJoin verwendet.

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

#### EmailTo

Durch Kommas getrennte Liste von E-Mail-Adressen der Empfänger für die Warn-E-Mails pro Problem. 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 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 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.