For the complete documentation index, see llms.txt. This page is also available as Markdown.

Rapport planifié des appareils Windows sans Autopilot

Rapporter les appareils Windows dans Entra ID sans enregistrement Autopilot

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

Liste les objets d’appareil Windows dans Entra ID auxquels aucune inscription Windows Autopilot ne fait référence. Ces objets orphelins proviennent généralement d’appareils réinitialisés, réimaginés ou remplacés sans nettoyage, de sorte que la liste indique ce qui peut être examiné et supprimé. Rien n’est modifié. Le rapport peut être envoyé par e-mail ou fourni sous forme de lien de téléchargement.

Signalement des appareils Windows orphelins

Ce runbook répertorie chaque objet d’appareil Windows dans Entra ID et le compare aux identités d’appareil Windows Autopilot dans Intune. Les appareils qui n’ont aucun objet Autopilot associé (correspondance effectuée via l’objet Autopilot azureActiveDirectoryDeviceId) sont signalés comme candidats au nettoyage.

Deux commutateurs Oui/Non contrôlent la sortie :

  • Envoyer le rapport par e-mail ? — lorsqu’il est activé, le champ d’adresse du destinataire (EmailTo) s’affiche et le rapport est envoyé par e-mail avec le CSV en pièce jointe.

  • Créer un lien de téléchargement du fichier ? — lorsqu’il est activé, le CSV est téléversé vers un Azure Storage Account et un lien de téléchargement à durée limitée est renvoyé.

Les deux peuvent être combinés ou utilisés indépendamment. Si les deux sont désactivés, le rapport est uniquement imprimé dans la sortie du runbook.

Configuration concernant le Storage Account

Le rapport CSV est téléversé vers un Azure Storage Account. Le Storage Account cible est issu des paramètres partagés RJReport du Tenant, afin qu’il puisse être configuré une seule fois et réutilisé dans tous les runbooks de rapport :

  • RJReport.StorageAccount.ResourceGroup

  • RJReport.StorageAccount.StorageAccountName

  • RJReport.StorageAccount.LinkExpiryDays (facultatif, valeur par défaut : 6)

Le nom du conteneur est configuré par runbook (paramètre Nom du conteneur, par défaut windows-devices-without-autopilot) et ne fait volontairement pas partie des paramètres globaux RJReport.

Voir la documentation des paramètres de rapport RealmJoin pour plus de détails sur tous les paramètres disponibles.

L’identité managée du runbook nécessite au minimum Contributeur un accès à l’abonnement ou au groupe de ressources contenant le Storage Account.

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.

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 → Rapporter les appareils Windows sans Autopilot (planifié)

Nom complet du runbook

rjgit-org_devices_report-windows-devices-without-autopilot_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.Read.All

      • Répertorie les appareils Entra filtrés sur Windows afin d’énumérer tous les appareils Windows enregistrés

    • DeviceManagementServiceConfig.Read.All

      • Répertorie les windowsAutopilotDeviceIdentities afin de détecter les appareils dépourvus d’une inscription Autopilot

    • Organization.Read.All

      • Lit /organization pour le nom du Tenant dans le rapport

    • Mail.Send (facultatif — fonctionnalité : rapport par e-mail)

      • Envoie le rapport via Send-RjReportEmail lorsque le reporting par e-mail est activé

Notes sur les autorisations

Azure IaaS : - Contributor - accès à l’abonnement ou au groupe de ressources utilisé pour l’exportation

Paramètres

SendMail

Envoie le rapport à l’adresse e-mail du destinataire.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Faux

Type

Booléen

Nom d’affichage du portail

Envoyer le rapport par e-mail ?

Options du portail

Option du portail
Valeur

Oui - envoyer le rapport par e-mail

vrai

Non - ne pas envoyer d’e-mail

faux

EmailTo

Envoyez le rapport à ces adresses. Séparez-en plusieurs par des virgules ; chaque destinataire reçoit un e-mail séparé.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Nom d’affichage du portail

Adresse(s) e-mail du destinataire

Masqué dans le portail

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

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)

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

Masqué dans le portail

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

Options du portail

Option du portail
Valeur

CSV et XLSX

CSV et XLSX

CSV uniquement

CSV uniquement

XLSX uniquement

XLSX uniquement

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

Vrai

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

windows-devices-without-autopilot

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

6

Type

Int32

Masqué dans le portail

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

Mis à jour

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