Autopilot-Geräte bereinigen, geplant
Verwaiste und nie registrierte Autopilot-Registrierungen entfernen
Beschreibung
Bereinigt Windows Autopilot-Registrierungen: Geräte, deren Seriennummer keinem Intune-Gerät mehr entspricht (verwaist), und optional Geräte, die sich nie registriert haben und älter als ein bestimmtes Alter sind. Standardmäßig meldet es nur, was es löschen würde; das Löschen muss ausdrücklich aktiviert werden und kann die passenden Entra ID-Geräteobjekte einschließen. Der Bericht kann per E-Mail gesendet oder als Download-Link bereitgestellt werden.
Das Löschen ist irreversibel
Das Entfernen einer Autopilot-Geräteidentität löscht sie dauerhaft aus Windows Autopilot. Für Autopilot-Datensätze gibt es kein Soft-Delete und keinen Papierkorb.
Das physische Gerät kann erst wieder in Autopilot aufgenommen werden, nachdem sein Hardware-Hash erneut hochgeladen wurde.
Das Löschen des Entra-Geräteobjekts ist ebenfalls dauerhaft; tun Sie dies nur für Datensätze, die wirklich tot sind, also wenn sich das Gerät nie wieder registrieren wird.
Empfohlener erster Lauf
Mit dem Löschmodus ausführen WhatIf (nur Bericht), was der Standard ist, und überprüfen Sie die Ausgabe oder die per E-Mail gesendete CSV-Datei.
Bestätigen Sie, dass die identifizierten Geräte tatsächlich verwaist sind oder sich nie registriert haben.
Wechseln Sie erst nach der Überprüfung der Kandidatenliste in einen Löschmodus.
Parameterwechselwirkungen
DeleteModeist standardmäßig WhatIf (nur Bericht); in diesem Modus erfolgen keine Löschungen.Autopilot-Gerät löschen entfernt nur die Autopilot-Identität. Autopilot- und Entra-Gerät löschen entfernt zusätzlich das passende Entra-Geräteobjekt, das sonst nach dem Entfernen der Autopilot-Identität als veralteter Datensatz zurückbleiben würde. Der zweite Modus erfordert die
Device.ReadWrite.AllBerechtigung hinzuzufügen.CleanupOrphanedDevicesundCleanupNeverEnrolledDevicessind unabhängig; entweder oder beide können aktiviert werden.NeverEnrolledAgeDaysgilt nur für die Prüfung auf nie registrierte Geräte.GroupTagFilter,HerstellerfilterundModellfiltersind optional; lassen Sie einen Filter leer, um alle Werte für diese Dimension auszuwerten. Wenn mehr als ein Filter gesetzt ist, werden sie mit UND verknüpft, sodass ein Gerät mit jedem ausgefüllten Filter übereinstimmen muss, um im Geltungsbereich zu bleiben.GroupTagFilterstimmt genau mit dem Gruppentag überein (ohne Beachtung der Groß-/Kleinschreibung);HerstellerfilterundModellfilterstimmen als Teilzeichenfolgen ohne Beachtung der Groß-/Kleinschreibung überein, sodass „Dell“ mit „Dell Inc.“ und „Surface“ mit „Surface Laptop 3“ übereinstimmt.ExcludeSerialNumberswird nach den UND-Filtern als Ausschluss angewendet: Ein Gerät, dessen Seriennummer in der Liste steht (genau, ohne Beachtung der Groß-/Kleinschreibung), wird unabhängig von den anderen Filtern aus dem Geltungsbereich entfernt. Lassen Sie das Feld leer, um nichts auszuschließen.
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 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.
Ort
Organisation → Geräte → Autopilot-Geräte bereinigen (geplant)
Vollständiger Runbook-Name
rjgit-org_devices_cleanup-autopilot-devices_scheduled
Details
Version
1.4.0
Erforderliche Module
RealmJoin.RunbookHelper (>= 0.8.10) Microsoft.Graph.Authentication (>= 2.41.2) Az.Accounts (>= 5.5.2)
Planbar
ja
Berechtigungen
Anwendungsberechtigungen
Typ: Microsoft Graph
Device.ReadWrite.All
Sucht Entra-Geräte anhand der deviceId und löscht sie im Modus „Autopilot- und Entra-Gerät löschen“
DeviceManagementManagedDevices.Read.All
Liest verwaltete Windows-Geräte aus Intune aus, um Autopilot-Seriennummern zu finden, die in Intune nicht mehr vorhanden sind
DeviceManagementServiceConfig.ReadWrite.All
Listet windowsAutopilotDeviceIdentities auf und löscht veraltete Autopilot-Identitäten
Mail.Send (optional — Funktion: E-Mail-Bericht)
Sendet die Bereinigungsbericht-E-Mail über Send-RjReportEmail, wenn EmailTo konfiguriert ist
Organization.Read.All
Liest /organization aus, um den Anzeigenamen des Tenant in der Berichtsausgabe und in der E-Mail anzuzeigen
Parameter
DeleteMode
WhatIf meldet nur die Kandidaten. Autopilot-Gerät löschen entfernt die Autopilot-Registrierungen. Autopilot- und Entra-Gerät löschen entfernt auch die passenden Entra ID-Geräteobjekte.
Erforderlich
falsch
Standardwert
WhatIf (nur Bericht)
Typ
Zeichenfolge
Anzeigename im Portal
Löschmodus
GroupTagFilter
Nur Geräte mit einem dieser Autopilot-Gruppentags, durch Kommas getrennt und exakt abgeglichen. Leer lassen für alle.
Erforderlich
falsch
Standardwert
Typ
Zeichenfolge
Anzeigename im Portal
Gruppentag-Filter
Herstellerfilter
Nur diese Hersteller, durch Kommas getrennt; Dell passt auch auf Dell Inc. Leer lassen für alle.
Erforderlich
falsch
Standardwert
Typ
Zeichenfolge
Anzeigename im Portal
Herstellerfilter
Modellfilter
Nur diese Modelle, durch Kommas getrennt; Surface passt auch auf Surface Laptop 3. Leer lassen für alle.
Erforderlich
falsch
Standardwert
Typ
Zeichenfolge
Anzeigename im Portal
Modellfilter
ExcludeSerialNumbers
Seriennummern, die niemals bearbeitet werden, durch Kommas getrennt. Leer lassen, um nichts auszuschließen.
Erforderlich
falsch
Standardwert
Typ
Zeichenfolge
Anzeigename im Portal
Seriennummern ausschließen
CleanupOrphanedDevices
Entfernt Registrierungen von Geräten, die Intune einmal kontaktiert haben, dort aber nicht mehr vorhanden sind.
Erforderlich
falsch
Standardwert
Wahr
Typ
Boolesch
Anzeigename im Portal
Verwaiste Geräte bereinigen?
OrphanedLastContactedDays
Ein Gerät gilt nur dann als verwaist, wenn sein letzter Kontakt mit Intune älter als diese Anzahl von Tagen ist, sodass kürzlich aktive Geräte sicher sind.
Erforderlich
falsch
Standardwert
90
Typ
Int32
Anzeigename im Portal
Verwaist nach (Tagen)
CleanupNeverEnrolledDevices
Entfernt Registrierungen von Geräten, die Intune nie kontaktiert haben und älter sind als „Nie registriert nach (Tagen)“.
Erforderlich
falsch
Standardwert
Falsch
Typ
Boolesch
Anzeigename im Portal
Nie registrierte Geräte bereinigen?
Portaloptionen
Ja, ältere nie registrierte Geräte entfernen
wahr
Kein
falsch
NeverEnrolledAgeDays
Nie registrierte Datensätze, die älter als diese Anzahl von Tagen sind, gezählt ab ihrem Erstellungsdatum, werden entfernt.
Erforderlich
falsch
Standardwert
90
Typ
Int32
Anzeigename im Portal
Nie registriert nach (Tagen)
Im Portal ausgeblendet
ja (vordefiniert über die Runbook-Anpassung)
EmailTo
Senden Sie den Bereinigungsbericht an diese Adressen, durch Kommas getrennt. Leer lassen, um keine E-Mail zu senden.
Erforderlich
falsch
Standardwert
Typ
Zeichenfolge
Anzeigename im Portal
Empfänger-E-Mail-Adresse(n)
EmailFrom
Absenderadresse der Berichts-E-Mail. Wird aus der Tenant-Einstellung RJReport.EmailSender übernommen.
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.
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.
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.
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.
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.
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.
Erforderlich
falsch
Standardwert
CSV & XLSX
Typ
Zeichenfolge
Anzeigename im Portal
Format der Berichtdatei
Portaloptionen
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.
Erforderlich
falsch
Standardwert
Falsch
Typ
Boolesch
Anzeigename im Portal
Einen Downloadlink erstellen?
Portaloptionen
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.
Erforderlich
falsch
Standardwert
cleanup-autopilot-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.
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.
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.
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.
Erforderlich
falsch
Standardwert
6
Typ
Int32
Im Portal ausgeblendet
ja (vordefiniert über die Runbook-Anpassung)
Zuletzt aktualisiert
War das hilfreich?