Veraltete Geräte löschen, geplant
Intune-Geräte löschen, die zu lange inaktiv waren
Beschreibung
Findet Intune-Geräte, die sich seit einer bestimmten Anzahl von Tagen nicht mehr gemeldet haben, gefiltert nach Plattform und optional nach der Gruppenmitgliedschaft ihres primären Benutzers. Standardmäßig wird nur aufgelistet, was gelöscht würde; das Löschen muss ausdrücklich 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 basierend auf Inaktivität, also verwenden Sie es mit Vorsicht.
Regelmäßige Bereinigung veralteter Geräteeinträge in Intune
Simulationsläufe (nur-Bericht-Modus) vor dem Aktivieren der tatsächlichen Löschung
Geplante Lifecycle-Verwaltung mit Prüfprotokoll ü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ären Benutzers ein- oder auszuschließen. Dies dient als zusätzliche Sicherheitsmaßnahme, wenn das Löschen aktiviert ist.
Einrichtung 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 Mandanten-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 Runbook-Anpassung eine vorhandene E-Mail-Adresse konfigurieren.
Siehe die RealmJoin Report Settings Dokumentation für Details zu allen verfügbaren Einstellungen.
E-Mail-Branding
Die Berichts-E-Mail berücksichtigt die optionalen RJReport.Branding.* Mandanten-Einstellungen:
Header- und Footer-Bild – öffentliche HTTPS-URLs, PNG/JPEG/GIF, jeweils max. 200 KB
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.
Ort
Organisation → Geräte → Veraltete Geräte löschen (geplant)
Vollständiger Runbook-Name
rjgit-org_devices_delete-stale-devices_scheduled
Details
Version
2.2.0
Erforderliche Module
RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.5.2)
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-/Ausschlussgruppen, Details des primären Benutzers und den Tenant-Namen
Mail.Send (optional — Funktion: E-Mail-Bericht)
Sendet die Bericht-E-Mail über Send-RjReportEmail, wenn EmailTo konfiguriert ist
Parameter
Tage
Geräte ohne Check-in seit mindestens so vielen Tagen gelten als veraltet.
Erforderlich
nein
Standardwert
30
Typ
Int32
Anzeigename im Portal
Tage ohne Aktivität
Windows
Enthält Windows-Geräte.
Erforderlich
nein
Standardwert
Wahr
Typ
Boolesch
Anzeigename im Portal
Windows-Geräte einbeziehen?
macOS
Enthält macOS-Geräte.
Erforderlich
nein
Standardwert
Wahr
Typ
Boolesch
Anzeigename im Portal
macOS-Geräte einbeziehen?
iOS
Schließt iOS- und iPadOS-Geräte ein.
Erforderlich
nein
Standardwert
Wahr
Typ
Boolesch
Anzeigename im Portal
iOS-Geräte einschließen?
Android
Schließt Android-Geräte ein.
Erforderlich
nein
Standardwert
Wahr
Typ
Boolesch
Anzeigename im Portal
Android-Geräte einschließen?
Geräte löschen
Löschen entfernt die veralteten Geräte aus Intune. Nur-Bericht listet sie nur auf und ändert nichts.
Erforderlich
nein
Standardwert
Falsch
Typ
Boolesch
Anzeigename im Portal
Löschmodus
Portaloptionen
Nur-Bericht - anzeigen, was gelöscht würde (Simulation)
nein
Veraltete Geräte aus Intune löschen
ja
EmailFrom
Absenderadresse der Berichts-E-Mail. Wird aus der Mandanten-Einstellung RJReport.EmailSender übernommen.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
BrandingHeaderImageUrl
Headerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanten-Einstellung RJReport.Branding.HeaderImageUrl übernommen; bei leerem Wert wird der standardmäßige RealmJoin-Header verwendet.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
BrandingFooterImageUrl
Footerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanten-Einstellung RJReport.Branding.FooterImageUrl übernommen; bei leerem Wert wird der standardmäßige RealmJoin-Footer verwendet.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
BrandingFooterLink
Link hinter dem Footerbild der Berichts-E-Mail. Wird aus der Mandanten-Einstellung RJReport.Branding.FooterLink übernommen; bei leerem Wert wird realmjoin.com verwendet.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
BrandingAccentColor
Akzentfarbe der Berichts-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanten-Einstellung RJReport.Branding.AccentColor übernommen; bei leerem oder ungültigem Wert wird der Standard von RealmJoin verwendet.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
BrandingTextColor
Textfarbe der Berichts-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanten-Einstellung RJReport.Branding.TextColor übernommen; bei leerem oder ungültigem Wert wird der Standard von RealmJoin verwendet.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
ReportFileFormat
Stellen Sie den Bericht als CSV, als Excel-Arbeitsmappe oder beides bereit.
Erforderlich
nein
Standardwert
CSV & XLSX
Typ
Zeichenfolge
Anzeigename im Portal
Berichtsdateiformat
Portaloptionen
CSV & XLSX
CSV & XLSX
Nur CSV
Nur CSV
Nur XLSX
Nur XLSX
CreateDownloadLink
Laden Sie den Bericht außerdem hoch und geben Sie einen Downloadlink zurück, der nach einigen Tagen abläuft.
Erforderlich
nein
Standardwert
Falsch
Typ
Boolesch
Anzeigename im Portal
Einen Downloadlink erstellen?
Portaloptionen
Ja - Bericht hochladen und einen Downloadlink zurückgeben
ja
Nein - keinen Downloadlink erstellen
nein
ContainerName
Speichercontainer, in den die Berichtsdateien hochgeladen werden. Pro Runbook festlegen.
Erforderlich
nein
Standardwert
delete-stale-devices
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
ResourceGroupName
Ressourcengruppe des Storage Account für Berichtshochladungen. Aus der Tenant-Einstellung RJReport.StorageAccount.ResourceGroup übernommen.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
StorageAccountName
Storage Account für Berichtshochladungen. Aus der Tenant-Einstellung RJReport.StorageAccount.StorageAccountName übernommen.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
LinkExpiryDays
Anzahl der Tage, die ein Downloadlink gültig bleibt. Aus der Tenant-Einstellung RJReport.StorageAccount.LinkExpiryDays übernommen.
Erforderlich
nein
Standardwert
6
Typ
Int32
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
UseUserScope
Ob Geräte nach der Gruppenmitgliedschaft ihres primären Benutzers gefiltert werden. Wird durch die Auswahl "Nach Gruppe des primären Benutzers filtern?" festgelegt.
Erforderlich
nein
Standardwert
Falsch
Typ
Boolesch
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
IncludeUserGroup
Nur Geräte, deren primärer Benutzer in dieser Gruppe ist.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Anzeigename im Portal
Benutzer aus Gruppe einbeziehen
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
ExcludeUserGroup
Überspringt Geräte, deren primärer Benutzer in dieser Gruppe ist.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Anzeigename im Portal
Benutzer aus Gruppe ausschließen
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
EmailTo
Senden Sie den Bericht an diese Adressen. Trennen Sie mehrere mit Kommas; jeder Empfänger erhält eine separate E-Mail.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Anzeigename im Portal
E-Mail-Adresse(n) des Empfängers
Zuletzt aktualisiert
War das hilfreich?