> 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/cleanup-autopilot-devices_scheduled.md).

# Autopilot-Geräte bereinigen, geplant

Verwaiste und nie registrierte Autopilot-Registrierungen entfernen

{% hint style="info" %}
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](https://docs.realmjoin.com/de/automatisierung/runbooks/scheduling.md) für Details zur Konfiguration von Runbook-Zeitplänen.
{% endhint %}

### 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](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) 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](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### 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 | <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
  * 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) |

#### BrandingFooterLink

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   |

#### CreateDownloadLink

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

[Zur Übersicht der Runbook-Referenz zurück](https://docs.realmjoin.com/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/cleanup-autopilot-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.
