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

### Beschreibung

Dieses Runbook nimmt mehrere Geräte außer Betrieb, basierend auf einer durch Kommas getrennten Liste von Geräte-IDs oder Seriennummern. Es kann optional Geräte in Intune löschen und die entsprechenden Entra ID-Geräteobjekte löschen oder deaktivieren. Optional kann jedes Gerät in Microsoft Defender for Endpoint markiert werden, um es als von der Behebung ausgeschlossen zu kennzeichnen. HINWEIS: Das Ausschluss-Tag wird dem Gerät zugewiesen, erscheint jedoch im Filter „Tags“ des Defender-Portals erst dann, nachdem es einmal über das Portal erstellt wurde (Gerät > Tags verwalten > „Neues Tag erstellen“).

### Microsoft Defender for Endpoint-Ausschluss-Tag

Microsoft Defender for Endpoint verfügt über einen nativen **Ausschlussstatus** (im Filter „Gerätebestand“ angezeigt als *Ausgeschlossen* / *Nicht ausgeschlossen*). Dieser Status kann nur über das Defender-Portal gesetzt 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äte-Tag an (Standard `ExcludeFromRemediation`) wenn *Ausschluss von Geräten aus Microsoft Defender for Endpoint* aktiviert ist. Jedes Gerät in der Liste wird über seine Entra ID-Geräte-ID gesucht und per `POST /api/machines/{id}/tags`markiert, wodurch ein Kennzeichen bereitgestellt wird, das zum Filtern und Ansteuern 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 Tag, das ausschließlich über die API gesetzt wurde, wird dem Gerät zugeordnet und auf der Geräte-Seite sichtbar, erscheint aber **nicht** von selbst im Tags-Filter.

Um das Ausschluss-Tag sichtbar und für das Filtern im [Defender-Gerätebestand](https://security.microsoft.com/machines)nutzbar zu machen, muss ein Client einmal manuell über das Portal markiert werden (Gerät auswählen > **Tags verwalten** > „Neues Tag erstellen“, wobei exakt derselbe Tag-Wert verwendet wird). 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 Kennzeichnung — es setzt nicht den nativen Ausschlussstatus des Geräts und hat für sich genommen keine Auswirkung auf die Behebung. Es wird nur wirksam, wenn eine Defender-Gerätegruppe oder Automatisierungsregel ausdrücklich so konfiguriert ist, dass dieser Tag-Wert übereinstimmen muss. Solche Regeln gleichen den Tag-Wert direkt ab, unabhängig vom Portal **Tags** Filter, daher betrifft der einmalige manuelle Schritt nur, ob das Tag im Portal-UI zum Filtern auswählbar ist.

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

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

### Ort

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

**Vollständiger Runbook-Name**

rjgit-org\_devices\_outphase-devices

### Details

| Eigenschaft          | Wert                               |
| -------------------- | ---------------------------------- |
| Version              | 1.2.1                              |
| Erforderliche Module | RealmJoin.RunbookHelper (>= 0.8.9) |
| 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 wird*
  * 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-Eintrag 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

Legt fest, ob die Liste Geräte-IDs oder Seriennummern enthält.

| Eigenschaft           | Wert                |
| --------------------- | ------------------- |
| Erforderlich          | wahr                |
| Standardwert          | 0                   |
| Typ                   | Int32               |
| Anzeigename im Portal | Listentyp auswählen |

**Portaloptionen**

| Portaloption                                   | Wert |
| ---------------------------------------------- | ---- |
| Durch Kommas getrennte Liste von Geräte-IDs    | 0    |
| Durch Kommas getrennte Liste von Seriennummern | 1    |

#### DeviceList

Durch Kommas getrennte Liste von Geräte-IDs oder Seriennummern.

| Eigenschaft           | Wert                         |
| --------------------- | ---------------------------- |
| Erforderlich          | wahr                         |
| Standardwert          |                              |
| Typ                   | Zeichenfolge                 |
| Anzeigename im Portal | Durch Kommas getrennte Liste |

#### intuneAction

Legt fest, ob das Gerät gelöscht, aus Intune entfernt oder Intune-Aktionen übersprungen werden sollen.

| Eigenschaft           | Wert                  |
| --------------------- | --------------------- |
| Erforderlich          | falsch                |
| Standardwert          | 2                     |
| Typ                   | Int32                 |
| Anzeigename im Portal | Dieses Gerät löschen? |

**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 löschen oder aus Intune entfernen                                    | 0    |

#### aadAction

Legt fest, ob das Entra ID-Gerät gelöscht, deaktiviert oder Entra ID-Aktionen übersprungen werden sollen.

| Eigenschaft           | Wert                       |
| --------------------- | -------------------------- |
| Erforderlich          | falsch                     |
| Standardwert          | 2                          |
| Typ                   | Int32                      |
| Anzeigename im Portal | Gerät in Entra ID löschen? |

**Portaloptionen**

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

#### wipeDevice

Interne Kennzeichnung, abgeleitet von intuneAction.

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

#### removeIntuneDevice

Interne Kennzeichnung, abgeleitet von intuneAction.

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

#### removeAutopilotDevice

„Gerät aus Autopilot entfernen“ (Endwert: true) oder „Gerät in Autopilot behalten“ (Endwert: false) steuert, ob das Gerät aus der Autopilot-Datenbank gelöscht wird.

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

**Portaloptionen**

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

#### removeAADDevice

Interne Kennzeichnung, abgeleitet von aadAction.

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

#### disableAADDevice

Interne Kennzeichnung, abgeleitet von aadAction.

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

#### excludeFromDefender

Wenn auf true gesetzt, wird jedes Gerät in Microsoft Defender for Endpoint mit dem angegebenen Ausschluss-Tag markiert. Wenn auf false gesetzt, wird der Defender-Schritt vollständig übersprungen.

| Eigenschaft           | Wert                                                     |
| --------------------- | -------------------------------------------------------- |
| Erforderlich          | falsch                                                   |
| Standardwert          | Falsch                                                   |
| Typ                   | Boolescher Wert                                          |
| Anzeigename im Portal | Geräte aus Microsoft Defender for Endpoint ausschließen? |

**Portaloptionen**

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

#### defenderExclusionTag

Das Tag, das dem Gerät in Microsoft Defender for Endpoint hinzugefügt wird, um es als ausgeschlossen zu kennzeichnen. Standardwert: „ExcludeFromRemediation“.

| 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-references/org/devices/outphase-devices.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.