> 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/wipe-device.md).

# Effacer l’appareil

Effacez cet appareil Windows ou macOS et nettoyez ses enregistrements

### Description

Efface cet appareil Windows ou macOS. En option, il nettoie aussi ce qu'il en reste : l'enregistrement Intune, l'inscription Autopilot et l'objet Entra ID peuvent être supprimés ou désactivés. Pour Windows, vous pouvez choisir un effacement protégé et un délai de grâce de conformité plus long après la réinscription ; pour macOS, un code de récupération et la manière dont le système d'exploitation est effacé. Un effacement supprime toutes les données de l'appareil et ne peut pas être annulé. L'effacement peut être ignoré lorsque Microsoft Defender for Endpoint évalue l'appareil comme présentant un risque moyen ou élevé.

### N'effacer que si l'appareil n'est pas à risque

Lorsque *N'effacer que si l'appareil n'est pas à risque* (`skipWipeIfAtRisk`) est activé, le runbook vérifie le score de risque de l'appareil dans Microsoft Defender for Endpoint avant toute modification d'un objet appareil. La recherche utilise l'ID de l'appareil Entra et est la même requête que celle que le **Vérifier l'état de Defender** runbook exécute. La vérification est désactivée par défaut et ne s'exécute que lorsqu'un effacement est demandé ; elle est ignorée lorsque *Ne pas effacer l'appareil* est sélectionné.

Résultats possibles :

* **Aucun risque élevé** (score de risque `Aucun`, `Informationnel` ou `Faible`) : l'effacement et les actions de nettoyage sélectionnées s'exécutent comme d'habitude.
* **Score de risque `Moyen` ou `Élevé`**: le runbook s'arrête avec un avertissement avant l'effacement, l'appartenance au groupe d'exclusion, les modifications Entra et les suppressions Intune/Autopilot. Un appareil avec un score de risque élevé peut être impliqué dans un incident de sécurité, et l'effacer pourrait détruire des données médico-légales (par ex. des journaux). Vérifiez d'abord avec votre équipe de sécurité ; pour effacer quand même l'appareil, exécutez le runbook avec l'option désactivée.
* **Appareil introuvable dans Microsoft Defender for Endpoint**: le score de risque ne peut pas être déterminé. Le runbook le note et poursuit l'effacement, de sorte que les appareils qui ne sont pas intégrés à Defender ne sont pas bloqués.
* **La requête Defender échoue**: le runbook s'arrête sans effacer, de sorte qu'un problème temporaire d'API ne contourne jamais la protection.

#### Activer la vérification par défaut

Pour imposer la vérification à chaque effacement, préconfigurez le paramètre et masquez-le, afin qu'il ne puisse pas être désactivé depuis le portail.

La configuration JSON pour cela est la suivante :

```json
"rjgit-device_general_wipe-device": {
    "parameters": {
        "skipWipeIfAtRisk": {
            "Default": true,
            "Hide": true
        }
    }
}
```

### Ajouter l'appareil à un groupe d'exclusion de conformité

Lorsque *Ajouter l'appareil au groupe d'exclusion de conformité* (`addToExclusionGroup`) est activé, l'appareil Windows effacé est ajouté à un groupe d'exclusion de conformité. Les appareils de ce groupe bénéficient d'un délai de grâce de conformité plus long après leur réinscription via Autopilot (cela reflète le **Vérifier l'exclusion d'intégration de l'appareil** runbook).

Par défaut, le groupe est identifié par son **nom d'affichage** (`exclusionGroupName`). Comme les noms d'affichage ne sont pas garantis uniques, vous pouvez plutôt associer le groupe à son **ID d'objet** (`exclusionGroupId`). Lorsqu'un ID d'objet est fourni, il **remplace toujours** le nom d'affichage, de sorte qu'un conflit de noms ne peut jamais conduire à l'utilisation du mauvais groupe. `exclusionGroupId` est masqué par défaut et doit être défini via la personnalisation du runbook.

Le groupe est résolu et validé lors d'une vérification préliminaire en amont. Si le groupe configuré n'existe pas, le runbook s'interrompt **avant** toute action d'effacement/suppression/désactivation, afin qu'aucun état partiellement appliqué ne soit laissé derrière. L'ajout au groupe est ignoré pour les appareils non Windows et lorsque l'appareil est supprimé d'Entra ID (`removeAADDevice`).

#### Associer le groupe à son ID d'objet (recommandé)

Prédéfinissez l'ID d'objet du groupe et activez l'option, en laissant les champs masqués. Cela évite toute ambiguïté liée à des noms d'affichage en double.

La configuration JSON pour cela est la suivante :

```json
"rjgit-device_general_wipe-device": {
    "parameters": {
        "addToExclusionGroup": {
            "Default": true
        },
        "exclusionGroupId": {
            "Default": "00000000-0000-0000-0000-000000000000",
            "Hide": true
        },
        "exclusionGroupName": {
            "Hide": true
        }
    }
}
```

