> 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 gelöscht oder nur aus Intune entfernt 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 markiert, sodass Regeln, die das Tag verwenden, sie von der automatisierten Problembehandlung ausschließen können. Durch das Löschen werden alle Daten entfernt und es 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äte aus Defender for Endpoint ausschließen* aktiviert ist. Jedes Gerät in der Liste 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** des Portals listet nur Tags auf, die über das Portal erstellt wurden. Ein ausschließlich über die API festgelegtes Tag wird dem Gerät zugewiesen und ist auf der Geräteseite sichtbar, wird jedoch **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.

Geräte, die anhand einer Seriennummer angegeben wurden und nicht in Intune gefunden werden, haben keine Entra ID-Geräte-ID und werden daher nicht in Defender markiert.

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

### Speicherort

Organisation → Geräte → Geräte außer Betrieb nehmen

**Voller 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 Löschen des Geräts über managedDevices/{id}/wipe aus, wenn die Löschaktion ausgewählt ist*
  * DeviceManagementManagedDevices.ReadWrite.All
    * *Sucht Intune-Geräte anhand der 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 dessen registrierten Besitzer für den Bericht*
* **Typ**: WindowsDefenderATP
  * Machine.Read.All
    * *Findet das Gerät in Defender for Endpoint über /machines, gefiltert nach aadDeviceId*
  * Machine.ReadWrite.All
    * *Fügt über /machines/{id}/tags das Ausschluss-Tag hinzu, wenn excludeFromDefender aktiviert ist*

#### RBAC-Rollen

* Cloud-Geräteadministrator
  * *Erforderlich zum Deaktivieren und Löschen von Entra-Geräteobjekten über /devices/{id}*

### 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

Vollständig löschen entfernt alle Benutzer- und Registrierungsdaten auf den Geräten. Aus Intune löschen entfernt nur die Gerätedatensätze, 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                                                         | 1    |
| Gerät nicht aus Intune löschen oder entfernen                                    | 0    |

#### aadAction

Löschen entfernt die Geräteobjekte aus Entra ID, Deaktivieren behält sie bei, blockiert jedoch 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 beibehaltene Legacy-Option. Die Auswahl unter „Intune-Aktion“ entscheidet, ob die Geräte gelöscht werden.

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

#### removeIntuneDevice

Aus Kompatibilitätsgründen beibehaltene Legacy-Option. 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 (vorkonfiguriert über die Runbook-Anpassung) |

#### removeAutopilotDevice

Das Entfernen der Geräte aus der Autopilot-Datenbank ermöglicht es ihnen, den Tenant zu verlassen und an anderer Stelle registriert zu werden. Wenn sie beibehalten werden, ist eine spätere erneute Bereitstellung in diesem Tenant möglich.

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

**Portaloptionen**

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

#### removeAADDevice

Aus Kompatibilitätsgründen beibehaltene Legacy-Option. 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 (vorkonfiguriert über die Runbook-Anpassung) |

#### disableAADDevice

Aus Kompatibilitätsgründen beibehaltene Legacy-Option. 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 (vorkonfiguriert über die Runbook-Anpassung) |

#### excludeFromDefender

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

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

**Portaloptionen**

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

#### defenderExclusionTag

Name des Tags, das zur Verwendung in Ihren Ausschlussregeln auf die Geräte in Defender for Endpoint geschrieben wird.

| 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/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.