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

# Décommissionner les appareils

Effacer et nettoyer plusieurs appareils à la fois

### Description

Met hors service plusieurs appareils en une seule fois, à partir d'une liste d'ID d'appareil ou de numéros de série. Vous choisissez si les appareils sont effacés ou simplement supprimés d'Intune, et si leur inscription Autopilot est supprimée. Leurs objets Entra ID peuvent être supprimés, désactivés ou conservés. Optionnellement, les appareils sont étiquetés dans Microsoft Defender for Endpoint afin que les règles qui utilisent cette balise puissent les exclure de la remédiation automatisée. Un effacement supprime toutes les données 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 les appareils de Microsoft Defender for Endpoint* est activé. Chaque appareil de la liste est recherché à l'aide de son ID d'appareil Entra ID et balisé 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** ne répertorie que les balises qui ont été 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 elle ne **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.

Les appareils fournis par numéro de série qui ne sont pas trouvés dans Intune n'ont pas d'ID d'appareil Entra ID et ne sont donc pas balisés dans Defender.

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

Organisation → Appareils → Appareils hors phase

**Nom complet du runbook**

rjgit-org\_devices\_outphase-devices

### Détails

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

### Autorisations

#### Autorisations d’application

* **Type**: Microsoft Graph
  * DeviceManagementManagedDevices.PrivilegedOperations.All
    * *Déclenche l'effacement de l'appareil via managedDevices/{id}/wipe lorsque l'action d'effacement est sélectionnée*
  * DeviceManagementManagedDevices.ReadWrite.All
    * *Recherche les appareils Intune par numéro de série ou azureADDeviceId et les supprime*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Trouve et supprime l'enregistrement Autopilot de l'appareil*
  * Device.Read.All
    * *Recherche l'objet d'appareil Entra et son propriétaire enregistré pour le rapport*
* **Type** : WindowsDefenderATP
  * Machine.Read.All
    * *Trouve l'appareil dans Microsoft Defender for Endpoint via /machines filtré par aadDeviceId*
  * Machine.ReadWrite.All
    * *Ajoute la balise d'exclusion via /machines/{id}/tags lorsque excludeFromDefender est activé*

#### rôles RBAC

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

### Paramètres

#### DeviceListChoice

Indique si la liste contient des ID d'appareils Entra ID ou des numéros de série.

| Propriété                  | Valeur            |
| -------------------------- | ----------------- |
| Obligatoire                | vrai              |
| Valeur par défaut          | 0                 |
| Type                       | Int32             |
| Nom d’affichage du portail | La liste contient |

**Options du portail**

| Option du portail | Valeur |
| ----------------- | ------ |
| ID d'appareils    | 0      |
| Numéros de série  | 1      |

#### DeviceList

ID d'appareils ou numéros de série, séparés par des virgules.

| Propriété                  | Valeur            |
| -------------------------- | ----------------- |
| Obligatoire                | vrai              |
| Valeur par défaut          |                   |
| Type                       | Chaîne            |
| Nom d’affichage du portail | Liste d'appareils |

#### intuneAction

L'effacement complet supprime toutes les données utilisateur et d'inscription sur les appareils. La suppression depuis Intune supprime uniquement les enregistrements d'appareil, pour les appareils déjà effacés ou détruits. Ne pas effacer ni supprimer laisse Intune inchangé.

| 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                                                             | 1      |
| Ne pas effacer ni supprimer l'appareil d'Intune                                           | 0      |

#### aadAction

Supprimer retire les objets d'appareil d'Entra ID, Désactiver les conserve mais bloque les connexions depuis les appareils, 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

Commutateur hérité conservé pour compatibilité. Le choix sous « Action Intune » détermine si les appareils sont effacés.

| 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

Commutateur hérité conservé pour compatibilité. Le choix sous « Action Intune » détermine si les enregistrements Intune sont supprimés.

| 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 des appareils de la base de données Autopilot leur permet de quitter le locataire et d'être enregistrés ailleurs. Les conserver permet un redéploiement ultérieur dans ce locataire.

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

**Options du portail**

| Option du portail                | Valeur |
| -------------------------------- | ------ |
| Supprimer l'appareil d'Autopilot | vrai   |
| Conserver l'appareil             | faux   |

#### removeAADDevice

Commutateur hérité conservé pour compatibilité. Le choix sous « Objet Entra ID » détermine si les objets Entra ID sont supprimés.

| 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

Commutateur hérité conservé pour compatibilité. Le choix sous « Objet Entra ID » détermine si les objets Entra ID sont désactivés.

| 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

Ajoute la balise d'exclusion aux appareils dans Microsoft Defender for Endpoint afin que les règles qui utilisent cette balise puissent les 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 |
| ----------------------------------------------------------------------- | ------ |
| Baliser les appareils comme exclus dans Microsoft Defender for Endpoint | vrai   |
| Ignorer les opérations Defender                                         | faux   |

#### defenderExclusionTag

Nom de balise écrit sur les appareils 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/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.