> 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/device/general/wipe-device.md).

# Gerät löschen

Löschen Sie dieses Windows- oder macOS-Gerät und bereinigen Sie seine Datensätze

### Beschreibung

Löscht dieses Windows- oder macOS-Gerät. Optional bereinigt es auch die Reste davon: der Intune-Eintrag, die Autopilot-Registrierung und das Entra ID-Objekt können gelöscht oder deaktiviert werden. Für Windows können Sie ein geschütztes Löschen und eine längere Compliance-Gnadenfrist nach der erneuten Registrierung wählen, für macOS einen Wiederherstellungscode und die Art, wie das OS gelöscht wird. Ein Löschen entfernt alle Daten auf dem Gerät und kann nicht rückgängig gemacht werden. Das Löschen kann übersprungen werden, wenn Microsoft Defender for Endpoint das Gerät als mittel- oder hochriskant einstuft.

### Nur löschen, wenn das Gerät kein Risiko aufweist

Wenn *Nur löschen, wenn das Gerät kein Risiko aufweist* (`skipWipeIfAtRisk`) aktiviert ist, prüft das Runbook den Risikowert des Geräts in Microsoft Defender for Endpoint, bevor irgendein Geräteobjekt angetastet wird. Die Abfrage verwendet die Entra-Geräte-ID und ist dieselbe Abfrage wie die **Defender-Status prüfen** ausführt. Die Prüfung ist standardmäßig deaktiviert und wird nur ausgeführt, wenn ein Löschen angefordert wird; sie wird übersprungen, wenn *Gerät nicht löschen* ausgewählt ist.

Mögliche Ergebnisse:

* **Kein erhöhtes Risiko** (Risikowert `Keine`, `Informativ` oder `Niedrig`): Das Löschen und die ausgewählten Bereinigungsaktionen werden wie gewohnt ausgeführt.
* **Risikowert `Mittel` oder `Hoch`**: Das Runbook wird vor dem Löschen, der Mitgliedschaft in der Ausschlussgruppe, den Entra-Änderungen und den Intune-/Autopilot-Löschungen mit einer Warnung beendet. Ein Gerät mit erhöhtem Risikowert kann in einen Sicherheitsvorfall verwickelt sein, und das Löschen könnte forensische Daten (z. B. Protokolle) zerstören. Stimmen Sie sich zuerst mit Ihrem Sicherheitsteam ab; um das Gerät trotzdem zu löschen, führen Sie das Runbook mit deaktivierter Option aus.
* **Gerät in Microsoft Defender for Endpoint nicht gefunden**: Der Risikowert kann nicht bestimmt werden. Das Runbook vermerkt dies und fährt mit dem Löschen fort, sodass Geräte, die nicht in Defender onboarded sind, nicht blockiert werden.
* **Defender-Abfrage schlägt fehl**: Das Runbook wird ohne Löschung beendet, sodass ein vorübergehendes API-Problem den Schutz nie umgeht.

#### Die Prüfung standardmäßig aktivieren

Um die Prüfung für jedes Löschen zu erzwingen, den Parameter vorab festlegen und ausblenden, damit er im Portal nicht deaktiviert werden kann.

Die JSON-Konfiguration hierfür lautet wie folgt:

```json
"rjgit-device_general_wipe-device": {
    "parameters": {
        "skipWipeIfAtRisk": {
            "Default": true,
            "Hide": true
        }
    }
}
```

### Das Gerät zu einer Compliance-Ausschlussgruppe hinzufügen

Wenn *Gerät zur Compliance-Ausschlussgruppe hinzufügen* (`addToExclusionGroup`) aktiviert ist, wird das gelöschte Windows-Gerät einer Compliance-Ausschlussgruppe hinzugefügt. Geräte in dieser Gruppe erhalten nach der erneuten Registrierung über Autopilot eine längere Compliance-Gnadenfrist (dies entspricht dem **Geräte-Onboarding-Ausschluss prüfen** Runbook).

Standardmäßig wird die Gruppe über ihren **Anzeigenamen** (`exclusionGroupName`). Da Anzeigenamen nicht eindeutig sein müssen, können Sie die Gruppe stattdessen über ihre **Objekt-ID** (`exclusionGroupId`). Wenn eine Objekt-ID angegeben wird, **hat sie immer Vorrang vor** dem Anzeigenamen, sodass Namenskonflikte niemals dazu führen können, dass die falsche Gruppe verwendet wird. `exclusionGroupId` ist standardmäßig ausgeblendet und dafür vorgesehen, über eine Runbook-Anpassung festgelegt zu werden.

