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

# Geräte ausmustern

Mehrere Geräte auf einmal löschen und bereinigen

### Beschreibung

Nimmt mehrere Geräte auf einmal außer Betrieb, angegeben als Liste von Geräte-IDs oder Seriennummern. Sie wählen, ob die Geräte gewiped oder nur aus Intune gelöscht werden und ob ihre Autopilot-Registrierung entfernt wird. Ihre Entra ID-Objekte können gelöscht, deaktiviert oder beibehalten werden. Optional werden die Geräte in Microsoft Defender for Endpoint mit einem Tag versehen, sodass Regeln, die das Tag verwenden, sie von der automatisierten Remediation ausschließen können. Ein Wipe entfernt alle Daten und kann nicht rückgängig gemacht werden.

### Ausschluss-Tag für Microsoft Defender for Endpoint

Microsoft Defender for Endpoint verfügt über ein natives **Ausschlussstatus** (im Geräteinventarfilter angezeigt als *Ausgeschlossen* / *Nicht ausgeschlossen*). Dieser Status kann nur über das Defender-Portal festgelegt werden — es gibt **keine API** um den nativen Ausschlussstatus eines Geräts programmgesteuert festzulegen.

Da der native Ausschlussstatus nicht automatisiert werden kann, wendet dieses Runbook stattdessen ein benutzerdefiniertes Gerätetag an (standardmäßig `ExcludeFromRemediation`) wenn *Geräte von Microsoft Defender for Endpoint ausschließen* aktiviert ist. Jedes Gerät in der Liste wird über seine Entra ID-Geräte-ID nachgeschlagen und markiert über `POST /api/machines/{id}/tags`, wodurch ein Marker bereitgestellt wird, der zum Filtern und Ansprechen ausgeschlossener Geräte verwendet werden kann.

#### Einmalige Einrichtung: das Tag filterbar machen

Der Portal- **Tags** Filter listet nur Tags auf, die über das Portal erstellt wurden. Ein ausschließlich per API gesetztes Tag wird dem Gerät zugeordnet und ist auf der Gerätestite sichtbar, erscheint aber **nicht** allein im Tags-Filter.

