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

# Gerät ausphasen

Löschen Sie dieses Windows-Gerät und bereinigen Sie Intune, Autopilot und Entra ID

### Beschreibung

Nimmt dieses Windows-Gerät außer Betrieb. Sie wählen, ob das Gerät zurückgesetzt oder nur aus Intune gelöscht wird und ob es die Autopilot-Datenbank verlässt. Sein Entra ID-Objekt kann gelöscht, deaktiviert oder beibehalten werden. Optional wird das Gerät in Microsoft Defender for Endpoint markiert, damit Regeln, die das Tag verwenden, es von der automatischen Behebung ausschließen können. Ein Zurücksetzen entfernt alle Benutzer- und Registrierungsdaten vom Gerät und kann nicht rückgängig gemacht werden.

### Microsoft Defender for Endpoint-Ausschluss-Tag

Microsoft Defender for Endpoint verfügt über einen nativen **Ausschlussstatus** (im Filter „Geräteinventar“ angezeigt als *Ausgeschlossen* / *Nicht ausgeschlossen*). Dieser Status kann nur über das Defender-Portal festgelegt werden – es gibt **keine API** zum programmgesteuerten Festlegen des nativen Ausschlussstatus eines Geräts.

Da der native Ausschlussstatus nicht automatisiert werden kann, wendet dieses Runbook stattdessen ein benutzerdefiniertes Geräte-Tag (standardmäßig `ExcludeFromRemediation`) an, wenn *Gerät von Microsoft Defender for Endpoint ausschließen* ist aktiviert. Das Gerät wird anhand seiner Entra ID-Geräte-ID gesucht und über `POST /api/machines/{id}/tags`markiert, wodurch eine Kennzeichnung bereitgestellt wird, die zum Filtern und Auswählen ausgeschlossener Geräte verwendet werden kann.

#### Einmalige Einrichtung: Das Tag filterbar machen

Der Filter **Tags** Der Filter listet leider nur Tags auf, die über das Portal erstellt wurden. Ein ausschließlich über die API gesetztes Tag ist dem Gerät zugeordnet und auf der Geräteseite sichtbar, aber es wird **nicht** eigenständig im Tags-Filter angezeigt.

