> 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](/fr/automatisation/runbooks/scheduling.md) pour plus de détails sur la configuration des planifications de runbook.
{% endhint %}
### Description
Nettoie les inscriptions Windows Autopilot : les appareils dont le numéro de série ne correspond plus à aucun appareil Intune (orphelins) et, éventuellement, les appareils qui ne se sont jamais inscrits et qui sont plus anciens qu'un certain âge. Par défaut, il ne signale que ce qu'il supprimerait ; la suppression doit être activée explicitement et peut inclure les objets d'appareil Entra ID correspondants. Le rapport peut être envoyé par e-mail ou fourni sous forme de 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é téléversé à nouveau.
* La suppression de l'objet d'appareil Entra est tout aussi définitive ; ne le faites que pour les enregistrements qui sont réellement morts, c'est-à-dire que l'appareil ne s'inscrira plus jamais.
### Première exécution recommandée
1. Exécutez avec le mode de suppression *WhatIf (rapport uniquement)*, qui est la valeur par défaut, et consultez la sortie ou le CSV envoyé par e-mail.
2. Confirmez que les appareils identifiés sont réellement orphelins ou ne se sont jamais inscrits.
3. Passez à un mode de suppression uniquement après avoir examiné la liste des candidats.
### Interactions des paramètres
* `DeleteMode` est la valeur par défaut *WhatIf (rapport uniquement)*; aucune suppression ne se produit dans ce mode.
* *Supprimer l'appareil Autopilot* ne supprime que l'identité Autopilot. *Supprimer l'appareil Autopilot et Entra* supprime également l'objet d'appareil Entra correspondant, qui serait autrement laissé derrière comme enregistrement obsolète une fois l'identité Autopilot supprimée. Le second mode nécessite l'autorisation `Device.ReadWrite.All` .
* `CleanupOrphanedDevices` et `CleanupNeverEnrolledDevices` sont indépendants ; l'un ou l'autre, ou les deux, peuvent être activés. `NeverEnrolledAgeDays` s'applique uniquement au contrôle des appareils jamais inscrits.
* `Filtre de groupe de tags`, `Filtre fabricant` et `Filtre modè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 à chaque filtre renseigné pour rester dans le champ. `Filtre de groupe de tags` correspond exactement au tag de groupe (insensible à la casse) ; `Filtre fabricant` et `Filtre modèle` correspondent à des sous-chaînes insensibles à la casse, donc « Dell » correspond à « Dell Inc. » et « Surface » correspond à « Surface Laptop 3 ».
* `ExcludeSerialNumbers` est appliqué 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 champ, quels que soient les autres filtres. Laissez-le vide pour n'en exclure aucun.
### Configuration de 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 renseignée. L’adresse de l’expéditeur est prise dans le `RJReport.EmailSender` paramètre Tenant.
Ce runbook envoie des e-mails à l’aide de 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 des paramètres de rapport RealmJoin](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 prend en compte l’optionnel `RJReport.Branding.*` paramètres Tenant :
* **Image d’en-tête et de pied de page** – URL HTTPS publiques, PNG/JPEG/GIF, 200 Ko max. chacune
* **Lien de 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 graphismes 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 non valide, n’empêche jamais l’envoi de l’e-mail du rapport : le défaut correspondant est utilisé à 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.3.0 |
| Modules requis | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
Az.Accounts (>= 5.5.2)
|
| Planifiable | oui |
### Autorisations
#### Autorisations d’application
* **Type**: Microsoft Graph
* Device.ReadWrite.All
* *Recherche les appareils Entra par deviceId et les supprime en mode 'Delete Autopilot and Entra device'*
* 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 Tenant dans la sortie du rapport et dans l'e-mail*
### Paramètres
#### DeleteMode
WhatIf ne signale que les candidats. Delete Autopilot device supprime les enregistrements Autopilot. Delete Autopilot and Entra device supprime également les objets d'appareil Entra ID correspondants.
| Propriété | Valeur |
| -------------------------- | --------------------------- |
| Obligatoire | faux |
| Valeur par défaut | WhatIf (rapport uniquement) |
| Type | Chaîne |
| Nom d’affichage du portail | Mode de suppression |
#### Filtre de groupe de tags
Seuls les appareils avec l'un de ces tags de groupe Autopilot, séparés par des virgules et correspondant exactement. Laisser vide pour tous.
| Propriété | Valeur |
| -------------------------- | ------------------------ |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne |
| Nom d’affichage du portail | Filtre de groupe de tags |
#### Filtre fabricant
Uniquement ces fabricants, séparés par des virgules ; Dell correspond aussi à Dell Inc. Laissez vide pour tous.
| Propriété | Valeur |
| -------------------------- | ------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne |
| Nom d’affichage du portail | Filtre de fabricant |
#### Filtre modè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 | faux |
| Valeur par défaut | |
| Type | Chaîne |
| Nom d’affichage du portail | Filtre modèle |
#### ExcludeSerialNumbers
Numéros de série qui ne sont jamais touchés, séparés par des virgules. Laisser vide pour n'en exclure aucun.
| Propriété | Valeur |
| -------------------------- | ---------------------------- |
| Obligatoire | faux |
| 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 | faux |
| Valeur par défaut | Vrai |
| Type | Booléen |
| Nom d’affichage du portail | Nettoyer les appareils orphelins ? |
#### OrphanedLastContactedDays
Un appareil n'est compté comme orphelin que lorsque son dernier contact avec Intune remonte à plus de ce nombre de jours, afin que les appareils récemment actifs soient en sécurité.
| Propriété | Valeur |
| -------------------------- | ---------------------- |
| Obligatoire | faux |
| 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 qui sont plus anciens que « Jamais inscrit après (jours) ».
| Propriété | Valeur |
| -------------------------- | ---------------------------------------- |
| Obligatoire | faux |
| 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 anciens | vrai |
| Non | faux |
#### NeverEnrolledAgeDays
Les enregistrements 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 | faux |
| Valeur par défaut | 90 |
| Type | Int32 |
| Nom d’affichage du portail | Jamais inscrit 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 | faux |
| 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 dans le paramètre Tenant RJReport.EmailSender.
| Propriété | Valeur |
| ---------------------- | -------------------------------------------------- |
| Obligatoire | faux |
| 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, 200 Ko max.). Prise dans le paramètre Tenant RJReport.Branding.HeaderImageUrl ; l’en-tête RealmJoin par défaut est utilisé si vide.
| Propriété | Valeur |
| ---------------------- | -------------------------------------------------- |
| Obligatoire | faux |
| 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, 200 Ko max.). Prise dans le paramètre Tenant RJReport.Branding.FooterImageUrl ; le pied de page RealmJoin par défaut est utilisé si vide.
| Propriété | Valeur |
| ---------------------- | -------------------------------------------------- |
| Obligatoire | faux |
| 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 dans le paramètre Tenant RJReport.Branding.FooterLink ; realmjoin.com est utilisé si vide.
| Propriété | Valeur |
| ---------------------- | -------------------------------------------------- |
| Obligatoire | faux |
| 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 dans le paramètre Tenant RJReport.Branding.AccentColor ; la valeur par défaut RealmJoin est utilisée si vide ou non valide.
| Propriété | Valeur |
| ---------------------- | -------------------------------------------------- |
| Obligatoire | faux |
| 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 dans le paramètre Tenant RJReport.Branding.TextColor ; la valeur par défaut RealmJoin est utilisée si vide ou non valide.
| Propriété | Valeur |
| ---------------------- | -------------------------------------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |
#### ReportFileFormat
Distribuez le rapport en CSV, en classeur Excel ou dans les deux formats.
| Propriété | Valeur |
| -------------------------- | ---------------------------- |
| Obligatoire | faux |
| 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 |
#### Créer un lien de téléchargement
Télécharge également le rapport et renvoie un lien de téléchargement qui expire après quelques jours.
| Propriété | Valeur |
| -------------------------- | --------------------------------- |
| Obligatoire | faux |
| 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 | faux |
#### Nom du conteneur
Conteneur de stockage vers lequel les fichiers du rapport sont téléversés. À définir par runbook.
| Propriété | Valeur |
| ---------------------- | -------------------------------------------------- |
| Obligatoire | faux |
| Valeur par défaut | cleanup-autopilot-devices |
| Type | Chaîne |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |
#### Nom du groupe de ressources
Groupe de ressources du compte de stockage pour les téléversements du rapport. Pris à partir du paramètre du tenant RJReport.StorageAccount.ResourceGroup.
| Propriété | Valeur |
| ---------------------- | -------------------------------------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |
#### Nom du Storage Account
Compte de stockage pour les téléversements du rapport. Pris à partir du paramètre du tenant RJReport.StorageAccount.StorageAccountName.
| Propriété | Valeur |
| ---------------------- | -------------------------------------------------- |
| Obligatoire | faux |
| 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 tenant RJReport.StorageAccount.LinkExpiryDays.
| Propriété | Valeur |
| ---------------------- | -------------------------------------------------- |
| Obligatoire | faux |
| 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](/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=&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.