Nettoyage planifié des appareils Autopilot

Supprimer les enregistrements Autopilot orphelins et jamais inscrits

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 objet unique. Voir Planification pour plus de détails sur la configuration des planifications du runbook.

Description

Nettoie les inscriptions Windows Autopilot : les appareils dont le numéro de série ne correspond plus à aucun appareil Intune (orphelins) et, en option, les appareils qui n’ont jamais été inscrits et dont l’ancienneté dépasse un certain nombre de jours. Par défaut, il ne fait que signaler 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 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 empreinte matérielle n’a pas été téléversée à nouveau.
La suppression de l’objet d’appareil Entra ID est tout aussi définitive ; ne le faites que pour des enregistrements réellement obsolètes, c’est-à-dire lorsque l’appareil ne s’inscrira plus jamais.

Première exécution recommandée

Exécutez avec le mode de suppression WhatIf (rapport uniquement), qui est le mode par défaut, puis examinez la sortie ou le CSV envoyé par e-mail.
Confirmez que les appareils identifiés sont réellement orphelins ou n’ont jamais été inscrits.
Passez à un mode de suppression uniquement après examen de la liste des candidats.

Interactions des 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 ne supprime que l’identité Autopilot. Supprimer l’appareil Autopilot et l’appareil Entra ID supprime également l’objet d’appareil Entra ID correspondant, qui sinon resterait comme enregistrement obsolète une fois l’identité Autopilot supprimée. Le deuxième mode nécessite l’ Device.ReadWrite.All autorisation.
CleanupOrphanedDevices et CleanupNeverEnrolledDevices sont indépendants ; l’un, l’autre ou les deux peuvent être activés. NeverEnrolledAgeDays s’applique uniquement à la vérification des appareils jamais inscrits.
GroupTagFilter, 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, donc un appareil doit correspondre à chaque filtre renseigné pour rester dans le périmètre. GroupTagFilter correspond exactement à la balise 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 » à « 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 (exactement, insensible à la casse) est retiré du périmètre, quels que soient les autres filtres. Laissez-le vide pour n’exclure rien.

Configuration de l’envoi d’e-mails

L’envoi d’un rapport par e-mail est facultatif et ne se produit que lorsqu’un destinataire (EmailTo) est renseignée. L’adresse de l’expéditeur est récupérée à partir du RJReport.EmailSender paramètre du 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 pour plus de détails sur tous les paramètres disponibles.

Identité visuelle des e-mails

L’e-mail du rapport prend en compte le paramètre facultatif RJReport.Branding.* des paramètres du 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’accentuation et du 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’e-mail du rapport – la valeur par défaut correspondante est utilisée à la place.

Instructions de configuration et exigences relatives aux images : Identité visuelle des e-mails.

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.9) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.5.2)

Planifiable

oui

Autorisations

Autorisations d’application

Type: Microsoft Graph
- Device.ReadWrite.All
  - Recherche les appareils Entra ID par 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
  - Liste 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 l’e-mail

Paramètres

DeleteMode

WhatIf signale uniquement les candidats. Delete Autopilot device supprime les inscriptions 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

GroupTagFilter

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

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Nom d’affichage du portail

Filtre de balise de groupe

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 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’exclure rien.

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 inscriptions des appareils qui ont déjà contacté Intune mais 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 considéré comme orphelin que lorsque son dernier contact avec Intune remonte à plus de ce nombre de jours, de sorte que les appareils récemment actifs sont en sécurité.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Int32

Nom d’affichage du portail

Orphelin après (jours)

CleanupNeverEnrolledDevices

Supprime les inscriptions 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 et anciens

vrai

Non

faux

NeverEnrolledAgeDays

Les inscriptions jamais enregistrées datant de plus de ce nombre de jours, calculés à partir de leur date de création, sont supprimées.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

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 d’expédition de l’e-mail du rapport. Récupérée à partir du paramètre du 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.). Récupérée à partir du paramètre du 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.). Récupérée à partir du paramètre du 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. Récupéré à partir du paramètre du 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’accentuation de l’e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Récupérée à partir du paramètre du tenant RJReport.Branding.AccentColor ; la valeur par défaut RealmJoin est utilisée si vide ou invalide.

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. Récupérée à partir du paramètre du tenant RJReport.Branding.TextColor ; la valeur par défaut RealmJoin est utilisée si vide ou invalide.

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

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

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

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 dans lequel les fichiers du rapport sont téléversés. À définir pour chaque 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 Storage Account pour les téléversements de rapports. Pris à partir du paramètre 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

Storage Account pour les téléversements de rapports. Pris à partir du paramètre 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 Tenant RJReport.StorageAccount.LinkExpiryDays.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Int32

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

Retour à la vue d’ensemble de la référence du runbook

Mis à jour il y a 4 jours

Ce contenu vous a-t-il été utile ?