> 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/fr/automatisation/runbooks/runbook-references/device/general/outphase-device.md).

# Mettre l’appareil hors service

Effacez cet appareil Windows et nettoyez Intune, Autopilot et Entra ID

### Description

Met ce périphérique Windows hors service. Vous choisissez si l’appareil est effacé ou seulement supprimé d’Intune, et s’il quitte la base de données Autopilot. Son objet Entra ID peut être supprimé, désactivé ou conservé. Facultativement, l’appareil est balisé dans Microsoft Defender for Endpoint afin que les règles qui utilisent cette balise puissent l’exclure de la remédiation automatisée. Un effacement supprime toutes les données utilisateur et d’enrôlement de l’appareil et ne peut pas être annulé.

### balise d’exclusion Microsoft Defender for Endpoint

Microsoft Defender for Endpoint dispose d’un **État d’exclusion** (affiché dans le filtre d’inventaire des appareils sous *Exclu* / *Non exclu*). Cet état ne peut être défini que via le portail Defender — il n’existe **aucune API** pour définir par programme l’état d’exclusion natif d’un appareil.

Comme l’état d’exclusion natif ne peut pas être automatisé, ce runbook applique à la place une balise d’appareil personnalisée (par défaut `ExcludeFromRemediation`) lorsque *Exclure l’appareil de Microsoft Defender for Endpoint* est activé. L’appareil est recherché à l’aide de son ID d’appareil Entra ID et balisé via `POST /api/machines/{id}/tags`, fournissant un repère pouvant servir à filtrer et cibler les appareils exclus.

#### Configuration unique : rendre la balise filtrable

Le filtre du portail **Balises** le filtre n’affiche malheureusement que les balises créées via le portail. Une balise définie uniquement via l’API est attachée à l’appareil et visible sur la page de l’appareil, mais cela ne **ne** apparaît pas d’elle-même dans le filtre Balises.