Die Gruppe wird in einer vorgelagerten Vorabprüfung aufgelöst und validiert. Wenn die konfigurierte Gruppe nicht existiert, bricht das Runbook ab **bevor** jede Lösch-/Entfernungs-/Deaktivierungsaktion ausgeführt wird, sodass kein halb angewendeter Zustand zurückbleibt. Das Hinzufügen zur Gruppe wird für Nicht-Windows-Geräte übersprungen und wenn das Gerät aus Entra ID gelöscht wird (`removeAADDevice`).

#### Die Gruppe per Objekt-ID festlegen (empfohlen)

Die Objekt-ID der Gruppe vorab festlegen und den Schalter aktivieren, wobei die Felder ausgeblendet bleiben. Dadurch werden Unklarheiten durch doppelte Anzeigenamen vermieden.

Die JSON-Konfiguration hierfür lautet wie folgt:

```json
"rjgit-device_general_wipe-device": {
    "parameters": {
        "addToExclusionGroup": {
            "Default": true
        },
        "exclusionGroupId": {
            "Default": "00000000-0000-0000-0000-000000000000",
            "Hide": true
        },
        "exclusionGroupName": {
            "Hide": true
        }
    }
}
```

Ersetzen Sie `00000000-0000-0000-0000-000000000000` mit der Objekt-ID Ihrer Gruppe (Entra ID > Groups > *Ihre Gruppe* > **Objekt-ID**).

#### Die Gruppe per Anzeigename festlegen

Wenn Sie lieber mit dem Anzeigenamen arbeiten (und er in Ihrem Tenant eindeutig ist), legen Sie vorab `exclusionGroupName` und lassen Sie `exclusionGroupId` leer, damit der Name verwendet wird.

Die JSON-Konfiguration hierfür lautet wie folgt:

```json
"rjgit-device_general_wipe-device": {
    "parameters": {
        "addToExclusionGroup": {
            "Default": true
        },
        "exclusionGroupName": {
            "Default": "cfg - Intune - Windows - Compliance für nicht registrierte Autopilot-Geräte (Geräte)",
            "Hide": true
        }
    }
}
```

### macOS-Löschoptionen

macOS-Geräte werden über die Löschaktion von Intune gelöscht. Nur für sie gelten zwei Optionen:

* **Wiederherstellungscode (macOS)** (`macOsRecoveryCode`): Ältere Macs benötigen einen sechsstelligen Wiederherstellungscode, um das Löschen zu akzeptieren; neuere Geräte ignorieren ihn. Der Parameter ist im Portal ausgeblendet und kann über eine Runbook-Anpassung vorab festgelegt werden.
* **Verhalten beim vollständigen Löschen (macOS)** (`macOsObliterationBehavior`): legt fest, was geschieht, wenn *Alle Inhalte und Einstellungen löschen* (EACS) nicht möglich ist. `Standard` löscht die Benutzerdaten und weicht dann auf das Löschen des gesamten OS aus, `doNotObliterate` löscht das OS niemals, `obliterateWithWarning` warnt und löscht dann das OS, `immer` löscht das OS in jedem Fall.

Nur-Windows-Optionen (*geschütztes Löschen*, *Autopilot-Datenbank*, *Compliance-Ausschlussgruppe*) werden für macOS-Geräte ignoriert.

### Ort

Gerät → Allgemein → Gerät löschen

**Vollständiger Runbook-Name**

rjgit-device\_general\_wipe-device

### Details

| Eigenschaft          | Wert                                |
| -------------------- | ----------------------------------- |
| Version              | 1.1.0                               |
| Erforderliche Module | RealmJoin.RunbookHelper (>= 0.8.10) |
| Planbar              | nein                                |

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * DeviceManagementManagedDevices.PrivilegedOperations.All
    * *Löst die Intune-Löschaktion aus, wenn wipeDevice ausgewählt ist*
  * DeviceManagementManagedDevices.ReadWrite.All
    * *Findet das Intune-Gerät anhand von azureADDeviceId und löscht es, wenn removeIntuneDevice gesetzt ist*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Findet und löscht die Autopilot-Identität, wenn removeAutopilotDevice gesetzt ist*
  * Device.Read.All
    * *Löst das Entra-Gerät auf und liest seine registrierten Besitzer für den Bericht aus*
  * GroupMember.ReadWrite.All
    * *Fügt das Gerät der Ausschlussgruppe hinzu, wenn addToExclusionGroup aktiviert ist*
