> 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 Geplantes Löschen veralteter Geräte basierend auf letztem Aktivitätsdatum und Plattform {% hint style="info" %} Dies ist ein geplantes Runbook. Es ist so konzipiert, dass es nach einem wiederkehrenden Zeitplan ausgeführt wird, statt für ein einzelnes Objekt ausgelöst zu werden. Siehe [Zeitplanung](/de/automatisierung/runbooks/scheduling.md) für Details zur Konfiguration von Runbook-Zeitplänen. {% endhint %} ### Beschreibung Identifiziert von Intune verwaltete Geräte, die seit einer angegebenen Anzahl von Tagen nicht aktiv waren. Standardmäßig läuft das Runbook im Nur-Bericht-Modus (Simulation) und listet die Geräte auf, die gelöscht würden. Wenn das Löschen aktiviert ist, werden die passenden Geräte aus Intune gelöscht und die Ergebnisse in den Bericht aufgenommen. Ein E-Mail-Bericht mit CSV- und/oder Excel-(xlsx)-Anhängen kann optional gesendet werden, und die Berichtsdateien können außerdem in ein Azure Storage Account hochgeladen werden, wobei zeitlich begrenzte Download-Links zurückgegeben werden. ### Einstellungen zum 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 ü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 Runbook-Anpassung 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 Bericht-E-Mail berücksichtigt optional die `RJReport.Branding.*` Mandanteneinstellungen: * **Kopf- und Fußzeilenbild** – öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB jeweils * **Fußzeilenlink** – Ziel des Fußzeilenbilds * **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 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) **Vollständiger Runbook-Name** rjgit-org\_devices\_delete-stale-devices\_scheduled ### Details | Eigenschaft | Wert | | -------------------- | ----------------------------------------------------------------------------------------------------------------- | | Version | 2.2.0 | | Erforderliche Module |

RealmJoin.RunbookHelper (>= 0.8.9)
Microsoft.Graph.Authentication (>= 2.39.0)
Az.Accounts (>= 5.5.2)

