# Benutzer über veraltete Geräte benachrichtigen geplant

### Beschreibung

Identifiziert Geräte, die seit einer bestimmten 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 Ein- oder Ausschließen bestimmter Gruppen gefiltert werden.

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

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.

Dieser Prozess 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.

### Sprachauswahl für die 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. **Kundenspezifische**: 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 benutzerdefinierter Vorlagenparameter fehlt, fällt 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 über den Gerätedetails.** \n\nSehr geehrter Benutzer ..."
                },
                "CustomMailTemplateAfterDeviceDetails": {
                    "Default": "**Dies steht unter den 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 benutzerdefinierten Vorlagenparameter (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 "Custom - Use Template from Runbook Customizations" im Dropdown-Menü der E-Mail-Vorlage

### Ort

Organization → Devices → Notify Users About Stale Devices (Scheduled)

**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 (Mindestschwelle).

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

#### MaxDays

Optionale maximale Anzahl von Tagen ohne Aktivität. Wenn gesetzt, werden nur Geräte einbezogen, 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 | True    |
| Typ          | Boolean |

#### MacOS

macOS-Geräte in die Ergebnisse einbeziehen.

| Eigenschaft  | Wert    |
| ------------ | ------- |
| Erforderlich | false   |
| Standardwert | True    |
| Typ          | Boolean |

#### iOS

iOS-Geräte in die Ergebnisse einbeziehen.

| Eigenschaft  | Wert    |
| ------------ | ------- |
| Erforderlich | false   |
| Standardwert | True    |
| Typ          | Boolean |

#### Android

Android-Geräte in die Ergebnisse einbeziehen.

| Eigenschaft  | Wert    |
| ------------ | ------- |
| Erforderlich | false   |
| Standardwert | True    |
| Typ          | Boolean |

#### 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 Desks für Kontaktinformationen des Benutzers (optional).

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

#### ServiceDeskEmail

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

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

#### ServiceDeskPhone

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

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

#### UseUserScope

Aktivieren Sie die Filterung des Benutzerbereichs, um Benutzer basierend auf der Gruppenzugehörigkeit ein- oder auszuschließen.

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

#### 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 Endbenutzer gesendet werden. Kann für mehrere Empfänger durch Kommas getrennt werden. Ideal für Tests, Pilotierungen oder zum 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 Betreffzeile der E-Mail (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 (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 (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](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references)