# Gerät ausphasieren

### Beschreibung

Ein Windows-Gerät entfernen/außer Betrieb nehmen. Sie können wählen, ob Sie das Gerät löschen und/oder aus Intune und AutoPilot entfernen möchten.

### Ort

Gerät → Allgemein → Gerät außer Betrieb nehmen

**Vollständiger Runbook-Name**

rjgit-device\_general\_outphase-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 |

#### intuneAction

Legt die auszuführende Intune-Aktion fest (löschen, entfernen oder keine).

| Eigenschaft  | Wert  |
| ------------ | ----- |
| Erforderlich | false |
| Standardwert | 2     |
| Typ          | Int32 |

#### aadAction

Legt die auszuführende Entra ID (Azure AD)-Aktion fest (löschen, deaktivieren oder keine).

| Eigenschaft  | Wert  |
| ------------ | ----- |
| Erforderlich | false |
| Standardwert | 2     |
| Typ          | Int32 |

#### wipeDevice

Wenn auf true gesetzt, wird in Intune eine Löschaktion ausgelöst.

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

#### removeIntuneDevice

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

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

#### removeAutopilotDevice

„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 im Tenant einem anderen Benutzer/Gerät neu zugewiesen werden.

| Eigenschaft  | Wert    |
| ------------ | ------- |
| Erforderlich | false   |
| Standardwert | True    |
| 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 | True    |
| 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 |

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