* **Typ**: WindowsDefenderATP
  * Machine.Read.All *(optional — Funktion: Defender-Risikoprüfung)*
    * *Liest im Vorabcheck skipWipeIfAtRisk den Defender-Risikowert des Geräts aus*

#### RBAC-Rollen

* Cloud Device Administrator
  * *Erforderlich, um das Entra ID-Geräteobjekt über /devices/{id} zu deaktivieren und zu löschen*

### Parameter

#### Geräte-ID

Entra ID-Geräte-ID des Geräts, auf das das Runbook wirkt. Vom Portal anhand des ausgewählten Geräts festgelegt.

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

#### wipeDevice

Bei vollständigem Löschen werden alle Benutzer- und Registrierungsdaten auf dem Gerät gelöscht. „Nicht löschen“ lässt das Gerät unangetastet und führt nur die ausgewählten Bereinigungsschritte aus.

| Eigenschaft           | Wert                  |
| --------------------- | --------------------- |
| Erforderlich          | falsch                |
| Standardwert          | Wahr                  |
| Typ                   | Boolesch              |
| Anzeigename im Portal | Dieses Gerät löschen? |

**Portaloptionen**

| Portaloption                                                                              | Wert   |
| ----------------------------------------------------------------------------------------- | ------ |
| Gerät vollständig löschen (Windows: keine Benutzer- oder Registrierungsdaten beibehalten) | wahr   |
| Gerät nicht löschen                                                                       | falsch |

#### useProtectedWipe

Versucht weiter zu löschen, auch wenn das Gerät dazwischen ausgeschaltet wird, sodass das Löschen nicht durch Ausschalten umgangen werden kann. Nur Windows.

| Eigenschaft           | Wert                                     |
| --------------------- | ---------------------------------------- |
| Erforderlich          | falsch                                   |
| Standardwert          | Falsch                                   |
| Typ                   | Boolesch                                 |
| Anzeigename im Portal | Geschütztes Löschen verwenden (Windows)? |

#### removeIntuneDevice

Löscht den Geräteeintrag in Intune. Nur sinnvoll, wenn das Gerät bereits gelöscht oder zerstört ist.

| Eigenschaft           | Wert                      |
| --------------------- | ------------------------- |
| Erforderlich          | falsch                    |
| Standardwert          | Falsch                    |
| Typ                   | Boolesch                  |
| Anzeigename im Portal | Gerät aus Intune löschen? |

**Portaloptionen**

| Portaloption                                                                     | Wert   |
| -------------------------------------------------------------------------------- | ------ |
| Gerät aus Intune löschen (nur wenn das Gerät bereits gelöscht oder zerstört ist) | wahr   |
| Den Intune-Eintrag beibehalten                                                   | falsch |

#### removeAutopilotDevice

Das Entfernen des Geräts aus der Autopilot-Datenbank ermöglicht, dass es den Tenant verlässt und andernorts registriert wird. Wenn es behalten wird, ist eine spätere erneute Bereitstellung in diesem Tenant möglich. Nur Windows.

| Eigenschaft           | Wert                                           |
| --------------------- | ---------------------------------------------- |
| Erforderlich          | falsch                                         |
| Standardwert          | Falsch                                         |
| Typ                   | Boolesch                                       |
| Anzeigename im Portal | Aus der Autopilot-Datenbank löschen (Windows)? |

**Portaloptionen**

| Portaloption                                                  | Wert   |
| ------------------------------------------------------------- | ------ |
| Aus Autopilot entfernen (das Gerät kann den Tenant verlassen) | wahr   |
| Das Gerät in Autopilot behalten                               | falsch |

#### removeAADDevice

Ob das Entra ID-Geräteobjekt nach dem Löschen gelöscht wird. Über die Runbook-Anpassung vorab festgelegt.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           | Falsch                                       |
| Typ                    | Boolesch                                     |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

#### disableAADDevice

Durch Deaktivieren werden Anmeldungen vom Gerät blockiert, sein Objekt bleibt jedoch in Entra ID erhalten. Bei Beibehalten bleibt das Entra ID-Objekt unverändert.

| Eigenschaft           | Wert                                |
| --------------------- | ----------------------------------- |
| Erforderlich          | falsch                              |
| Standardwert          | Falsch                              |
| Typ                   | Boolesch                            |
| Anzeigename im Portal | Entra ID-Geräteobjekt deaktivieren? |