Remplacez `00000000-0000-0000-0000-000000000000` par l'ID d'objet de votre groupe (Entra ID > Groupes > *votre groupe* > **ID d'objet**).

#### Associer le groupe à son nom d'affichage

Si vous préférez travailler avec le nom d'affichage (et qu'il est unique dans votre Tenant), préconfigurez `exclusionGroupName` et laissez `exclusionGroupId` vide afin que le nom soit utilisé.

La configuration JSON pour cela est la suivante :

```json
"rjgit-device_general_wipe-device": {
    "parameters": {
        "addToExclusionGroup": {
            "Default": true
        },
        "exclusionGroupName": {
            cfg - Intune - Windows - Conformité pour les appareils Autopilot non inscrits (devices),
            "Hide": true
        }
    }
}
```

### Options d'effacement macOS

Les appareils macOS sont effacés via l'action d'effacement d'Intune. Deux options s'appliquent uniquement à eux :

* **Code de récupération (macOS)** (`macOsRecoveryCode`) : les anciens Mac ont besoin d'un code de récupération à six chiffres pour accepter l'effacement ; les appareils plus récents l'ignorent. Le paramètre est masqué dans le portail et peut être préconfiguré via la personnalisation du runbook.
* **Comportement d'oblitération (macOS)** (`macOsObliterationBehavior`) : décide de ce qui se passe lorsque *Effacer tout le contenu et les réglages* (EACS) n'est pas possible. `par défaut` efface les données utilisateur et se rabat sur l'effacement de l'ensemble du système d'exploitation, `doNotObliterate` n'efface jamais le système d'exploitation, `obliterateWithWarning` avertit puis efface le système d'exploitation, `toujours` efface le système d'exploitation dans tous les cas.

Options réservées à Windows (*effacement protégé*, *base de données Autopilot*, *groupe d'exclusion de conformité*) sont ignorées pour les appareils macOS.

### Emplacement

Appareil → Général → Effacer l'appareil

**Nom complet du runbook**

rjgit-device\_general\_wipe-device

### Détails

| Propriété      | Valeur                              |
| -------------- | ----------------------------------- |
| Version        | 1.1.0                               |
| 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 wipeDevice est sélectionné*
  * 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 et lit ses propriétaires enregistrés pour le rapport*
  * GroupMember.ReadWrite.All
    * *Ajoute l'appareil au groupe d'exclusion lorsque addToExclusionGroup est activé*
* **Type** : WindowsDefenderATP
  * Machine.Read.All *(facultatif — fonctionnalité : vérification du risque Defender)*
    * *Lit le score de risque Defender de l'appareil lors de la vérification préliminaire skipWipeIfAtRisk*

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

#### wipeDevice

L'effacement complet supprime toutes les données utilisateur et d'inscription de l'appareil. Ne pas effacer laisse l'appareil intact et n'exécute que les étapes de nettoyage sélectionnées.

| Propriété                  | Valeur                 |
| -------------------------- | ---------------------- |
| Obligatoire                | faux                   |
| Valeur par défaut          | Vrai                   |
| Type                       | Booléen                |
| Nom d’affichage du portail | Effacer cet appareil ? |

**Options du portail**

| Option du portail                                                                                                | Valeur |
| ---------------------------------------------------------------------------------------------------------------- | ------ |
| Effacer complètement l'appareil (Windows : ne conserver ni les données utilisateur ni les données d'inscription) | vrai   |
| Ne pas effacer l'appareil                                                                                        | faux   |

#### useProtectedWipe

Continue d'essayer d'effacer même si l'appareil est éteint entre-temps, afin que l'effacement ne puisse pas être contourné en l'éteignant. Windows uniquement.

| Propriété                  | Valeur                                    |
| -------------------------- | ----------------------------------------- |
| Obligatoire                | faux                                      |
| Valeur par défaut          | Faux                                      |
| Type                       | Booléen                                   |
| Nom d’affichage du portail | Utiliser l'effacement protégé (Windows) ? |

#### removeIntuneDevice

Supprime l'enregistrement de l'appareil dans Intune. N'a de sens que lorsque l'appareil est déjà effacé ou détruit.

| Propriété                  | Valeur                          |
| -------------------------- | ------------------------------- |
| Obligatoire                | faux                            |
| Valeur par défaut          | Faux                            |
| Type                       | Booléen                         |
| Nom d’affichage du portail | Supprimer l'appareil d'Intune ? |

**Options du portail**

