> 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 geplanter Runbook-Lauf. Er ist dafür ausgelegt, nach einem wiederkehrenden Zeitplan ausgeführt zu werden, anstatt für ein einzelnes Objekt ausgelöst zu werden. Siehe [Planung](/de/automatisierung/runbooks/scheduling.md) für Details dazu, wie Runbook-Zeitpläne konfiguriert werden.
{% endhint %}

### Beschreibung

Bereinigt Windows Autopilot-Registrierungen: Geräte, deren Seriennummer keiner Intune-Geräte 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.

### Löschung ist irreversibel

* Das Entfernen einer Autopilot-Geräteidentität löscht sie dauerhaft aus Windows Autopilot. Für Autopilot-Datensätze gibt es weder eine Softdelete- noch eine Papierkorb-Funktion.
* Das physische Gerät kann nicht erneut in Autopilot aufgenommen werden, bis 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 tatsächlich nicht mehr relevant 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 die Standardeinstellung ist, und prüfen Sie die Ausgabe oder das per E-Mail versandte CSV.
2. Vergewissern Sie sich, dass die identifizierten Geräte tatsächlich verwaist sind oder sich nie registriert haben.
3. Wechseln Sie erst dann in einen Löschmodus, nachdem die Kandidatenliste geprüft wurde.

### Parameterinteraktionen

* `DeleteMode` standardmäßig zu *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 andernfalls als veralteter Datensatz zurückbleiben würde, sobald die Autopilot-Identität entfernt ist. Der zweite Modus erfordert die `Device.ReadWrite.All` Berechtigung.
* `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 AND verknüpft, sodass ein Gerät jeden ausgefüllten Filter erfüllen muss, um im Geltungsbereich zu bleiben. `GroupTagFilter` stimmt genau mit dem Gruppentag überein (Groß-/Kleinschreibung wird nicht beachtet); `Herstellerfilter` und `Modellfilter` werden als Teilstrings ohne Berücksichtigung der Groß-/Kleinschreibung abgeglichen, sodass "Dell" mit "Dell Inc." und "Surface" mit "Surface Laptop 3" übereinstimmt.
* `ExcludeSerialNumbers` wird nach den AND-Filtern als Ausschluss angewendet: Ein Gerät, dessen Seriennummer in der Liste enthalten ist (genau, unabhängig von Groß-/Kleinschreibung), wird unabhängig von den anderen Filtern aus dem Geltungsbereich entfernt. Lassen Sie das Feld leer, um nichts auszuschließen.

### Konfiguration 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` Mandanteneinstellung bezogen.

Dieses Runbook sendet E-Mails über die Microsoft Graph API. Um E-Mails über die Graph-API zu senden, müssen Sie eine vorhandene E-Mail-Adresse in der Runbook-Anpassung 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 die optionalen `RJReport.Branding.*` Mandanteneinstellungen:

* **Kopf- und Fußzeilenbild** – öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB jeweils
* **Fußzeilenlink** – Ziel des Fußzeilenbildes
* **Akzent- und Textfarbe** – 6-stellige Hex-Werte, z. B. `#0052cc`

Wenn diese Einstellungen nicht konfiguriert sind, werden die Standardgrafiken und -farben von RealmJoin 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 → Autopilot-Geräte bereinigen (geplant)

**Voller Runbook-Name**

rjgit-org\_devices\_cleanup-autopilot-devices\_scheduled

### Details

| Eigenschaft          | Wert                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Version              | 1.3.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
    * *Ermittelt Entra-Geräte anhand von deviceId und löscht sie im Modus 'Delete Autopilot and Entra device'*
  * DeviceManagementManagedDevices.Read.All
    * *Liest verwaltete Windows-Geräte aus Intune, 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, um den Anzeigenamen des Tenant im Bericht und in der E-Mail anzuzeigen*

### Parameter

#### DeleteMode

WhatIf meldet nur die Kandidaten. Delete Autopilot device entfernt die Autopilot-Registrierungen. Delete Autopilot and Entra device 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. Für alle leer lassen.

| Eigenschaft           | Wert              |
| --------------------- | ----------------- |
| Erforderlich          | falsch            |
| Standardwert          |                   |
| Typ                   | Zeichenfolge      |
| Anzeigename im Portal | Gruppentag-Filter |