Pour rendre la balise d’exclusion visible et utilisable pour le filtrage dans l’ [inventaire des appareils Defender](https://security.microsoft.com/machines), un client doit être balisé manuellement une fois via le portail (sélectionnez un appareil > **Gérer les balises** > « Créer une nouvelle balise », en utilisant exactement la même valeur de balise). Après cette étape unique, la balise devient une balise connue et filtrable, et ce runbook peut l’appliquer à grande échelle aux appareils.

> **Remarque :** Cette balise n’est qu’un libellé — elle ne définit pas l’état d’exclusion natif de l’appareil et n’a, à elle seule, aucun effet de remédiation. Elle n’entre en vigueur que si un groupe d’appareils Defender ou une règle d’automatisation est explicitement configuré pour correspondre à cette valeur de balise. De telles règles correspondent directement à la valeur de balise, indépendamment du filtre du portail **Balises** ; ainsi, l’étape manuelle unique n’influe que sur le fait que la balise soit sélectionnable pour le filtrage dans l’interface utilisateur du portail.

Voir [Créer et gérer des balises d’appareil](https://learn.microsoft.com/defender-endpoint/machine-tags#create-tags) pour plus de détails.

### Emplacement

Appareil → Général → Mise hors service de l’appareil

**Nom complet du runbook**

rjgit-device\_general\_outphase-device

### Détails

| Propriété      | Valeur                              |
| -------------- | ----------------------------------- |
| Version        | 1.0.1                               |
| Modules requis | RealmJoin.RunbookHelper (>= 0.8.10) |
| Planifiable    | non                                 |

### Autorisations

#### Autorisations d'application

* **Type**: Microsoft Graph
  * DeviceManagementManagedDevices.PrivilegedOperations.All
    * *Déclenche l’action d’effacement Intune lorsque l’option d’effacement est sélectionnée*
  * DeviceManagementManagedDevices.ReadWrite.All
    * *Recherche l'appareil Intune par azureADDeviceId et le supprime lorsque removeIntuneDevice est défini*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Recherche et supprime l'identité Autopilot lorsque removeAutopilotDevice est défini*
  * Device.Read.All
    * *Identifie l’appareil Entra ID et lit ses propriétaires enregistrés pour la sortie d’état*
* **Type**: WindowsDefenderATP
  * Machine.Read.All
    * *Recherche l’appareil dans Microsoft Defender for Endpoint lorsque excludeFromDefender est activé*
  * Machine.ReadWrite.All
    * *Ajoute la balise d’exclusion via /machines/{id}/tags lorsque excludeFromDefender est activé*

#### rôles RBAC

* Administrateur d’appareils cloud
  * *Requis pour désactiver et supprimer l'objet d'appareil Entra via /devices/{id}*

### Paramètres

#### DeviceId

ID d’appareil Entra ID de l’appareil sur lequel le runbook agit. Défini par le portail à partir de l’appareil sélectionné.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | vrai                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### intuneAction

L’effacement complet supprime toutes les données utilisateur et d’enrôlement sur l’appareil. La suppression d’Intune supprime uniquement l’enregistrement de l’appareil, pour les appareils déjà effacés ou détruits. Ne pas effacer ni supprimer laisse Intune intact.

| Propriété                  | Valeur        |
| -------------------------- | ------------- |
| Obligatoire                | false         |
| Valeur par défaut          | 2             |
| Type                       | Int32         |
| Nom d'affichage du portail | Action Intune |

**Options du portail**

| Option du portail                                                                         | Valeur |
| ----------------------------------------------------------------------------------------- | ------ |
| Effacer complètement l’appareil (sans conserver les données utilisateur ou d’inscription) | 2      |
| Supprimer l'appareil d'Intune (uniquement si l'appareil est déjà effacé ou détruit)       | 1      |
| Ne pas effacer ni supprimer l’appareil d’Intune                                           | 0      |

#### aadAction

Supprimer supprime l’objet d’appareil d’Entra ID, Désactiver le conserve mais bloque les connexions depuis l’appareil, et Conserver laisse Entra ID intact.

| Propriété                  | Valeur         |
| -------------------------- | -------------- |
| Obligatoire                | false          |
| Valeur par défaut          | 2              |
| Type                       | Int32          |
| Nom d'affichage du portail | Objet Entra ID |

**Options du portail**

| Option du portail                   | Valeur |
| ----------------------------------- | ------ |
| Supprimer l’appareil dans Entra ID  | 2      |
| Désactiver l’appareil dans Entra ID | 1      |
| Conserver l’appareil Entra ID       | 0      |

#### wipeDevice

Interrupteur hérité conservé pour compatibilité. Le choix sous « Action Intune » détermine si l’appareil est effacé.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      | Vrai                                               |
| Type                   | Booléen                                            |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### removeIntuneDevice

Interrupteur hérité conservé pour compatibilité. Le choix sous « Action Intune » détermine si l’enregistrement Intune est supprimé.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      | Faux                                               |
| Type                   | Booléen                                            |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### removeAutopilotDevice

Le retrait de l’appareil de la base de données Autopilot lui permet de quitter le Tenant et d’être enregistré ailleurs. Le conserver permet un redéploiement ultérieur dans ce Tenant.

| Propriété                  | Valeur                                                 |
| -------------------------- | ------------------------------------------------------ |
| Obligatoire                | false                                                  |
| Valeur par défaut          | Vrai                                                   |
| Type                       | Booléen                                                |
| Nom d'affichage du portail | Supprimer l’appareil de la base de données Autopilot ? |

**Options du portail**

| Option du portail                                          | Valeur |
| ---------------------------------------------------------- | ------ |
| Retirer d'Autopilot (l'appareil peut quitter le locataire) | vrai   |
| Conserver l'appareil dans Autopilot                        | false  |

#### removeAADDevice

Interrupteur hérité conservé pour compatibilité. Le choix sous « Objet Entra ID » détermine si l’objet Entra ID est supprimé.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      | Vrai                                               |
| Type                   | Booléen                                            |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### disableAADDevice

Interrupteur hérité conservé pour compatibilité. Le choix sous « Objet Entra ID » détermine si l’objet Entra ID est désactivé.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | false                                              |
| Valeur par défaut      | Faux                                               |
| Type                   | Booléen                                            |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### excludeFromDefender

Balise l’appareil dans Microsoft Defender for Endpoint avec la balise d’exclusion afin que les règles qui utilisent cette balise puissent l’exclure de la remédiation automatisée. Ignorer laisse Microsoft Defender for Endpoint intact.

| Propriété                  | Valeur                                                    |
| -------------------------- | --------------------------------------------------------- |
| Obligatoire                | false                                                     |
| Valeur par défaut          | Faux                                                      |
| Type                       | Booléen                                                   |
| Nom d'affichage du portail | Balisé comme exclu dans Microsoft Defender for Endpoint ? |

**Options du portail**

| Option du portail                                                   | Valeur |
| ------------------------------------------------------------------- | ------ |
| Marquer l’appareil comme exclu dans Microsoft Defender for Endpoint | vrai   |
| Ignorer les opérations Defender                                     | false  |

#### defenderExclusionTag

Nom de la balise écrit sur l’appareil dans Microsoft Defender for Endpoint, à utiliser dans vos règles d’exclusion.

| Propriété                  | Valeur                      |
| -------------------------- | --------------------------- |
| Obligatoire                | false                       |
| Valeur par défaut          | ExcludeFromRemediation      |
| Type                       | Chaîne                      |
| Nom d'affichage du portail | balise d’exclusion Defender |

[Retour à l'aperçu de la référence du runbook](https://docs.realmjoin.com/fr/automatisation/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/fr/automatisation/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.