Damit das Ausschluss-Tag sichtbar und zum Filtern im [Defender-Geräteinventar](https://security.microsoft.com/machines)verwendbar ist, muss ein Client einmal manuell über das Portal markiert werden (wählen Sie ein Gerät > **Tags verwalten** > „Neues Tag erstellen“, wobei Sie exakt denselben Tag-Wert verwenden). Nach diesem einmaligen Schritt wird das Tag zu einem bekannten, filterbaren Tag, und dieses Runbook kann es in großem Umfang auf Geräte anwenden.

> **Hinweis:** Dieses Tag ist nur eine Bezeichnung – es legt nicht den nativen Ausschlussstatus des Geräts fest und hat selbst keine Auswirkung auf die Problembehandlung. Es wird nur wirksam, wenn eine Defender-Gerätegruppe oder Automatisierungsregel ausdrücklich so konfiguriert ist, dass sie diesem Tag-Wert entspricht. Solche Regeln gleichen den Tag-Wert direkt ab, unabhängig vom Portal **Tags** -Filter. Der einmalige manuelle Schritt wirkt sich daher nur darauf aus, ob das Tag für die Filterung in der Portal-Benutzeroberfläche auswählbar ist.

Siehe [Geräte-Tags erstellen und verwalten](https://learn.microsoft.com/defender-endpoint/machine-tags#create-tags) für Details.

### Speicherort

Gerät → Allgemein → Gerät ausphasen

**Voller Runbook-Name**

rjgit-device\_general\_outphase-device

### Details

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

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * DeviceManagementManagedDevices.PrivilegedOperations.All
    * *Löst die Intune-Zurücksetzungsaktion aus, wenn die Zurücksetzungsoption ausgewählt ist*
  * DeviceManagementManagedDevices.ReadWrite.All
    * *Findet das Intune-Gerät über azureADDeviceId und löscht es, wenn removeIntuneDevice gesetzt ist*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Findet die Autopilot-Identität und löscht sie, wenn removeAutopilotDevice gesetzt ist*
  * Device.Read.All
    * *Ermittelt das Entra-Gerät und liest seine registrierten Besitzer für die Statusausgabe aus*
* **Typ**: WindowsDefenderATP
  * Machine.Read.All
    * *Sucht das Gerät in Microsoft Defender for Endpoint, wenn excludeFromDefender aktiviert ist*
  * Machine.ReadWrite.All
    * *Fügt über /machines/{id}/tags das Ausschluss-Tag hinzu, wenn excludeFromDefender aktiviert ist*

#### RBAC-Rollen

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

### Parameter

#### DeviceId

Entra ID-Geräte-ID des Geräts, auf das das Runbook angewendet wird. Wird vom Portal anhand des ausgewählten Geräts festgelegt.

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

#### intuneAction

Vollständig löschen entfernt alle Benutzer- und Registrierungsdaten auf dem Gerät. Aus Intune löschen entfernt nur den Geräteeintrag, für Geräte, die bereits gelöscht oder zerstört wurden. Nicht löschen oder entfernen lässt Intune unverändert.

| Eigenschaft           | Wert          |
| --------------------- | ------------- |
| Erforderlich          | falsch        |
| Standardwert          | 2             |
| Typ                   | Int32         |
| Anzeigename im Portal | Intune-Aktion |

**Portaloptionen**

| Portaloption                                                                       | Wert |
| ---------------------------------------------------------------------------------- | ---- |
| Gerät vollständig löschen (Benutzer- oder Registrierungsdaten nicht beibehalten)   | 2    |
| Gerät aus Intune löschen (nur wenn das Gerät bereits gelöscht oder zerstört wurde) | 1    |
| Gerät nicht aus Intune löschen oder entfernen                                      | 0    |

#### aadAction

Löschen entfernt das Geräteobjekt aus Entra ID, Deaktivieren behält es bei, blockiert jedoch Anmeldungen vom Gerät, und Beibehalten lässt Entra ID unverändert.

| Eigenschaft           | Wert            |
| --------------------- | --------------- |
| Erforderlich          | falsch          |
| Standardwert          | 2               |
| Typ                   | Int32           |
| Anzeigename im Portal | Entra ID-Objekt |

**Portaloptionen**

| Portaloption                   | Wert |
| ------------------------------ | ---- |
| Gerät in Entra ID löschen      | 2    |
| Gerät in Entra ID deaktivieren | 1    |
| Entra ID-Gerät beibehalten     | 0    |

#### wipeDevice

Alter Schalter aus Kompatibilitätsgründen beibehalten. Die Auswahl unter „Intune-Aktion“ entscheidet, ob das Gerät zurückgesetzt wird.

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

#### removeIntuneDevice

Alter Schalter aus Kompatibilitätsgründen beibehalten. Die Auswahl unter „Intune-Aktion“ entscheidet, ob der Intune-Datensatz gelöscht wird.

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

#### removeAutopilotDevice

Durch das Entfernen des Geräts aus der Autopilot-Datenbank kann es den Tenant verlassen und anderswo registriert werden. Wenn es beibehalten wird, ist eine spätere Neuverteilung in diesem Tenant möglich.

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

**Portaloptionen**

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

#### removeAADDevice

Alter Schalter aus Kompatibilitätsgründen beibehalten. Die Auswahl unter „Entra ID-Objekt“ entscheidet, ob das Entra ID-Objekt gelöscht wird.

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

#### disableAADDevice

Alter Schalter aus Kompatibilitätsgründen beibehalten. Die Auswahl unter „Entra ID-Objekt“ entscheidet, ob das Entra ID-Objekt deaktiviert wird.

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

#### excludeFromDefender

Kennzeichnet das Gerät in Microsoft Defender for Endpoint mit dem Ausschluss-Tag, damit Regeln, die das Tag verwenden, es von der automatisierten Behebung ausschließen können. „Überspringen“ lässt Microsoft Defender for Endpoint unverändert.

| Eigenschaft           | Wert                                                   |
| --------------------- | ------------------------------------------------------ |
| Erforderlich          | falsch                                                 |
| Standardwert          | Falsch                                                 |
| Typ                   | Boolesch                                               |
| Anzeigename im Portal | In Defender for Endpoint als ausgeschlossen markieren? |

**Portaloptionen**

| Portaloption                                                          | Wert   |
| --------------------------------------------------------------------- | ------ |
| Gerät in Microsoft Defender for Endpoint als ausgeschlossen markieren | wahr   |
| Defender-Vorgänge überspringen                                        | falsch |

#### defenderExclusionTag

Tag-Name, der auf dem Gerät in Microsoft Defender for Endpoint gesetzt wird, zur Verwendung in Ihren Ausschlussregeln.

| Eigenschaft           | Wert                    |
| --------------------- | ----------------------- |
| Erforderlich          | falsch                  |
| Standardwert          | ExcludeFromRemediation  |
| Typ                   | Zeichenfolge            |
| Anzeigename im Portal | Defender-Ausschluss-Tag |

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