# Gerät löschen

### Beschreibung

Ein Windows- oder MacOS-Gerät löschen. Für Windows-Geräte können Sie zwischen einem normalen Löschen und einem geschützten Löschen wählen. Für MacOS-Geräte können Sie bei Bedarf einen Wiederherstellungscode angeben und das Löschverhalten festlegen.

### Speicherort

Device → General → Wipe Device

**Vollständiger Runbook-Name**

rjgit-device\_general\_wipe-device

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * DeviceManagementManagedDevices.PrivilegedOperations.All
  * DeviceManagementManagedDevices.ReadWrite.All
  * DeviceManagementServiceConfig.ReadWrite.All
  * Device.Read.All

#### RBAC-Rollen

* Cloud-Geräteadministrator

### Parameter

#### DeviceId

Die Geräte-ID des Zielgeräts.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | wahr         |
| Standardwert |              |
| Typ          | Zeichenfolge |

#### wipeDevice

„Dieses Gerät löschen?“ (Endwert: true) oder „Gerät nicht löschen“ (Endwert: false) kann als auszuführende Aktion ausgewählt werden. Wenn auf true gesetzt, löst das Runbook eine Löschaktion für das Gerät in Intune aus. Wenn auf false gesetzt, wird für das Gerät in Intune keine Löschaktion ausgelöst.

| Eigenschaft  | Wert     |
| ------------ | -------- |
| Erforderlich | false    |
| Standardwert | Wahr     |
| Typ          | Boolesch |

#### useProtectedWipe

Nur Windows. Wenn auf true gesetzt, wird ein geschütztes Löschen verwendet.

| Eigenschaft  | Wert     |
| ------------ | -------- |
| Erforderlich | false    |
| Standardwert | False    |
| Typ          | Boolesch |

#### removeIntuneDevice

Wenn auf true gesetzt, wird das Intune-Geräteobjekt gelöscht.

| Eigenschaft  | Wert     |
| ------------ | -------- |
| Erforderlich | false    |
| Standardwert | False    |
| Typ          | Boolesch |

#### removeAutopilotDevice

Nur Windows. „Gerät aus der AutoPilot-Datenbank löschen?“ (Endwert: true) oder „Gerät behalten / egal“ (Endwert: false) kann als auszuführende Aktion ausgewählt werden. Wenn auf true gesetzt, löscht das Runbook das Gerät aus der AutoPilot-Datenbank, wodurch das Gerät auch den Tenant verlassen kann. Wenn auf false gesetzt, bleibt das Gerät in der AutoPilot-Datenbank und kann im Tenant einem anderen Benutzer/Gerät neu zugewiesen werden.

| Eigenschaft  | Wert     |
| ------------ | -------- |
| Erforderlich | false    |
| Standardwert | False    |
| Typ          | Boolesch |

#### removeAADDevice

„Gerät in Entra ID löschen?“ (Endwert: true) oder „Gerät behalten / egal“ (Endwert: false) kann als auszuführende Aktion ausgewählt werden. Wenn auf true gesetzt, löscht das Runbook das Geräteobjekt aus Entra ID (Azure AD). Wenn auf false gesetzt, bleibt das Geräteobjekt in Entra ID (Azure AD) erhalten.

| Eigenschaft  | Wert     |
| ------------ | -------- |
| Erforderlich | false    |
| Standardwert | False    |
| Typ          | Boolesch |

#### disableAADDevice

„Gerät in Entra ID deaktivieren?“ (Endwert: true) oder „Gerät behalten / egal“ (Endwert: false) kann als auszuführende Aktion ausgewählt werden. Wenn auf true gesetzt, deaktiviert das Runbook das Geräteobjekt in Entra ID (Azure AD). Wenn auf false gesetzt, bleibt das Geräteobjekt in Entra ID (Azure AD) aktiviert.

| Eigenschaft  | Wert     |
| ------------ | -------- |
| Erforderlich | false    |
| Standardwert | False    |
| Typ          | Boolesch |

#### macOsRecoveryCode

Nur MacOS. Wiederherstellungscode für ältere Geräte; neuere Geräte benötigen diesen möglicherweise nicht.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert | 123456       |
| Typ          | Zeichenfolge |

#### macOsObliterationBehavior

Nur MacOS. Steuert das Betriebssystem-Löschverhalten während des Löschvorgangs.

| Eigenschaft  | Wert         |
| ------------ | ------------ |
| Erforderlich | false        |
| Standardwert | Standard     |
| Typ          | Zeichenfolge |

[Zurück zur Übersicht der Runbook-Referenz](/de/automatisierung/runbooks/runbook-references.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/device/general/wipe-device.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.