| Option du portail                                                                   | Valeur |
| ----------------------------------------------------------------------------------- | ------ |
| Supprimer l'appareil d'Intune (uniquement si l'appareil est déjà effacé ou détruit) | vrai   |
| Conserver l'enregistrement Intune                                                   | faux   |

#### 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. Windows uniquement.

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

**Options du portail**

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

#### removeAADDevice

Indique si l'objet appareil Entra ID est supprimé après l'effacement. Préconfiguré dans la personnalisation du runbook.

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

#### disableAADDevice

La désactivation bloque les connexions depuis l'appareil, mais conserve son objet dans Entra ID. Conserver laisse l'objet Entra ID inchangé.

| Propriété                  | Valeur                                 |
| -------------------------- | -------------------------------------- |
| Obligatoire                | faux                                   |
| Valeur par défaut          | Faux                                   |
| Type                       | Booléen                                |
| Nom d’affichage du portail | Désactiver l'objet appareil Entra ID ? |

**Options du portail**

| Option du portail                      | Valeur |
| -------------------------------------- | ------ |
| Désactiver l'appareil dans Entra ID    | vrai   |
| Conserver l'appareil Entra ID inchangé | faux   |

#### skipWipeIfAtRisk

Ignore l'effacement lorsque Microsoft Defender for Endpoint évalue l'appareil comme présentant un risque moyen ou élevé. Cela préserve les preuves intactes sur un appareil qui peut être impliqué dans un incident de sécurité.

| Propriété                  | Valeur                                           |
| -------------------------- | ------------------------------------------------ |
| Obligatoire                | faux                                             |
| Valeur par défaut          | Faux                                             |
| Type                       | Booléen                                          |
| Nom d’affichage du portail | N'effacer que si l'appareil n'est pas à risque ? |

**Options du portail**

| Option du portail                                                    | Valeur |
| -------------------------------------------------------------------- | ------ |
| N'effacer que si le score de risque Defender n'est ni moyen ni élevé | vrai   |
| Effacer quel que soit le score de risque Defender                    | faux   |

#### addToExclusionGroup

Ajoute l'appareil au groupe d'exclusion de conformité afin qu'il bénéficie d'un délai de grâce de conformité plus long lorsqu'il est réinscrit via Autopilot. Windows uniquement.

| Propriété                  | Valeur                                                  |
| -------------------------- | ------------------------------------------------------- |
| Obligatoire                | faux                                                    |
| Valeur par défaut          | Faux                                                    |
| Type                       | Booléen                                                 |
| Nom d’affichage du portail | Ajouter au groupe d'exclusion de conformité (Windows) ? |

**Options du portail**

| Option du portail                                      | Valeur |
| ------------------------------------------------------ | ------ |
| Ajouter l'appareil au groupe d'exclusion de conformité | vrai   |
| Ne pas ajouter au groupe d'exclusion                   | faux   |

#### exclusionGroupName

Nom d'affichage du groupe d'exclusion auquel l'appareil est ajouté. Un ID d'objet préconfiguré dans la personnalisation du runbook est prioritaire.

| Propriété                  | Valeur                                                                                  |
| -------------------------- | --------------------------------------------------------------------------------------- |
| Obligatoire                | faux                                                                                    |
| Valeur par défaut          | cfg - Intune - Windows - Conformité pour les appareils Autopilot non inscrits (devices) |
| Type                       | Chaîne                                                                                  |
| Nom d’affichage du portail | Nom du groupe d'exclusion de conformité                                                 |

#### exclusionGroupId

ID d'objet du groupe d'exclusion. Préconfiguré dans la personnalisation du runbook et utilisé à la place du nom du groupe pour éviter les conflits de noms.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | faux                                               |
| Valeur par défaut          |                                                    |
| Type                       | Chaîne                                             |
| Nom d’affichage du portail | ID d'objet du groupe d'exclusion de conformité     |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

#### macOsRecoveryCode

Code de récupération pour les anciens Mac qui en ont besoin pour être effacés. Les appareils plus récents l'ignorent. Préconfiguré dans la personnalisation du runbook.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | faux                                               |
| Valeur par défaut          | 123456                                             |
| Type                       | Chaîne                                             |
| Nom d’affichage du portail | Code de récupération (macOS)                       |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

#### macOsObliterationBehavior

Comment un Mac est effacé : effacer d'abord les données utilisateur puis, si nécessaire, effacer le système d'exploitation ; ne jamais effacer le système d'exploitation ; avertir avant d'effacer le système d'exploitation ; ou toujours effacer le système d'exploitation.

| Propriété                  | Valeur                              |
| -------------------------- | ----------------------------------- |
| Obligatoire                | faux                                |
| Valeur par défaut          | par défaut                          |
| Type                       | Chaîne                              |
| Nom d’affichage du portail | Comportement d'oblitération (macOS) |

**Options du portail**

| Option du portail                                                                             | Valeur                |
| --------------------------------------------------------------------------------------------- | --------------------- |
| Effacer les données utilisateur (EACS), puis effacer le système d'exploitation si cela échoue | par défaut            |
| Effacer les données utilisateur (EACS), ne jamais effacer le système d'exploitation           | doNotObliterate       |
| Effacer les données utilisateur (EACS), sinon avertir et effacer le système d'exploitation    | obliterateWithWarning |
| Toujours effacer le système d'exploitation                                                    | toujours              |

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