# Benutzer über veraltete Geräte benachrichtigen geplant

### Beschreibung

Identifiziert Geräte, die seit einer angegebenen Anzahl von Tagen nicht aktiv waren, und sendet personalisierte E-Mail-Benachrichtigungen an die primären Benutzer dieser Geräte. Die E-Mail enthält Geräteinformationen und Handlungsschritte für den Benutzer. Optional können Benutzer durch Einschließen oder Ausschließen bestimmter Gruppen gefiltert werden.

### Einrichtung bezüglich des E-Mail-Versands

Dieses Runbook sendet E-Mails mithilfe der 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.

Dieser Vorgang wird ausführlich beschrieben in der [Einrichtung der E-Mail-Berichterstattung](https://github.com/realmjoin/realmjoin-runbooks/tree/master/docs/general/setup-email-reporting.md) Dokumentation.

### Auswahl der Mail-Vorlagensprache

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. **Benutzerdefinierte**: Verwendet eine benutzerdefinierte Vorlage aus den Runbook-Anpassungen

#### Verwenden benutzerdefinierter Mail-Vorlagen

Um eine benutzerdefinierte 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, greift das Runbook automatisch auf die englische Vorlage zurück.

**Beispiel: Benutzerdefinierte Vorlage**

```json
{
    "Runbooks": {
        "rjgit-org_devices_notify-users-about-stale-devices_scheduled": {
            "Parameters": {
                "CustomMailTemplateSubject": {
                    "Default": "Dies ist ein benutzerdefinierter Betreff - Aktion erforderlich: Inaktive Geräte"
                },
                "CustomMailTemplateBeforeDeviceDetails": {
                    "Default": "**Dies steht oberhalb der Gerätedetails.** \n\nSehr geehrter Benutzer ..."
                },
                "CustomMailTemplateAfterDeviceDetails": {
                    "Default": "**Dies steht unterhalb der Gerätedetails.** \n\n## Was Sie tun sollten..."
                }
            }
        }
    }
}
```

**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 (Betreff, BeforeDeviceDetails, AfterDeviceDetails) sollten konfiguriert werden
* Wenn ein Parameter fehlt, greift das Runbook automatisch auf die englische (EN) Vorlage zurück
* Wenn Sie die benutzerdefinierte Vorlage verwenden, wählen Sie im Dropdown-Menü für die Mail-Vorlage "Benutzerdefiniert - Vorlage aus den Runbook-Anpassungen verwenden"

### Speicherort

Organisation → Geräte → Benutzer über veraltete Geräte benachrichtigen (geplant)

**Vollständiger Runbook-Name**

rjgit-org\_devices\_notify-users-about-stale-devices\_scheduled

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
  * Directory.Read.All
  * Device.Read.All
  * Group.Read.All
  * Mail.Send

### Parameter

#### Tage

Anzahl der Tage ohne Aktivität, ab der das Gerät als veraltet gilt (Mindestschwellenwert).

| Eigenschaft  | Wert  |
| ------------ | ----- |
| Erforderlich | false |
| Standardwert | 30    |
| Typ          | Int32 |

#### MaxDays

Optionale maximale Anzahl von Tagen ohne Aktivität. Wenn festgelegt, werden nur Geräte berücksichtigt, die zwischen Days und MaxDays inaktiv waren.

| Eigenschaft  | Wert  |
| ------------ | ----- |
| Erforderlich | false |
| Standardwert |       |
| Typ          | Int32 |

#### Windows

Windows-Geräte in die Ergebnisse einbeziehen.

| Eigenschaft  | Wert     |
| ------------ | -------- |
| Erforderlich | false    |
| Standardwert | Wahr     |
| Typ          | Boolesch |

#### MacOS

macOS-Geräte in die Ergebnisse einbeziehen.

| Eigenschaft  | Wert     |
| ------------ | -------- |
| Erforderlich | false    |
| Standardwert | Wahr     |
| Typ          | Boolesch |

#### iOS

iOS-Geräte in die Ergebnisse einbeziehen.

| Eigenschaft  | Wert     |
| ------------ | -------- |
| Erforderlich | false    |
| Standardwert | Wahr     |
| Typ          | Boolesch |

#### Android

Android-Geräte in die Ergebnisse einbeziehen.

| Eigenschaft  | Wert     |
| ------------ | -------- |
| Erforderlich | false    |
| Standardwert | Wahr     |
| Typ          | Boolesch |

#### EmailFrom

Die E-Mail-Adresse des Absenders. Diese muss in der Runbook-Anpassung konfiguriert werden.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### ServiceDeskDisplayName

Anzeigename des Service Desk für die Kontaktinformationen des Benutzers (optional).

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### ServiceDeskEmail

E-Mail-Adresse des Service Desk für die Kontaktinformationen des Benutzers (optional).

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### ServiceDeskPhone

Telefonnummer des Service Desk für die Kontaktinformationen des Benutzers (optional).

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### UseUserScope

Aktivieren Sie die Benutzerbereichsfilterung, um Benutzer basierend auf der Gruppenmitgliedschaft ein- oder auszuschließen.

| Eigenschaft  | Wert     |
| ------------ | -------- |
| Erforderlich | false    |
| Standardwert | False    |
| Typ          | Boolesch |

#### IncludeUserGroup

Senden Sie E-Mails nur an Benutzer, die Mitglieder dieser Gruppe sind. Erfordert, dass UseUserScope aktiviert ist.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### ExcludeUserGroup

Senden Sie keine E-Mails an Benutzer, die Mitglieder dieser Gruppe sind. Erfordert, dass UseUserScope aktiviert ist.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### OverrideEmailRecipient

Optional: E-Mail-Adresse(n), an die alle Benachrichtigungen statt an die Endbenutzer gesendet werden. Mehrere Empfänger können durch Kommas getrennt angegeben werden. Ideal für Tests, Pilotprojekte oder das Senden an Ticketsysteme. Wenn leer gelassen, werden E-Mails an die tatsächlichen Endbenutzer gesendet.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### 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 | false        |
| Standardwert | EN           |
| Typ          | Zeichenfolge |

#### CustomMailTemplateSubject

Benutzerdefinierte E-Mail-Betreffzeile (wird nur verwendet, wenn MailTemplateLanguage auf 'Custom' gesetzt ist).

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### 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 | false        |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### CustomMailTemplateAfterDeviceDetails

Benutzerdefinierter Text, der nach der Geräteliste angezeigt wird (wird nur verwendet, wenn MailTemplateLanguage auf 'Custom' gesetzt ist). Unterstützt Markdown-Formatierung.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert |              |
| Typ          | Zeichenfolge |

[Zurück zur Übersicht der Runbook-Referenz](/de/automatisierung/runbooks/runbook-references.md)


---

# Agent Instructions: 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:

```
GET https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/devices/notify-users-about-stale-devices_scheduled.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.