> 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 geplanter Runbook-Lauf. Er ist dafür ausgelegt, nach einem wiederkehrenden Zeitplan ausgeführt zu werden, anstatt für ein einzelnes Objekt ausgelöst zu werden. Siehe [Planung](/de/automatisierung/runbooks/scheduling.md) für Details dazu, wie Runbook-Zeitpläne konfiguriert werden.
{% endhint %}

### Beschreibung

Findet Intune-Geräte, die sich seit einer angegebenen Anzahl von Tagen nicht gemeldet haben, gefiltert nach Plattform und optional nach der Gruppenmitgliedschaft ihres Primärbenutzers. Standardmäßig wird nur angezeigt, 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 auf Grundlage von Inaktivität, verwenden Sie es daher mit Vorsicht.

* Regelmäßige Bereinigung veralteter Geräteeinträge in Intune
* Simulationsläufe (nur Berichtsmodus) vor dem Aktivieren der tatsächlichen Löschung
* Geplantes Lebenszyklusmanagement mit Prüfpfad über den E-Mail-Bericht

### Filterung des Benutzerbereichs

Das Runbook unterstützt optionales Filtern des Benutzerbereichs, um Geräte basierend auf der Gruppenmitgliedschaft ihres Primärbenutzers einzuschließen oder auszuschließen. Dies dient als zusätzliche Sicherheitsstufe, wenn das Löschen aktiviert ist.

### Konfiguration für 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` Mandanteneinstellung bezogen.

Dieses Runbook sendet E-Mails über die 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.

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 Bericht-E-Mail berücksichtigt die optionalen `RJReport.Branding.*` Mandanteneinstellungen:

* **Kopf- und Fußzeilenbild** – öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB jeweils
* **Fußzeilenlink** – Ziel des Fußzeilenbildes
* **Akzent- und Textfarbe** – 6-stellige Hex-Werte, z. B. `#0052cc`

Wenn diese Einstellungen nicht konfiguriert sind, werden die Standardgrafiken und -farben von RealmJoin verwendet. Ein Bild, das nicht heruntergeladen oder validiert werden kann, oder ein ungültiger Farbwert verhindert niemals die Bericht-E-Mail – stattdessen wird der entsprechende Standardwert verwendet.

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

### Speicherort

Organisation → Geräte → Veraltete Geräte löschen (geplant)

**Voller Runbook-Name**

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

### Details

| Eigenschaft          | Wert                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Version              | 2.2.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 die Mitglieder der Einschluss-/Ausschlussgruppe, Details des primären Benutzers und den Namen des Tenant*
  * Mail.Send *(optional — Funktion: E-Mail-Bericht)*
    * *Sendet die Berichts-E-Mail über Send-RjReportEmail, wenn EmailTo konfiguriert ist*

### Parameter

#### Tage

Geräte ohne Meldung seit mindestens so vielen Tagen gelten als veraltet.

| 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 einschließen? |

#### MacOS

Schließt macOS-Geräte ein.

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

#### iOS

Bezieht iOS- und iPadOS-Geräte ein.

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

#### Android

Bezieht Android-Geräte ein.

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

#### 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 Bericht-E-Mail. Wird aus der Mandanteneinstellung RJReport.EmailSender übernommen.

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

#### BrandingHeaderImageUrl

Kopfzeilenbild der Bericht-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanteneinstellung RJReport.Branding.HeaderImageUrl übernommen; wenn leer, wird der standardmäßige RealmJoin-Kopfbereich verwendet.

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

#### BrandingFooterImageUrl

Fußzeilenbild der Bericht-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanteneinstellung RJReport.Branding.FooterImageUrl übernommen; wenn leer, wird die standardmäßige RealmJoin-Fußzeile verwendet.

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

#### BrandingFooterLink

Link hinter dem Fußzeilenbild der Bericht-E-Mail. Wird aus der Mandanteneinstellung RJReport.Branding.FooterLink übernommen; wenn leer, wird realmjoin.com verwendet.

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

#### BrandingAccentColor

Akzentfarbe der Bericht-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanteneinstellung RJReport.Branding.AccentColor übernommen; wenn leer oder ungültig, wird der standardmäßige RealmJoin-Wert verwendet.

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

#### BrandingTextColor

Textfarbe der Bericht-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanteneinstellung RJReport.Branding.TextColor übernommen; wenn leer oder ungültig, wird der standardmäßige RealmJoin-Wert verwendet.

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

#### ReportFileFormat

Liefern Sie den Bericht als CSV, als Excel-Arbeitsmappe oder beides.

| Eigenschaft           | Wert                |
| --------------------- | ------------------- |
| Erforderlich          | falsch              |
| Standardwert          | CSV & XLSX          |
| Typ                   | Zeichenfolge        |
| Anzeigename im Portal | Berichtsdateiformat |

**Portaloptionen**

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

#### CreateDownloadLink

Lädt den Bericht außerdem 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 Berichtsdateien hochgeladen werden. Pro Runbook festlegen.

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

#### ResourceGroupName

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

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

#### StorageAccountName

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

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

#### LinkExpiryDays

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

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

#### UseUserScope

Ob Geräte nach der Gruppenmitgliedschaft ihres Primärbenutzers gefiltert werden. Wird durch die Auswahl "Nach Primärbenutzergruppe filtern?" festgelegt.

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

#### IncludeUserGroup

Nur Geräte, deren Primärbenutzer in dieser Gruppe ist.

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

#### ExcludeUserGroup

Überspringt Geräte, deren Primärbenutzer in dieser Gruppe ist.

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

#### EmailTo

Senden Sie den Bericht an diese Adressen. Trennen Sie mehrere durch Kommas; 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ü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 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.