| | Planbar | ja | ### Hinweise Dieses Runbook löscht verwaltete Geräte aus Intune basierend auf Inaktivität. Mit Vorsicht verwenden! Voraussetzungen: * Der Parameter EmailFrom muss in der Runbook-Anpassung (Einstellung RJReport.EmailSender) konfiguriert werden, wenn die E-Mail-Berichterstellung verwendet wird Häufige Anwendungsfälle: * Regelmäßige Bereinigung veralteter Geräteeinträge in Intune * Simulationsläufe (Nur-Bericht-Modus) vor Aktivierung des tatsächlichen Löschens * Geplantes Lebenszyklusmanagement mit Prüfnachweis per E-Mail-Bericht Das Runbook unterstützt optionales Filtern des Benutzerbereichs, um Geräte basierend auf der Mitgliedschaft in der primären Benutzergruppe einzuschließen oder auszuschließen. Dies dient als zusätzliche Sicherheitsmaßnahme, wenn das Löschen aktiviert ist. ### 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 der Ein-/Ausschlussgruppen, Details des primären Benutzers und den Tenant-Namen* * Mail.Send *(optional — Funktion: E-Mail-Bericht)* * *Sendet die Berichts-E-Mail über Send-RjReportEmail, wenn EmailTo konfiguriert ist* ### Parameter #### Tage Anzahl der Tage ohne Aktivität, ab der ein Gerät als veraltet gilt. | Eigenschaft | Wert | | --------------------- | ---------------------------- | | Erforderlich | falsch | | Standardwert | 30 | | Typ | Int32 | | Anzeigename im Portal | Minimale Tage ohne Aktivität | #### Windows Windows-Geräte in die Ergebnisse einschließen. | Eigenschaft | Wert | | --------------------- | -------------------------- | | Erforderlich | falsch | | Standardwert | Wahr | | Typ | Boolesch | | Anzeigename im Portal | Windows-Geräte einbeziehen | #### macOS macOS-Geräte in die Ergebnisse einschließen. | Eigenschaft | Wert | | --------------------- | ------------------------ | | Erforderlich | falsch | | Standardwert | Wahr | | Typ | Boolesch | | Anzeigename im Portal | macOS-Geräte einbeziehen | #### iOS iOS-Geräte in die Ergebnisse einschließen. | Eigenschaft | Wert | | --------------------- | ----------------------- | | Erforderlich | falsch | | Standardwert | Wahr | | Typ | Boolesch | | Anzeigename im Portal | iOS-Geräte einschließen | #### Android Android-Geräte in die Ergebnisse einschließen. | Eigenschaft | Wert | | --------------------- | --------------------------- | | Erforderlich | falsch | | Standardwert | Wahr | | Typ | Boolesch | | Anzeigename im Portal | Android-Geräte einschließen | #### DeleteDevices Wenn auf true gesetzt, werden die passenden veralteten Geräte aus Intune gelöscht. Wenn false (Standard), berichtet das Runbook nur, welche Geräte gelöscht würden (Simulation). | Eigenschaft | Wert | | --------------------- | ---------- | | Erforderlich | falsch | | Standardwert | Falsch | | Typ | Boolesch | | Anzeigename im Portal | Löschmodus | **Portal-Optionen** | Portal-Option | Wert | | ------------------------------------------------------- | ------ | | Nur-Bericht - anzeigen, was gelöscht würde (Simulation) | falsch | | Veraltete Geräte aus Intune löschen | wahr | #### EmailFrom Die Absender-E-Mail-Adresse. Diese muss in der Runbook-Anpassung konfiguriert werden | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### BrandingHeaderImageUrl Optionale öffentliche HTTPS-URL eines benutzerdefinierten Kopfzeilenbilds (PNG/JPEG/GIF, max. 200 KB) für die Bericht-E-Mail. Stammt aus der Mandanteneinstellung RJReport.Branding.HeaderImageUrl. Wenn leer, wird die standardmäßige RealmJoin-Kopfzeilengrafik verwendet. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### BrandingFooterImageUrl Optionale öffentliche HTTPS-URL eines benutzerdefinierten Fußzeilenbilds (PNG/JPEG/GIF, max. 200 KB) für die Bericht-E-Mail. Stammt aus der Mandanteneinstellung RJReport.Branding.FooterImageUrl. Wenn leer, wird die standardmäßige RealmJoin-Fußzeilengrafik verwendet. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### BrandingFooterLink Optionale URL, auf die das Fußzeilenbild verweist. Stammt aus der Mandanteneinstellung RJReport.Branding.FooterLink. Wenn leer, wird der Standardlink () verwendet. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### BrandingAccentColor Optionale Überschreibung der Akzentfarbe (6-stelliger Hex-Wert, z. B. '#0052cc') für die Bericht-E-Mail-Vorlage. Stammt aus der Mandanteneinstellung RJReport.Branding.AccentColor. Wenn leer oder ungültig, wird die standardmäßige RealmJoin-Akzentfarbe verwendet. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### BrandingTextColor Optionale Überschreibung der Textfarbe (6-stelliger Hex-Wert) für die Bericht-E-Mail-Vorlage. Stammt aus der Mandanteneinstellung RJReport.Branding.TextColor. Wenn leer oder ungültig, wird die standardmäßige RealmJoin-Textfarbe verwendet. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### ReportFileFormat Steuert, welche Berichtdateiformate erzeugt und bereitgestellt werden: "nur CSV", "CSV & XLSX" (Standard) oder "nur XLSX". | Eigenschaft | Wert | | --------------------- | ------------------ | | Erforderlich | falsch | | Standardwert | CSV & XLSX | | Typ | Zeichenfolge | | Anzeigename im Portal | Berichtdateiformat | **Portal-Optionen** | Portal-Option | Wert | | ------------- | ---- | | CSV & XLSX | | | nur CSV | | | nur XLSX | | #### CreateDownloadLink Wenn aktiviert, werden die Berichtdateien in ein Azure Storage Account hochgeladen und zeitlich begrenzte Download-Links zurückgegeben. Standardmäßig deaktiviert. | Eigenschaft | Wert | | --------------------- | ------------------------------------------------------------------------ | | Erforderlich | falsch | | Standardwert | Falsch | | Typ | Boolesch | | Anzeigename im Portal | Einen Datei-Download-Link erstellen (Bericht in den Speicher hochladen)? | **Portal-Optionen** | Portal-Option | Wert | | ---------------------------------------------------------- | ------ | | Ja - Bericht hochladen und einen Download-Link zurückgeben | wahr | | Nein - keinen Download-Link erstellen | falsch | #### ContainerName Name des Speicherkontext-Containers, der für den Upload verwendet wird. Pro Runbook konfiguriert (keine globale RJReport-Einstellung). | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | delete-stale-devices | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### ResourceGroupName Ressourcengruppe, die das Speicherkonto enthält. Stammt aus den Mandanten-Einstellungen von RJReport. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### StorageAccountName Name des Speicherkontos, das für den Upload verwendet wird. Stammt aus den Mandanten-Einstellungen von RJReport. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### LinkExpiryDays Anzahl der Tage, bis der generierte Download-Link abläuft. Stammt aus den Mandanten-Einstellungen von RJReport. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | 6 | | Typ | Int32 | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### UseUserScope Aktivieren Sie die Filterung des Benutzerbereichs, um Geräte basierend auf der Mitgliedschaft der primären Benutzergruppe einzuschließen oder auszuschließen. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | Falsch | | Typ | Boolesch | | Anzeigename im Portal | Benutzerbereichsfilterung verwenden | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### IncludeUserGroup Nur Geräte einschließen, deren primäre Benutzer Mitglieder dieser Gruppe sind. Erfordert, dass UseUserScope aktiviert ist. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Anzeigename im Portal | Einzuschließende Benutzer (Gruppe) | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### ExcludeUserGroup Geräte ausschließen, deren primäre Benutzer Mitglieder dieser Gruppe sind. Erfordert, dass UseUserScope aktiviert ist. | Eigenschaft | Wert | | ---------------------- | ------------------------------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Anzeigename im Portal | Auszuschließende Benutzer (Gruppe) | | Im Portal ausgeblendet | ja (vorgabemäßig über die Runbook-Anpassung festgelegt) | #### EmailTo Falls angegeben, wird eine E-Mail mit dem Bericht an die bereitgestellte(n) Adresse(n) gesendet. Kann eine einzelne Adresse oder mehrere durch Kommas getrennte Adressen (string) sein. Die Funktion sendet aus Datenschutzgründen einzelne E-Mails an jeden Empfänger. | Eigenschaft | Wert | | --------------------- | -------------------------------- | | Erforderlich | falsch | | Standardwert | | | Typ | Zeichenfolge | | Anzeigename im Portal | E-Mail-Adresse(n) des Empfängers | [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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/devices/delete-stale-devices_scheduled.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.