> 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 cet appareil Windows hors service. Vous choisissez si l’appareil est effacé ou uniquement supprimé d’Intune, et s’il quitte la base de données Autopilot. Son objet Entra ID peut être supprimé, désactivé ou conservé. En option, l’appareil est étiqueté dans Microsoft Defender for Endpoint afin que les règles utilisant cette étiquette puissent l’exclure de la remédiation automatisée. Un effacement supprime toutes les données utilisateur et d’inscription de l’appareil et ne peut pas être annulé.

### balise d'exclusion Microsoft Defender for Endpoint

Microsoft Defender for Endpoint dispose d'un état natif **État d'exclusion** (affiché dans le filtre de l'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 de manière programmatique 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 Defender for Endpoint* est activé. L’appareil est recherché via son ID d’appareil Entra ID et étiqueté via `POST /api/machines/{id}/tags`, fournissant un repère qui peut être utilisé pour filtrer et cibler les appareils exclus.

#### Configuration unique : rendre la balise filtrable

Le **Balises** le filtre n’affiche malheureusement que les étiquettes créées via le portail. Une étiquette définie uniquement via l’API est attachée à l’appareil et visible sur la page de l’appareil, mais elle le fait **pas** apparaît seule 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'une étiquette — elle ne définit pas l'état d'exclusion natif de l'appareil et n'a, à elle seule, aucun effet de remédiation. Elle ne prend effet que si un groupe d'appareils Defender ou une règle d'automatisation est explicitement configuré pour correspondre à cette valeur de balise. Ces règles font correspondre directement la valeur de la balise, indépendamment du portail **Balises** filtre ; l'étape manuelle unique n'influence donc que le fait que la balise soit ou non sélectionnable pour le filtrage dans l'interface 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 → Mettre l’appareil hors service

**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
    * *Résout 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 des appareils cloud
  * *Nécessaire pour désactiver et supprimer l'objet appareil Entra via /devices/{id}*

### Paramètres

#### DeviceId

Identifiant 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’inscription 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                | faux          |
| 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 retire l’objet de l’appareil d’Entra ID, Désactiver le conserve mais bloque les connexions depuis l’appareil, et Conserver laisse Entra ID inchangé.

| Propriété                  | Valeur         |
| -------------------------- | -------------- |
| Obligatoire                | faux           |
| 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écide si l’appareil est effacé.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| 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écide si l’enregistrement Intune est supprimé.

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

#### removeAutopilotDevice

La suppression 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                | faux                                                   |
| 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 Tenant) | vrai   |
| Conserver l'appareil dans Autopilot                     | faux   |

#### removeAADDevice

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

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| 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écide si l’objet Entra ID est désactivé.

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

#### excludeFromDefender

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

| Propriété                  | Valeur                                                                    |
| -------------------------- | ------------------------------------------------------------------------- |
| Obligatoire                | faux                                                                      |
| Valeur par défaut          | Faux                                                                      |
| Type                       | Booléen                                                                   |
| Nom d’affichage du portail | Baliser les appareils comme exclus dans Microsoft Defender for Endpoint ? |

**Options du portail**

| Option du portail                                           | Valeur |
| ----------------------------------------------------------- | ------ |
| Étiqueter l’appareil comme exclu dans Defender for Endpoint | vrai   |
| Ignorer les opérations Defender                             | faux   |

#### defenderExclusionTag

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

| Propriété                  | Valeur                      |
| -------------------------- | --------------------------- |
| Obligatoire                | faux                        |
| 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](/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.