**Portaloptionen**

| Portaloption                          | Wert   |
| ------------------------------------- | ------ |
| Gerät in Entra ID deaktivieren        | wahr   |
| Das Entra ID-Gerät unverändert lassen | falsch |

#### skipWipeIfAtRisk

Überspringt das Löschen, wenn Microsoft Defender for Endpoint das Gerät als mittel- oder hochriskant einstuft. So bleiben Beweise auf einem Gerät erhalten, das Teil eines Sicherheitsvorfalls sein kann.

| Eigenschaft           | Wert                                               |
| --------------------- | -------------------------------------------------- |
| Erforderlich          | falsch                                             |
| Standardwert          | Falsch                                             |
| Typ                   | Boolesch                                           |
| Anzeigename im Portal | Nur löschen, wenn das Gerät kein Risiko darstellt? |

**Portaloptionen**

| Portaloption                                                         | Wert   |
| -------------------------------------------------------------------- | ------ |
| Nur löschen, wenn der Defender-Risikowert nicht mittel oder hoch ist | wahr   |
| Unabhängig vom Defender-Risikowert löschen                           | falsch |

#### addToExclusionGroup

Fügt das Gerät der Compliance-Ausschlussgruppe hinzu, sodass es bei der erneuten Registrierung über Autopilot eine längere Compliance-Gnadenfrist erhält. Nur Windows.

| Eigenschaft           | Wert                                                  |
| --------------------- | ----------------------------------------------------- |
| Erforderlich          | falsch                                                |
| Standardwert          | Falsch                                                |
| Typ                   | Boolesch                                              |
| Anzeigename im Portal | Zur Compliance-Ausschlussgruppe hinzufügen (Windows)? |

**Portaloptionen**

| Portaloption                                     | Wert   |
| ------------------------------------------------ | ------ |
| Gerät zur Compliance-Ausschlussgruppe hinzufügen | wahr   |
| Nicht zur Ausschlussgruppe hinzufügen            | falsch |

#### exclusionGroupName

Anzeigename der Ausschlussgruppe, zu der das Gerät hinzugefügt wird. Eine in der Runbook-Anpassung vorab festgelegte Objekt-ID hat Vorrang.

| Eigenschaft           | Wert                                                                                 |
| --------------------- | ------------------------------------------------------------------------------------ |
| Erforderlich          | falsch                                                                               |
| Standardwert          | cfg - Intune - Windows - Compliance für nicht registrierte Autopilot-Geräte (Geräte) |
| Typ                   | Zeichenfolge                                                                         |
| Anzeigename im Portal | Name der Compliance-Ausschlussgruppe                                                 |

#### exclusionGroupId

Objekt-ID der Ausschlussgruppe. Über die Runbook-Anpassung vorab festgelegt und statt des Gruppennamens verwendet, um Namenskonflikte zu vermeiden.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           |                                              |
| Typ                    | Zeichenfolge                                 |
| Anzeigename im Portal  | Objekt-ID der Compliance-Ausschlussgruppe    |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

#### macOsRecoveryCode

Wiederherstellungscode für ältere Macs, die einen zum Löschen benötigen. Neuere Geräte ignorieren ihn. Über die Runbook-Anpassung vorab festgelegt.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           | 123456                                       |
| Typ                    | Zeichenfolge                                 |
| Anzeigename im Portal  | Wiederherstellungscode (macOS)               |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

#### macOsObliterationBehavior

Wie ein Mac gelöscht wird: zuerst Benutzerdaten löschen und dann auf das Löschen des OS ausweichen, das OS niemals löschen, vor dem Löschen des OS warnen oder das OS immer löschen.

| Eigenschaft           | Wert                                         |
| --------------------- | -------------------------------------------- |
| Erforderlich          | falsch                                       |
| Standardwert          | Standard                                     |
| Typ                   | Zeichenfolge                                 |
| Anzeigename im Portal | Verhalten beim vollständigen Löschen (macOS) |

**Portaloptionen**

| Portaloption                                                        | Wert                  |
| ------------------------------------------------------------------- | --------------------- |
| Benutzerdaten löschen (EACS), das OS löschen, wenn das fehlschlägt  | Standard              |
| Benutzerdaten löschen (EACS), das OS niemals löschen                | doNotObliterate       |
| Benutzerdaten löschen (EACS), andernfalls warnen und das OS löschen | obliterateWithWarning |
| Das OS immer löschen                                                | immer                 |

[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/device/general/wipe-device.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.