#### Herstellerfilter

Nur diese Hersteller, durch Kommas getrennt; Dell stimmt auch mit Dell Inc. überein. Für alle leer lassen.

| Eigenschaft           | Wert             |
| --------------------- | ---------------- |
| Erforderlich          | falsch           |
| Standardwert          |                  |
| Typ                   | Zeichenfolge     |
| Anzeigename im Portal | Herstellerfilter |

#### Modellfilter

Nur diese Modelle, durch Kommas getrennt; Surface stimmt auch mit Surface Laptop 3 überein. Für alle leer lassen.

| Eigenschaft           | Wert         |
| --------------------- | ------------ |
| Erforderlich          | falsch       |
| Standardwert          |              |
| Typ                   | Zeichenfolge |
| Anzeigename im Portal | Modellfilter |

#### ExcludeSerialNumbers

Seriennummern, die niemals angefasst 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 sich einmal bei Intune gemeldet 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 so viele Tage ist; kürzlich aktive Geräte sind also sicher.

| Eigenschaft           | Wert                  |
| --------------------- | --------------------- |
| Erforderlich          | falsch                |
| Standardwert          | 90                    |
| Typ                   | Int32                 |
| Anzeigename im Portal | Verwaist nach (Tagen) |

#### CleanupNeverEnrolledDevices

Entfernt Registrierungen von Geräten, die sich nie bei Intune gemeldet 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   |
| Nein                                         | falsch |

#### NeverEnrolledAgeDays

Nie registrierte Registrierungen, die älter sind als diese Anzahl von Tagen, 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 (vorkonfiguriert ü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 Bericht-E-Mail. Wird aus der Mandanteneinstellung RJReport.EmailSender übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingHeaderImageUrl

Kopfzeilenbild der Bericht-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanteneinstellung RJReport.Branding.HeaderImageUrl übernommen; wenn leer, wird der standardmäßige RealmJoin-Kopfbereich verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingFooterImageUrl

Fußzeilenbild der Bericht-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanteneinstellung RJReport.Branding.FooterImageUrl übernommen; wenn leer, wird die standardmäßige RealmJoin-Fußzeile verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingFooterLink

Link hinter dem Fußzeilenbild der Bericht-E-Mail. Wird aus der Mandanteneinstellung RJReport.Branding.FooterLink übernommen; wenn leer, wird realmjoin.com verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingAccentColor

Akzentfarbe der Bericht-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanteneinstellung RJReport.Branding.AccentColor übernommen; wenn leer oder ungültig, wird der standardmäßige RealmJoin-Wert verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingTextColor

Textfarbe der Bericht-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanteneinstellung RJReport.Branding.TextColor übernommen; wenn leer oder ungültig, wird der standardmäßige RealmJoin-Wert verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### ReportFileFormat

Liefern Sie den Bericht als CSV, als Excel-Arbeitsmappe oder beides.

| Eigenschaft           | Wert                |
| --------------------- | ------------------- |
| Erforderlich          | falsch              |
| Standardwert          | CSV & XLSX          |
| Typ                   | Zeichenfolge        |
| Anzeigename im Portal | Berichtsdateiformat |

**Portaloptionen**

| Portaloption | Wert       |
| ------------ | ---------- |
| CSV & XLSX   | CSV & XLSX |
| Nur CSV      | Nur CSV    |
| Nur XLSX     | Nur XLSX   |

#### CreateDownloadLink

Lädt den Bericht außerdem 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 Berichtsdateien hochgeladen werden. Pro Runbook festlegen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | cleanup-autopilot-devices                       |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### ResourceGroupName

Ressourcengruppe des Storage Account für Bericht-Uploads. Aus der Tenant-Einstellung RJReport.StorageAccount.ResourceGroup übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### StorageAccountName

Storage Account für Bericht-Uploads. Aus der Tenant-Einstellung RJReport.StorageAccount.StorageAccountName übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### LinkExpiryDays

Anzahl der Tage, die ein Downloadlink gültig bleibt. Aus der Tenant-Einstellung RJReport.StorageAccount.LinkExpiryDays übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | 6                                               |
| Typ                    | Int32                                           |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

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