> 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/cleanup-autopilot-devices_scheduled.md).

# Nettoyage planifié des appareils Autopilot

Supprimer les enregistrements Autopilot orphelins et jamais inscrits

{% hint style="info" %}
Il s'agit d'un runbook planifié. Il est conçu pour s'exécuter selon une planification récurrente plutôt que d'être déclenché pour un seul objet. Voir [Planification](https://docs.realmjoin.com/fr/automatisation/runbooks/scheduling.md) pour plus de détails sur la configuration des planifications de runbook.
{% endhint %}

### Description

Nettoie les enregistrements Windows Autopilot : les appareils dont le numéro de série ne correspond plus à aucun appareil Intune (orphelins) et, en option, les appareils qui ne se sont jamais inscrits et dont l'ancienneté dépasse un âge donné. Par défaut, il indique seulement ce qu'il supprimerait ; la suppression doit être activée explicitement et peut inclure les objets appareil Entra ID correspondants. Le rapport peut être envoyé par e-mail ou fourni via un lien de téléchargement.

### La suppression est irréversible

* La suppression d'une identité d'appareil Autopilot la supprime définitivement de Windows Autopilot. Il n'existe ni suppression réversible ni corbeille pour les enregistrements Autopilot.
* L'appareil physique ne peut pas réintégrer Autopilot tant que son hachage matériel n'a pas été à nouveau chargé.
* La suppression de l'objet appareil Entra ID est également permanente ; ne le faites que pour les enregistrements qui sont réellement obsolètes, c'est-à-dire lorsque l'appareil ne s'inscrira plus jamais.

### Première exécution recommandée

1. Exécuter en mode suppression *WhatIf (rapport uniquement)*, qui est le mode par défaut, et examinez la sortie ou le CSV envoyé par e-mail.
2. Confirmez que les appareils identifiés sont bien orphelins ou ne se sont jamais inscrits.
3. Passez à un mode de suppression uniquement après avoir examiné la liste des candidats.

### Interactions entre paramètres

* `DeleteMode` est défini par défaut sur *WhatIf (rapport uniquement)*; aucune suppression n'a lieu dans ce mode.
* *Supprimer l'appareil Autopilot* supprime uniquement l'identité Autopilot. *Supprimer l'appareil Autopilot et l'appareil Entra ID* supprime en plus l'objet appareil Entra ID correspondant, qui sinon serait laissé derrière comme un enregistrement obsolète une fois l'identité Autopilot supprimée. Le second mode nécessite le `Device.ReadWrite.All` autorisation.
* `CleanupOrphanedDevices` et `CleanupNeverEnrolledDevices` sont indépendants ; l'un ou l'autre, ou les deux, peuvent être activés. `NeverEnrolledAgeDays` s'applique uniquement à la vérification des appareils jamais inscrits.
* `GroupTagFilter`, `FiltreFabricant` et `FiltreModèle` sont facultatifs ; laissez un filtre vide pour évaluer toutes les valeurs de cette dimension. Lorsque plusieurs filtres sont définis, ils sont combinés avec AND, de sorte qu'un appareil doit correspondre à tous les filtres renseignés pour rester dans le périmètre. `GroupTagFilter` correspond exactement à la balise de groupe (insensible à la casse) ; `FiltreFabricant` et `FiltreModèle` correspondent à des sous-chaînes insensibles à la casse, donc « Dell » correspond à « Dell Inc. » et « Surface » correspond à « Surface Laptop 3 ».
* `ExcludeSerialNumbers` s'applique après les filtres AND comme exclusion : un appareil dont le numéro de série figure dans la liste (correspondance exacte, insensible à la casse) est retiré du périmètre quels que soient les autres filtres. Laissez vide pour n'en exclure aucun.

### Configuration relative à l'envoi d'e-mails

L'envoi d'un rapport par e-mail est facultatif et n'a lieu que lorsqu'un destinataire (`EmailTo`) est fourni. L'adresse de l'expéditeur est prise dans le paramètre `RJReport.EmailSender` du Tenant.

Ce runbook envoie des e-mails en utilisant l'API Microsoft Graph. Pour envoyer des e-mails via l'API Graph, vous devez configurer une adresse e-mail existante dans la personnalisation du runbook.

Voir la [documentation RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) pour plus de détails sur tous les paramètres disponibles.

#### Branding des e-mails

L'e-mail du rapport tient compte des paramètres facultatifs du `RJReport.Branding.*` Tenant :

* **Image d'en-tête et de pied de page** – URL HTTPS publiques, PNG/JPEG/GIF, max. 200 Ko chacune
* **Lien du pied de page** – cible de l'image de pied de page
* **Couleur d'accent et de texte** – valeurs hexadécimales à 6 chiffres, par ex. `#0052cc`

Lorsque ces paramètres ne sont pas configurés, les graphiques et couleurs par défaut de RealmJoin sont utilisés. Une image qui ne peut pas être téléchargée ou validée, ou une valeur de couleur invalide, n'empêche jamais l'envoi de l'e-mail du rapport – la valeur par défaut correspondante est utilisée à la place.

Instructions de configuration et exigences relatives aux images : [Branding des e-mails](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Emplacement

Organisation → Appareils → Nettoyage des appareils Autopilot (planifié)

**Nom complet du runbook**

rjgit-org\_devices\_cleanup-autopilot-devices\_scheduled

### Détails

| Propriété      | Valeur                                                                                                             |
| -------------- | ------------------------------------------------------------------------------------------------------------------ |
| Version        | 1.4.0                                                                                                              |
| Modules requis | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| Planifiable    | oui                                                                                                                |

### Autorisations

#### Autorisations d'application

* **Type**: Microsoft Graph
  * Device.ReadWrite.All
    * *Recherche les appareils Entra ID à l'aide de deviceId et les supprime en mode « Supprimer l'appareil Autopilot et l'appareil Entra ID »*
  * DeviceManagementManagedDevices.Read.All
    * *Lit les appareils Windows gérés par Intune pour trouver les numéros de série Autopilot qui ne sont plus présents dans Intune*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *Répertorie les windowsAutopilotDeviceIdentities et supprime les identités Autopilot obsolètes*
  * Mail.Send *(facultatif — fonctionnalité : rapport par e-mail)*
    * *Envoie l'e-mail du rapport de nettoyage via Send-RjReportEmail lorsque EmailTo est configuré*
  * Organization.Read.All
    * *Lit /organization pour afficher le nom d'affichage du locataire dans la sortie du rapport et dans l'e-mail*

### Paramètres

#### DeleteMode

WhatIf ne fait que signaler les candidats. Delete Autopilot device supprime les enregistrements Autopilot. Delete Autopilot and Entra device supprime également les objets appareil Entra ID correspondants.

| Propriété                  | Valeur                      |
| -------------------------- | --------------------------- |
| Obligatoire                | false                       |
| Valeur par défaut          | WhatIf (rapport uniquement) |
| Type                       | Chaîne                      |
| Nom d'affichage du portail | Mode de suppression         |

#### GroupTagFilter

Uniquement les balises de groupe Autopilot de ces appareils, séparées par des virgules et correspondant exactement. Laissez vide pour tous.

| Propriété                  | Valeur                     |
| -------------------------- | -------------------------- |
| Obligatoire                | false                      |
| Valeur par défaut          |                            |
| Type                       | Chaîne                     |
| Nom d'affichage du portail | Filtre de balise de groupe |

#### FiltreFabricant

Uniquement ces fabricants, séparés par des virgules ; Dell correspond aussi à Dell Inc. Laissez vide pour tous.

| Propriété                  | Valeur              |
| -------------------------- | ------------------- |
| Obligatoire                | false               |
| Valeur par défaut          |                     |
| Type                       | Chaîne              |
| Nom d'affichage du portail | Filtre de fabricant |

#### FiltreModèle

Uniquement ces modèles, séparés par des virgules ; Surface correspond aussi à Surface Laptop 3. Laissez vide pour tous.

| Propriété                  | Valeur           |
| -------------------------- | ---------------- |
| Obligatoire                | false            |
| Valeur par défaut          |                  |
| Type                       | Chaîne           |
| Nom d'affichage du portail | Filtre de modèle |

#### ExcludeSerialNumbers

Numéros de série qui ne sont jamais pris en compte, séparés par des virgules. Laissez vide pour n'en exclure aucun.

| Propriété                  | Valeur                       |
| -------------------------- | ---------------------------- |
| Obligatoire                | false                        |
| Valeur par défaut          |                              |
| Type                       | Chaîne                       |
| Nom d'affichage du portail | Exclure les numéros de série |

#### CleanupOrphanedDevices

Supprime les enregistrements des appareils qui ont déjà contacté Intune mais qui n'y existent plus.

| Propriété                  | Valeur                             |
| -------------------------- | ---------------------------------- |
| Obligatoire                | false                              |
| Valeur par défaut          | Vrai                               |
| Type                       | Booléen                            |
| Nom d'affichage du portail | Nettoyer les appareils orphelins ? |

#### OrphanedLastContactedDays

Un appareil n'est considéré comme orphelin que si son dernier contact avec Intune date d'il y a plus de ce nombre de jours, de sorte que les appareils récemment actifs sont sans risque.

| Propriété                  | Valeur                 |
| -------------------------- | ---------------------- |
| Obligatoire                | false                  |
| Valeur par défaut          | 90                     |
| Type                       | Int32                  |
| Nom d'affichage du portail | Orphelin après (jours) |

#### CleanupNeverEnrolledDevices

Supprime les enregistrements des appareils qui n'ont jamais contacté Intune et dont l'ancienneté dépasse « Jamais inscrits après (jours) ».

| Propriété                  | Valeur                                   |
| -------------------------- | ---------------------------------------- |
| Obligatoire                | false                                    |
| Valeur par défaut          | Faux                                     |
| Type                       | Booléen                                  |
| Nom d'affichage du portail | Nettoyer les appareils jamais inscrits ? |

**Options du portail**

| Option du portail                                 | Valeur |
| ------------------------------------------------- | ------ |
| Oui, supprimer les appareils jamais inscrits âgés | vrai   |
| Aucune                                            | false  |

#### NeverEnrolledAgeDays

Les enregistrements des appareils jamais inscrits datant de plus de ce nombre de jours, comptés à partir de leur date de création, sont supprimés.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | false                                              |
| Valeur par défaut          | 90                                                 |
| Type                       | Int32                                              |
| Nom d'affichage du portail | Jamais inscrits après (jours)                      |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

#### EmailTo

Envoyez le rapport de nettoyage à ces adresses, séparées par des virgules. Laissez vide pour n'envoyer aucun e-mail.

| Propriété                  | Valeur                            |
| -------------------------- | --------------------------------- |
| Obligatoire                | false                             |
| Valeur par défaut          |                                   |
| Type                       | Chaîne                            |
| Nom d'affichage du portail | Adresse(s) e-mail du destinataire |

#### EmailFrom

Adresse de l'expéditeur de l'e-mail du rapport. Prise du paramètre Tenant RJReport.EmailSender.

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

#### BrandingHeaderImageUrl

Image d'en-tête de l'e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, max 200 Ko). Prise du paramètre Tenant RJReport.Branding.HeaderImageUrl ; l'en-tête RealmJoin par défaut est utilisé lorsqu'il est vide.

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

#### BrandingFooterImageUrl

Image de pied de page de l'e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, max 200 Ko). Prise du paramètre Tenant RJReport.Branding.FooterImageUrl ; le pied de page RealmJoin par défaut est utilisé lorsqu'il est vide.

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

#### BrandingFooterLink

Lien derrière l'image de pied de page de l'e-mail du rapport. Pris du paramètre Tenant RJReport.Branding.FooterLink ; realmjoin.com est utilisé lorsqu'il est vide.

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

#### BrandingAccentColor

Couleur d'accent de l'e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Prise du paramètre Tenant RJReport.Branding.AccentColor ; la valeur par défaut RealmJoin est utilisée lorsqu'elle est vide ou invalide.

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

#### BrandingTextColor

Couleur du texte de l'e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Prise du paramètre Tenant RJReport.Branding.TextColor ; la valeur par défaut RealmJoin est utilisée lorsqu'elle est vide ou invalide.

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

#### ReportFileFormat

Remettez le rapport au format CSV, sous forme de classeur Excel, ou les deux.

| Propriété                  | Valeur                       |
| -------------------------- | ---------------------------- |
| Obligatoire                | false                        |
| Valeur par défaut          | CSV et XLSX                  |
| Type                       | Chaîne                       |
| Nom d'affichage du portail | Format du fichier de rapport |

**Options du portail**

| Option du portail | Valeur          |
| ----------------- | --------------- |
| CSV et XLSX       | CSV et XLSX     |
| CSV uniquement    | CSV uniquement  |
| XLSX uniquement   | XLSX uniquement |

#### CreateDownloadLink

Télécharge aussi le rapport et renvoie un lien de téléchargement qui expire après quelques jours.

| Propriété                  | Valeur                            |
| -------------------------- | --------------------------------- |
| Obligatoire                | false                             |
| Valeur par défaut          | Faux                              |
| Type                       | Booléen                           |
| Nom d'affichage du portail | Créer un lien de téléchargement ? |

**Options du portail**

| Option du portail                                                 | Valeur |
| ----------------------------------------------------------------- | ------ |
| Oui - téléverser le rapport et renvoyer un lien de téléchargement | vrai   |
| Non - ne pas créer de lien de téléchargement                      | false  |

#### ContainerName

Conteneur de stockage vers lequel les fichiers du rapport sont téléversés. À définir par runbook.

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

#### ResourceGroupName

Groupe de ressources du Storage Account pour les téléversements de rapports. Pris à partir du paramètre du locataire RJReport.StorageAccount.ResourceGroup.

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

#### StorageAccountName

Storage Account pour les téléversements de rapports. Pris à partir du paramètre du locataire RJReport.StorageAccount.StorageAccountName.

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

#### SubscriptionId

ID d'abonnement du Storage Account pour les téléversements de rapports. Pris à partir du paramètre du locataire RJReport.StorageAccount.SubscriptionId ; lorsque vide, l'abonnement sur lequel l'identité managée se connecte est utilisé.

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

#### LinkExpiryDays

Nombre de jours pendant lesquels un lien de téléchargement reste valide. Pris à partir du paramètre du locataire RJReport.StorageAccount.LinkExpiryDays.

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

[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/org/devices/cleanup-autopilot-devices_scheduled.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.
