Zum Inhalt springen
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Autopilot-Geräte bereinigen, geplant

Verwaiste und nie registrierte Autopilot-Registrierungen entfernen

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 für Details zur Konfiguration von Runbook-Zeitplänen.

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

  1. 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.

  2. Bestätigen Sie, dass die identifizierten Geräte tatsächlich verwaist sind oder sich nie registriert haben.

  3. Wechseln Sie erst nach der Überprüfung der Kandidatenliste in einen Löschmodus.

Parameterwechselwirkungen

  • DeleteMode ist 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.All Berechtigung hinzuzufügen.

  • CleanupOrphanedDevices und CleanupNeverEnrolledDevices sind unabhängig; entweder oder beide können aktiviert werden. NeverEnrolledAgeDays gilt nur für die Prüfung auf nie registrierte Geräte.

  • GroupTagFilter, Herstellerfilter und Modellfilter sind 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. GroupTagFilter stimmt genau mit dem Gruppentag überein (ohne Beachtung der Groß-/Kleinschreibung); Herstellerfilter und Modellfilter stimmen als Teilzeichenfolgen ohne Beachtung der Groß-/Kleinschreibung überein, sodass „Dell“ mit „Dell Inc.“ und „Surface“ mit „Surface Laptop 3“ übereinstimmt.

  • ExcludeSerialNumbers wird 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

Eigenschaft
Wert

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.

Eigenschaft
Wert

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.

Eigenschaft
Wert

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.

Eigenschaft
Wert

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.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Typ

Zeichenfolge

Anzeigename im Portal

Modellfilter

ExcludeSerialNumbers

Seriennummern, die niemals bearbeitet werden, durch Kommas getrennt. Leer lassen, um nichts auszuschließen.

Eigenschaft
Wert

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.

Eigenschaft
Wert

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.

Eigenschaft
Wert

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)“.

Eigenschaft
Wert

Erforderlich

falsch

Standardwert

Falsch

Typ

Boolesch

Anzeigename im Portal

Nie registrierte Geräte bereinigen?

Portaloptionen

Portaloption
Wert

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.

Eigenschaft
Wert

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.

Eigenschaft
Wert

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.

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)

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

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

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.

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)

Zuletzt aktualisiert

War das hilfreich?