# 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 Vernichtungsverhalten festlegen.

### Ort

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

**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 | true         |
| 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 | True    |
| Typ          | Boolean |

#### useProtectedWipe

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

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

#### removeIntuneDevice

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

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

#### 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, verbleibt das Gerät in der AutoPilot-Datenbank und kann einem anderen Benutzer/Gerät im Tenant neu zugewiesen werden.

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

#### removeAADDevice

"Gerät aus EntraID 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, verbleibt das Geräteobjekt in Entra ID (Azure AD).

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

#### disableAADDevice

"Gerät in EntraID 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          | Boolean |

#### macOsRecoveryCode

Nur MacOS. Wiederherstellungscode für ältere Geräte; bei neueren Geräten ist dieser möglicherweise nicht erforderlich.

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

#### macOsObliterationBehavior

Nur MacOS. Steuert das Verhalten der OS-Vernichtung während des Löschens.

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

[Zurück zur Übersicht der Runbook-Referenz](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references)