Damit das Ausschluss-Tag sichtbar und für das Filtern im [Defender Device Inventory](https://security.microsoft.com/machines)verwendbar ist, muss ein Client einmal manuell über das Portal mit einem Tag versehen werden (ein Gerät auswählen > **Tags verwalten** > „Neues Tag erstellen“, unter Verwendung exakt desselben Tag-Werts). Nach diesem einmaligen Schritt wird das Tag zu einem bekannten, filterbaren Tag, und dieses Runbook kann es im großen Maßstab auf Geräte anwenden.

> **Hinweis:** Dieses Tag ist nur eine Kennzeichnung — es setzt den nativen Ausschlussstatus des Geräts nicht und hat für sich genommen keine Auswirkung auf die Remediation. Es wirkt nur, wenn eine Defender-Gerätegruppe oder Automatisierungsregel explizit so konfiguriert ist, dass sie mit diesem Tag-Wert übereinstimmt. Solche Regeln gleichen den Tag-Wert direkt ab, unabhängig vom Portal **Tags** -Filter; der einmalige manuelle Schritt beeinflusst also nur, ob das Tag in der Portal-UI zum Filtern auswählbar ist.

Geräte, die über eine Seriennummer angegeben werden und in Intune nicht gefunden werden, haben keine Entra ID-Geräte-ID und werden daher in Defender nicht getaggt.

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

### Ort

Organisation → Geräte → Outphase Devices

**Vollständiger Runbook-Name**

rjgit-org\_devices\_outphase-devices

### Details

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

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * DeviceManagementManagedDevices.PrivilegedOperations.All
    * *Löst das Wipen des Geräts über managedDevices/{id}/wipe aus, wenn die Wipe-Aktion ausgewählt ist*
  * DeviceManagementManagedDevices.ReadWrite.All
    * *Sucht Intune-Geräte anhand von Seriennummer oder azureADDeviceId und löscht sie*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Findet und löscht den Autopilot-Datensatz des Geräts*
  * Device.Read.All
    * *Sucht das Entra-Geräteobjekt und seinen registrierten Besitzer für den Bericht*
* **Typ**: WindowsDefenderATP
  * Machine.Read.All
    * *Findet das Gerät in Microsoft Defender for Endpoint über /machines, gefiltert nach aadDeviceId*
  * Machine.ReadWrite.All
    * *Fügt das Ausschluss-Tag über /machines/{id}/tags hinzu, wenn excludeFromDefender aktiviert ist*

#### RBAC-Rollen

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

### Parameter

#### DeviceListChoice

Ob die Liste Entra ID-Geräte-IDs oder Seriennummern enthält.

| Eigenschaft           | Wert          |
| --------------------- | ------------- |
| Erforderlich          | wahr          |
| Standardwert          | 0             |
| Typ                   | Int32         |
| Anzeigename im Portal | Liste enthält |

**Portaloptionen**

| Portaloption  | Wert |
| ------------- | ---- |
| Geräte-IDs    | 0    |
| Seriennummern | 1    |

#### DeviceList

Geräte-IDs oder Seriennummern, durch Kommas getrennt.

| Eigenschaft           | Wert         |
| --------------------- | ------------ |
| Erforderlich          | wahr         |
| Standardwert          |              |
| Typ                   | Zeichenfolge |
| Anzeigename im Portal | Geräteliste  |

#### intuneAction

Ein vollständiges Wipen löscht alle Benutzer- und Registrierungsdaten auf den Geräten. „Aus Intune löschen“ entfernt nur die Gerätedatensätze für Geräte, die bereits gewiped oder zerstört wurden. „Nicht wipen 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 wipen (Benutzer- oder Registrierungsdaten nicht behalten) | 2    |
| Gerät aus Intune löschen                                                    | 1    |
| Gerät nicht wipen oder aus Intune entfernen                                 | 0    |

#### aadAction

„Löschen“ entfernt die Geräteobjekte aus Entra ID, „Deaktivieren“ behält sie, blockiert aber Anmeldungen von den Geräten, 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

Aus Kompatibilitätsgründen beibehaltener Legacy-Schalter. Die Auswahl unter „Intune-Aktion“ entscheidet, ob die Geräte gewiped werden.

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

#### removeIntuneDevice

Aus Kompatibilitätsgründen beibehaltener Legacy-Schalter. Die Auswahl unter „Intune-Aktion“ entscheidet, ob die Intune-Datensätze gelöscht werden.

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

#### removeAutopilotDevice

Durch das Entfernen der Geräte aus der Autopilot-Datenbank können sie den Tenant verlassen und anderswo registriert werden. Wenn sie beibehalten werden, ist eine spätere Neuverteilung in diesem Tenant möglich.

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

**Portaloptionen**

| Portaloption                  | Wert   |
| ----------------------------- | ------ |
| Gerät aus Autopilot entfernen | wahr   |
| Gerät beibehalten             | falsch |

#### removeAADDevice

Aus Kompatibilitätsgründen beibehaltener Legacy-Schalter. Die Auswahl unter „Entra ID-Objekt“ entscheidet, ob die Entra ID-Objekte gelöscht werden.

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

#### disableAADDevice

Aus Kompatibilitätsgründen beibehaltener Legacy-Schalter. Die Auswahl unter „Entra ID-Objekt“ entscheidet, ob die Entra ID-Objekte deaktiviert werden.

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

#### excludeFromDefender

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

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

**Portaloptionen**

| Portaloption                                                        | Wert   |
| ------------------------------------------------------------------- | ------ |
| Geräte in Microsoft Defender for Endpoint als ausgeschlossen taggen | wahr   |
| Defender-Operationen überspringen                                   | falsch |

#### defenderExclusionTag

Tag-Name, der in Microsoft Defender for Endpoint auf die Geräte geschrieben wird und in Ihren Ausschlussregeln verwendet wird.

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

[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/org/devices/outphase-devices.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.
