> 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/devices/report-stale-devices_scheduled.md).

# Bericht über veraltete Geräte, geplant

Geräte melden, die zu lange inaktiv waren

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

### Beschreibung

Listet Intune-Geräte auf, die sich seit einer bestimmten Anzahl von Tagen nicht gemeldet haben, optional innerhalb eines maximalen Alters. Die Liste kann nach Plattform und nach Gruppenmitgliedschaft des primären Benutzers gefiltert werden; die Ausschlussgruppe überspringt auch Geräte, die selbst Mitglieder sind. Es wird nichts geändert. Der Bericht kann per E-Mail gesendet oder als Download-Link bereitgestellt werden.

### Häufige Anwendungsfälle

* Regelmäßige Gerätebestandsprüfungen und Compliance-Berichte
* Geräte für die Außerbetriebnahme oder Stilllegung identifizieren
* Sicherheitsüberprüfungen zum Auffinden möglicherweise verlorener Geräte
* Überwachung des Gerätezustands im gesamten Unternehmen
* Gestufte Berichterstattung mit einer maximalen Inaktivität, zum Beispiel 30 bis 60 Tage und 60 bis 90 Tage
* Filterung des Benutzerbereichs, um sich auf bestimmte Abteilungen zu konzentrieren oder Dienstkonten auszuschließen

### Inaktivitätsbereich

Eine *Maximale Tage ohne Aktivität* gilt nur, wenn es darüber liegt *Tage ohne Aktivität*. Ein niedrigerer oder gleicher Wert wird mit einer Warnung ignoriert, und der Bericht listet alle Geräte auf, die seit mindestens *Tage ohne Aktivität*.

### Filterung des Benutzerbereichs

Das Runbook kann Geräte basierend auf der Gruppenmitgliedschaft ihres primären Benutzers ein- oder ausschließen. Der Filter wird angewendet, sobald in *Benutzer aus Gruppe einbeziehen* oder *Benutzer aus Gruppe ausschließen*; beide können kombiniert werden. Mitglieder verschachtelter Gruppen werden ebenfalls berücksichtigt.

Mit einer Einschlussgruppe werden nur Geräte gemeldet, deren primärer Benutzer Mitglied ist; Geräte ohne primären Benutzer werden ausgelassen. Die Ausschlussgruppe überspringt Geräte, deren primärer Benutzer Mitglied ist, sowie Geräte, deren Entra ID-Geräteobjekt selbst Mitglied der Gruppe ist, sodass eine Gerätegruppe verwendet werden kann, um Geräte aus dem Bericht auszuschließen. Wenn eine ausgewählte Gruppe nicht gelesen werden kann, wird der Lauf mit einem Fehler beendet, statt eine ungefilterte Liste zu melden.

Frühere Versionen fragten *Nach primärer Benutzergruppe filtern?* bevor die Gruppenauswahlen angezeigt wurden. Diese Option gibt es nicht mehr; damit erstellte Zeitpläne funktionieren weiterhin, und die darin gespeicherten Gruppen werden nun direkt angewendet.

### Berichtsübermittlung

Berichtsdateien werden nur generiert, wenn über die **Berichtsübermittlung** Option (E-Mail und/oder Downloadlink). Mit *Nur Output Data* Ausgewählt werden die Ergebnisse direkt im Tab Output Data des RealmJoin-Portals gelesen, wo jede Tabelle auch nach Excel exportiert werden kann. E-Mail-Versand und die Erstellung eines Download-Links sind unabhängig und können kombiniert werden.

Für den Downloadlink werden die Berichtsdateien in den Azure Storage Account hochgeladen, der in den `RJReport.StorageAccount.*` Tenant-Einstellungen konfiguriert ist, und zeitlich begrenzte SAS-Downloadlinks werden zurückgegeben. Der Upload in den Speicher authentifiziert sich mit der verwalteten Identität des Automation Accounts; diese Identität benötigt die **Reader and Data Access** RBAC-Rolle auf dem Ziel-Storage Account (dies ist eine Azure-RBAC-Zuweisung und keine Graph-Anwendungsberechtigung).

Zeitpläne, die vor der **Berichtsübermittlung** Option existierte, senden ihre E-Mail weiterhin: Ein allein gespeicherter Empfänger aktiviert die E-Mail für sie weiterhin. Wenn ein solcher Zeitplan zur Bearbeitung geöffnet wird, zeigt die Option *Nur Output Data*; wählen Sie die Zustellungsart vor dem Speichern erneut aus, andernfalls sendet der Zeitplan den Bericht nicht mehr.

Wenn der E-Mail-Versand ausgewählt ist, wird auch dann eine E-Mail gesendet, wenn kein Gerät veraltet ist; sie listet auf, was geprüft wurde.

