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

# Veraltete Geräte löschen, geplant

Intune-Geräte löschen, 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

Findet Intune-Geräte, die sich seit einer bestimmten Anzahl von Tagen nicht mehr gemeldet haben, gefiltert nach Plattform und optional nach Gruppenmitgliedschaft. Eine Einschlussgruppe begrenzt die Ausführung auf die Geräte ihrer Benutzer; eine Ausschlussgruppe schützt die Geräte ihrer Benutzer und Geräte, die selbst Mitglieder sind. Standardmäßig wird nur aufgelistet, was gelöscht würde; das Löschen muss explizit aktiviert werden. Der Bericht kann per E-Mail gesendet oder als Download-Link bereitgestellt werden.

### Häufige Anwendungsfälle

Dieses Runbook löscht verwaltete Geräte aus Intune anhand von Inaktivität, also verwenden Sie es mit Vorsicht.

* Regelmäßige Bereinigung veralteter Geräteeinträge in Intune
* Simulationsläufe (Nur-Bericht-Modus) vor der Aktivierung des tatsächlichen Löschens
* Geplante Lebenszyklusverwaltung mit Prüfprotokoll über den E-Mail-Bericht

### Inaktivitätsschwelle

*Tage ohne Aktivität* Akzeptiert 1 bis 3650 Tage. Ein Gerät gilt als veraltet, wenn sein letzter Check-in mindestens so viele Tage zurückliegt.

### Filterung des Benutzerbereichs

Das Runbook unterstützt optionales Filtern nach Gruppen als zusätzliche Sicherheitsmaßnahme, wenn das Löschen aktiviert ist. Mitglieder verschachtelter Gruppen werden ebenfalls berücksichtigt.

* **Einschlussgruppe** - nur Geräte, deren primärer Benutzer Mitglied ist, werden berücksichtigt. Geräte ohne primären Benutzer und Geräte, deren primärer Benutzer aus Entra ID gelöscht wurde, werden ausgeschlossen.
* **Ausschlussgruppe** - Geräte, deren primärer Benutzer Mitglied ist, werden übersprungen, ebenso Geräte, deren Entra ID-Geräteobjekt selbst Mitglied der Gruppe ist. Eine Gerätegruppe wie „Intune - nicht löschen“ schützt daher ihre Geräte. Geräte gelöschter Benutzer bleiben im Geltungsbereich.

Die Gruppenmitgliedschaft wird anhand der von Intune erfassten Objekt-ID des primären Benutzers geprüft, sodass ein geänderter Benutzerprinzipalname den Filter nicht beeinflusst.

Eine Gruppe wird immer angewendet, wenn sie festgelegt ist, auch wenn das Runbook über die API oder per Zeitplan ohne die *Nach primärer Benutzergruppe filtern?* Auswahl. Bei Auswahl von *Ja, nach Gruppenmitgliedschaft filtern* ohne eine Gruppe auszuwählen, wird die Ausführung gestoppt, bevor etwas gelöscht wird.

Der Filter schlägt im Fehlerfall sicher fehl:

* Wenn eine ausgewählte Gruppe nicht gelesen werden kann oder die Einschlussgruppe keine Benutzer enthält, wird die Ausführung mit einem Fehler gestoppt und kein Gerät gelöscht.
* Wenn Intune für ein Gerät einen primären Benutzer, aber keine Benutzerobjekt-ID erfasst, wird das Gerät nicht gelöscht. Es wird mit dem Status aufgelistet *Übersprungen: primärer Benutzer konnte nicht aufgelöst werden* zur manuellen Überprüfung.

### Download-Link

Wenn das Hochladen für den Download-Link fehlschlägt, werden der E-Mail-Bericht und die Ausgabedaten trotzdem zugestellt, sodass die Liste der gelöschten Geräte nicht verloren geht. Der Job endet dann als fehlgeschlagen.

### Einrichtung in Bezug auf 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` 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. jeweils 200 KB
* **Footer-Link** – Ziel des Footer-Bildes
* **Akzent- und Textfarbe** – 6-stellige Hex-Werte, 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 die Berichts-E-Mail niemals – 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 löschen (geplant)

**Vollständiger Runbook-Name**

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

### Details

| Eigenschaft          | Wert                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Version              | 2.3.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.ReadWrite.All
    * *Listet veraltete Intune-Geräte auf und löscht sie über DELETE /deviceManagement/managedDevices/{id}*
  * 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 EmailTo konfiguriert 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*

### Parameter

#### Tage

Geräte mit mindestens so vielen Tagen ohne Check-in gelten als veraltet. Zulässig sind 1 bis 3650 Tage.

| Eigenschaft           | Wert                |
| --------------------- | ------------------- |
| Erforderlich          | falsch              |
| Standardwert          | 30                  |
| Typ                   | Int32               |
| Anzeigename im Portal | 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-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? |

#### DeleteDevices

Löschen entfernt die veralteten Geräte aus Intune. Der Bericht listet sie nur auf und ändert nichts.

| Eigenschaft           | Wert       |
| --------------------- | ---------- |
| Erforderlich          | falsch     |
| Standardwert          | Falsch     |
| Typ                   | Boolesch   |
| Anzeigename im Portal | Löschmodus |

**Portaloptionen**

| Portaloption                                            | Wert   |
| ------------------------------------------------------- | ------ |
| Nur Bericht - anzeigen, was gelöscht würde (Simulation) | falsch |
| Veraltete Geräte aus Intune löschen                     | wahr   |

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

**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                      |
| Anzeigename im Portal | Einen Downloadlink erstellen? |

**Portaloptionen**

| Portaloption                                              | Wert   |
| --------------------------------------------------------- | ------ |
| Ja - Bericht hochladen und einen Downloadlink zurückgeben | wahr   |
| Nein - keinen Downloadlink erstellen                      | falsch |

#### ContainerName

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

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           | delete-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) |

#### UseUserScope

Wird durch die Auswahl „Nach primärer Benutzergruppe filtern?“ festgelegt; bei „Ja“ ist mindestens eine Gruppe erforderlich. Eine Gruppe in „Benutzer aus Gruppe einschließen“ oder „Benutzer aus Gruppe ausschließen“ wird immer angewendet, wenn sie festgelegt ist, auch ohne diese Auswahl.

| 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 Mitglied dieser Gruppe ist, direkt oder über verschachtelte Gruppen. Geräte ohne primären Benutzer werden ausgeschlossen.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           |                                              |
| Typ                    | Zeichenfolge                                 |
| Anzeigename im Portal  | Benutzer aus Gruppe einbeziehen              |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

#### ExcludeUserGroup

Überspringt Geräte, deren primärer Benutzer Mitglied dieser Gruppe ist, und Geräte, die selbst Mitglieder sind, direkt oder über verschachtelte Gruppen. Übersprungene Geräte werden nie gelöscht.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           |                                              |
| Typ                    | Zeichenfolge                                 |
| Anzeigename im Portal  | Benutzer aus Gruppe ausschließen             |
| 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) |

[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/delete-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.