### Einrichtung in Bezug auf den E-Mail-Versand

Das Senden eines Berichts per E-Mail ist optional und erfolgt nur, wenn *Den Bericht zusätzlich per E-Mail senden* oder *Den Bericht zusätzlich per E-Mail und Downloadlink senden* ist als Berichtsübermittlung ausgewählt; dann ist ein Empfänger erforderlich. Die Absenderadresse wird aus dem `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 Anpassung des Runbooks 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 Berichts-E-Mail berücksichtigt die optionalen `RJReport.Branding.*` Tenant-Einstellungen:

* **Header- und Footer-Bild** - öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB jeweils
* **Footer-Link** - Ziel des Footer-Bildes
* **Akzent- und Textfarbe** - 6-stellige Hexwerte, 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 Berichts-E-Mail – stattdessen wird der entsprechende Standard verwendet.

Einrichtungsanweisungen und Bildanforderungen: [E-Mail-Branding](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Ort

Organisation → Geräte → Veraltete Geräte melden (geplant)

**Vollständiger Runbook-Name**

rjgit-org\_devices\_report-stale-devices\_scheduled

### Details

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

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
    * *Listet Intune-Geräte auf, gefiltert nach lastSyncDateTime, um veraltete Geräte zu finden*
  * Directory.Read.All
    * *Liest Mitglieder von Einschluss-/Ausschlussgruppen, Details des primären Benutzers und den Tenant-Namen*
  * Mail.Send *(optional — Funktion: E-Mail-Bericht)*
    * *Sendet die Berichts-E-Mail über Send-RjRbReportEmail, wenn die E-Mail-Zustellung ausgewählt ist*
  * Organization.Read.All *(optional — Funktion: E-Mail-Bericht)*
    * *Liest den Anzeigenamen des Tenant für den E-Mail-Betreff, den E-Mail-Text und die Dateinamen des Berichts*

#### Hinweise zu Berechtigungen

Azure Storage Account: Rolle 'Reader and Data Access' für die verwaltete Identität des Automation Accounts auf dem Ziel-Storage Account – der Upload ruft die Kontoschlüssel über listKeys ab (nur für die Downloadlink-Optionen erforderlich)

### Parameter

#### Tage

Geräte ohne Check-in seit mindestens dieser Anzahl von Tagen gelten als veraltet.

| Eigenschaft           | Wert                |
| --------------------- | ------------------- |
| Erforderlich          | falsch              |
| Standardwert          | 30                  |
| Typ                   | Int32               |
| Anzeigename im Portal | Tage ohne Aktivität |

#### MaxDays

Es werden nur Geräte berücksichtigt, die seit höchstens so vielen Tagen inaktiv sind. Leer lassen, wenn keine obere Grenze gelten soll. Ein Wert, der nicht über „Tage ohne Aktivität“ liegt, wird ignoriert.

| Eigenschaft           | Wert                         |
| --------------------- | ---------------------------- |
| Erforderlich          | falsch                       |
| Standardwert          |                              |
| Typ                   | Int32                        |
| Anzeigename im Portal | Maximale Tage ohne Aktivität |

#### Windows

Schließt Windows-Geräte ein.

| Eigenschaft           | Wert                        |
| --------------------- | --------------------------- |
| Erforderlich          | falsch                      |
| Standardwert          | Wahr                        |
| Typ                   | Boolesch                    |
| Anzeigename im Portal | Windows-Geräte einbeziehen? |

#### macOS

Schließt macOS-Geräte ein.

| Eigenschaft           | Wert                      |
| --------------------- | ------------------------- |
| Erforderlich          | falsch                    |
| Standardwert          | Wahr                      |
| Typ                   | Boolesch                  |
| Anzeigename im Portal | macOS-Geräte einbeziehen? |

#### iOS

Enthält iOS- und iPadOS-Geräte.

| Eigenschaft           | Wert                             |
| --------------------- | -------------------------------- |
| Erforderlich          | falsch                           |
| Standardwert          | Wahr                             |
| Typ                   | Boolesch                         |
| Anzeigename im Portal | iOS-/iPadOS-Geräte einschließen? |

#### Android

Enthält Android-Geräte.

| Eigenschaft           | Wert                         |
| --------------------- | ---------------------------- |
| Erforderlich          | falsch                       |
| Standardwert          | Wahr                         |
| Typ                   | Boolesch                     |
| Anzeigename im Portal | Android-Geräte einschließen? |

#### UseUserScope

Nicht mehr verwendet. Der Filter für die primäre Benutzergruppe wird angewendet, sobald in „Benutzer aus Gruppe einschließen“ oder „Benutzer aus Gruppe ausschließen“ eine Gruppe ausgewählt wird. Beibehalten, damit vorhandene Zeitpläne weiterhin funktionieren.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           | Falsch                                       |
| Typ                    | Boolesch                                     |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

#### IncludeUserGroup

Nur Geräte, deren primärer Benutzer direkt oder über verschachtelte Gruppen Mitglied dieser Gruppe ist. Leer lassen, um alle Geräte einzubeziehen.

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

#### ExcludeUserGroup

Überspringt Geräte, deren primärer Benutzer Mitglied dieser Gruppe ist, sowie Geräte, die selbst Mitglieder sind, direkt oder über verschachtelte Gruppen. Leer lassen, um keine zu überspringen.

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

#### SendEmailReport

Senden Sie den Bericht an die E-Mail-Adresse des Empfängers.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           | Falsch                                       |
| Typ                    | Boolesch                                     |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

#### EmailTo

Senden Sie den Bericht an diese Adressen. Mehrere mit Kommas trennen; jeder Empfänger erhält eine separate E-Mail.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           |                                              |
| Typ                    | Zeichenfolge                                 |
| Anzeigename im Portal  | Empfänger-E-Mail-Adresse(n)                  |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

#### EmailFrom

Absenderadresse der Berichts-E-Mail. Wird aus der Tenant-Einstellung RJReport.EmailSender übernommen.

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

#### BrandingHeaderImageUrl

Headerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Tenant-Einstellung RJReport.Branding.HeaderImageUrl übernommen; wenn leer, wird der standardmäßige RealmJoin-Header verwendet.

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

#### BrandingFooterImageUrl

Footerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Tenant-Einstellung RJReport.Branding.FooterImageUrl übernommen; wenn leer, wird der standardmäßige RealmJoin-Footer verwendet.

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

#### BrandingFooterLink

Link hinter dem Footerbild der Berichts-E-Mail. Wird aus der Tenant-Einstellung RJReport.Branding.FooterLink übernommen; wenn leer, wird realmjoin.com verwendet.

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

#### BrandingAccentColor

Akzentfarbe der Berichts-E-Mail als 6-stelliger Hex-Wert. Wird aus der Tenant-Einstellung RJReport.Branding.AccentColor übernommen; wenn leer oder ungültig, wird der RealmJoin-Standard verwendet.

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

#### BrandingTextColor

Textfarbe der Berichts-E-Mail als 6-stelliger Hex-Wert. Wird aus der Tenant-Einstellung RJReport.Branding.TextColor übernommen; wenn leer oder ungültig, wird der RealmJoin-Standard verwendet.

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

#### ReportFileFormat

Stellt den Bericht als CSV, als Excel-Arbeitsmappe oder beides bereit.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           | CSV & XLSX                                   |
| Typ                    | Zeichenfolge                                 |
| Anzeigename im Portal  | Format der Berichtdatei                      |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

**Portaloptionen**

| Portaloption | Wert       |
| ------------ | ---------- |
| CSV & XLSX   | CSV & XLSX |
| Nur CSV      | Nur CSV    |
| Nur XLSX     | Nur XLSX   |

#### CreateDownloadLink

Lädt den Bericht zusätzlich hoch und gibt einen Downloadlink zurück, der nach einigen Tagen abläuft.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           | Falsch                                       |
| Typ                    | Boolesch                                     |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

#### ContainerName

Speichercontainer, in den die Berichtdateien hochgeladen werden. Pro Runbook festlegen.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           | report-stale-devices                         |
| Typ                    | Zeichenfolge                                 |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

#### ResourceGroupName

Ressourcengruppe des Storage Account für Bericht-Uploads. Wird aus der Tenant-Einstellung RJReport.StorageAccount.ResourceGroup übernommen.

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

#### StorageAccountName

Storage Account für Bericht-Uploads. Wird aus der Tenant-Einstellung RJReport.StorageAccount.StorageAccountName übernommen.

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

#### SubscriptionId

Abonnement-ID des Storage Account für Bericht-Uploads. Wird aus der Tenant-Einstellung RJReport.StorageAccount.SubscriptionId übernommen; wenn leer, wird das Abonnement verwendet, bei dem sich die verwaltete Identität anmeldet.

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

#### LinkExpiryDays

Anzahl der Tage, die ein Downloadlink gültig bleibt. Wird aus der Tenant-Einstellung RJReport.StorageAccount.LinkExpiryDays übernommen.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           | 6                                            |
| Typ                    | Int32                                        |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

[Zur Übersicht der Runbook-Referenz zurück](https://docs.realmjoin.com/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/devices/report-stale-devices_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.
