> 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/list-mobile-devices.md).
# Lister les appareils mobiles
Lister les appareils mobiles gérés avec les détails d'inventaire et de réseau
### Description
Liste tous les appareils Android, iOS et iPadOS gérés par Intune avec leur inventaire : IMEI, numéro de série, numéro de téléphone, opérateur, propriété, conformité et inscription. En option, la dernière adresse IP signalée et le sous-réseau, l’ICCID, l’identifiant eSIM, la technologie cellulaire, l’UDID, l’état de santé de la batterie et l’état d’iPad partagé sont ajoutés. Cela indique sur quels réseaux les appareils ont été actifs pour la dernière fois. La liste peut être limitée par plateforme, par groupe d’appareils ou par groupe des utilisateurs principaux. Le rapport peut être envoyé par e-mail ou fourni sous forme de lien de téléchargement.
### Cas d’utilisation courants
* Inventaire de tous les appareils mobiles, y compris l’IMEI, le numéro de série, le numéro de téléphone et l’opérateur
* Identifier dans quels réseaux (Wi‑Fi) les appareils mobiles ont été actifs pour la dernière fois, par exemple des scanners portatifs sur plusieurs sites d’entrepôt
* Vérifier l’état de conformité, de supervision et de chiffrement du parc mobile
* Inventaire SIM/eSIM via l’ICCID et l’identifiant eSIM
* Transmettre l’inventaire mobile complet à la gestion des actifs sous forme de classeur Excel ou de fichier CSV
### Colonnes de sortie
Chaque exécution écrit un **tableau récapitulatif** tableau (comptes d’appareils par plateforme, appareils non conformes et appareils appartenant à des particuliers et - avec les détails réseau activés - le nombre d’appareils sans adresse IP signalée) ainsi que jusqu’à trois tableaux d’appareils dans l’onglet Output Data du portail RealmJoin. La sortie de la console affiche les mêmes comptes, ainsi que la répartition par état de conformité et propriété et les filtres appliqués. Les mêmes données peuvent également être fournies sous forme de fichiers de rapport par e-mail et/ou via un lien de téléchargement ; voir la section sur la livraison des rapports ci-dessous.
#### Inventaire (toujours affiché)
| Colonne | Source et signification |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Nom de l’appareil | Nom de l’appareil tel que signalé par Intune |
| PrimaryUser | Nom principal de l’utilisateur principal |
| OperatingSystem / OSVersion | Système d’exploitation (Android, iOS, iPadOS) et version |
| Manufacturer / Model | Fabricant et modèle du matériel |
| Numéro de série | Numéro de série matériel |
| IMEI | Identité internationale d’équipement mobile de l’appareil |
| PhoneNumber | Numéro de téléphone de la SIM - présent uniquement lorsque `IncludePhoneNumber` est activé, sinon la colonne est entièrement omise |
| Carrier | Opérateur de l’abonné de la SIM |
| Ownership | `entreprise` ou `personnel` |
| Conformité | État de conformité Intune |
| LastSync | Horodatage de la dernière vérification Intune réussie |
#### Sécurité et inscription (toujours affiché)
| Colonne | Source et signification |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Supervisé | Mode supervisé iOS/iPadOS |
| Chiffré | État de chiffrement de l’appareil |
| Jailbreaké | Indique si l’appareil est jailbreaké ou rooté |
| ThreatState | État de menace signalé par un partenaire Mobile Threat Defense (pertinent uniquement lorsqu’un partenaire MTD est connecté) |
| PatchLevel | Niveau de correctif de sécurité Android (vide sur iOS/iPadOS) |
| EnrollmentType / EnrollmentProfile | Comment l’appareil a été inscrit et le profil d’inscription utilisé |
| Catégorie | Catégorie d’appareil Intune |
| FreeGB / TotalGB | Espace de stockage libre et total (vide lorsque l’appareil ne signale aucun inventaire de stockage exploitable, ce qui est courant pour les profils de travail Android Enterprise) |
| Inscrit | Date d’inscription |
#### Réseau et SIM (uniquement avec `IncludeNetworkDetails` activé - désactivé par défaut)
| Colonne | Source et signification |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| IPv4 / Subnet | Dernière adresse IP et dernier sous-réseau signalés par l’appareil - meilleur indicateur du réseau (Wi‑Fi) sur lequel l’appareil a été actif pour la dernière fois |
| WiFiMAC | Adresse MAC Wi‑Fi de l’appareil |
| ICCID | Numéro d’identification unique de la carte SIM |
| ESIM | Identifiant eSIM, lorsqu’une eSIM est provisionnée |
| Cellular | Technologie cellulaire de l’appareil |
| UDID | Identifiant unique de l’appareil (iOS/iPadOS) |
| BatteryHealth | Pourcentage de santé de la batterie, lorsqu’il est signalé |
| Partagé | Indique si l’appareil est un iPad partagé |
| LastSync | Horodatage de la dernière vérification Intune réussie - indique l’ancienneté des informations IP |
Ce tableau est trié par sous-réseau, de sorte que les appareils sont regroupés visuellement par réseau sur lequel ils ont été vus pour la dernière fois.
### Actualité et limites des données
Toutes les valeurs décrivent l’état de la dernière vérification Intune réussie de l’appareil, pas nécessairement l’état actuel - interprétez-les toujours avec la colonne LastSync. Intune ne signale pas le SSID Wi‑Fi d’un appareil ; la dernière adresse IP et le dernier sous-réseau sont l’indicateur réseau le plus proche. Notez que l’adresse IP signalée peut également provenir d’une connexion cellulaire lorsque l’appareil a effectué sa dernière vérification via des données mobiles. Intune masque partiellement le numéro de téléphone des appareils appartenant à des particuliers, quel que soit le `IncludePhoneNumber` paramètre.
### Considérations de performance
Les détails réseau/SIM sont désactivés par défaut et doivent être activés avec prudence sur les grands Tenant ou avec de nombreux appareils mobiles : Microsoft Graph ne renvoie ces valeurs que lors d’une requête sur un seul appareil, pas dans la réponse de la liste des appareils. Le runbook envoie toujours ces requêtes via le point de terminaison batch de Graph par lots de 20 au maximum, mais le temps d’exécution augmente toujours linéairement avec le nombre d’appareils - des milliers d’appareils mobiles impliquent des exécutions proportionnellement longues et un risque accru de limitation de débit par Graph (les requêtes limitées sont réessayées automatiquement avec le délai d’attente indiqué par Graph). Dans les grands environnements, combinez `IncludeNetworkDetails` avec les filtres de portée de groupe.
### Filtrage de portée
La portée peut être limitée aux membres d’un groupe d’appareils Entra ID (`IncludeDeviceGroup`) et/ou aux appareils dont l’utilisateur principal est membre d’un groupe d’utilisateurs (`IncludeUserGroup`). Lorsque les deux filtres sont définis, un appareil doit correspondre aux deux. Les appartenances transitives sont résolues, de sorte que les membres des groupes imbriqués sont inclus.
### Livraison du rapport
Les fichiers de rapport ne sont générés que lorsque l’ **Livraison du rapport** option inclut un e-mail ou un lien de téléchargement. Avec *Uniquement les données de sortie* sélectionné, les résultats sont lus directement dans l’onglet Output Data du portail RealmJoin, où chaque tableau peut également être exporté vers Excel. La livraison par e-mail et la génération du lien de téléchargement sont indépendantes et peuvent être combinées ; le *Format du fichier de rapport* utilise par défaut uniquement le classeur Excel.
* **E-mail**: envoie un e-mail récapitulatif avec l’inventaire complet joint au format CSV et/ou classeur Excel. Lorsque la pièce jointe CSV dépasse la limite de taille de l’e-mail et que *CSV et XLSX* est sélectionné, l’e-mail se rabat sur le seul classeur Excel. Lorsqu’aucun appareil mobile ne correspond, l’e-mail indique qu’aucun appareil n’a été trouvé et n’inclut aucune pièce jointe.
* **Lien de téléchargement**: envoie les fichiers de rapport vers le Storage Account Azure configuré dans les `RJReport.StorageAccount.*` paramètres du Tenant (conteneur `list-mobile-devices` par défaut) et affiche des liens de téléchargement SAS à durée limitée dans la sortie du travail. Convient lorsque l’inventaire est trop volumineux pour une pièce jointe par e-mail ou doit être remis directement à la gestion des actifs. Le téléversement vers le stockage s’authentifie avec l’identité managée du compte Automation ; cette identité nécessite le **Reader and Data Access** rôle RBAC sur le Storage Account cible (il s’agit d’une attribution Azure RBAC, pas d’une autorisation d’application Graph).
Les fichiers de rapport contiennent toutes les colonnes des tableaux ci-dessus, y compris le `DeviceId`. Le `PhoneNumber` et les colonnes réseau/SIM ne font partie des fichiers que lorsque les options correspondantes sont activées. Les appareils non conformes sont mis en évidence dans le classeur Excel. Aucun fichier n’est créé lorsqu’aucun appareil mobile ne correspond aux plateformes et filtres sélectionnés.
Les planifications créées avant l’ **Livraison du rapport** existence de l’option continuent d’envoyer leur e-mail : un destinataire enregistré suffit encore à activer l’e-mail pour eux. Lorsqu’une telle planification est ouverte en modification, l’option affiche *Uniquement les données de sortie*; sélectionnez à nouveau la livraison avant d’enregistrer, sinon la planification cesse d’envoyer le rapport.
### Configuration de l’envoi d’e-mails
L'envoi d'un rapport par e-mail est facultatif et ne se produit que lorsque le **Livraison du rapport** option inclut un e-mail ; un destinataire est alors requis. 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, max. 200 Ko 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 invalide, n’empêche jamais 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 → Lister les appareils mobiles
**Nom complet du runbook**
rjgit-org\_devices\_list-mobile-devices
### Détails
| Propriété | Valeur |
| -------------- | ------------------------------------------------------------------------------------------------------------------ |
| Version | 1.1.0 |
| Modules requis | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
Az.Accounts (>= 5.5.2)
|
| Planifiable | non |
### Autorisations
#### Autorisations d’application
* **Type**: Microsoft Graph
* DeviceManagementManagedDevices.Read.All
* *Liste les appareils mobiles gérés par Intune, y compris les détails matériels, SIM et réseau*
* Directory.Read.All *(facultatif — fonctionnalité : filtrage de la portée par groupe)*
* *Lit les membres des groupes pour résoudre les filtres de portée optionnels des groupes d’appareils/utilisateurs*
* Mail.Send *(facultatif — fonctionnalité : rapport par e-mail)*
* *Envoie l’e-mail du rapport via Send-RjRbReportEmail lorsque la livraison par e-mail est sélectionnée*
* Organization.Read.All *(facultatif — fonctionnalité : rapport par e-mail)*
* *Lit /organization pour le nom du tenant utilisé dans les noms de fichiers du rapport, l’objet de l’e-mail et le pied de page de l’e-mail ; sans cela, le runbook revient à 'Unknown Tenant'*
#### Notes sur les autorisations
Azure Storage Account: rôle 'Reader and Data Access' pour l’identité managée du compte Automation sur le Storage Account cible - le téléversement récupère les clés du compte via listKeys (requis uniquement pour les options de lien de téléchargement)
### Paramètres
#### Android
Inclut les appareils Android.
| Propriété | Valeur |
| -------------------------- | ------------------------------- |
| Obligatoire | faux |
| Valeur par défaut | Vrai |
| Type | Booléen |
| Nom d’affichage du portail | Inclure les appareils Android ? |
#### iOS
Inclut les appareils iOS et iPadOS.
| Propriété | Valeur |
| -------------------------- | ---------------------------------- |
| Obligatoire | faux |
| Valeur par défaut | Vrai |
| Type | Booléen |
| Nom d’affichage du portail | Inclure les appareils iOS/iPadOS ? |
#### IncludeNetworkDetails
Ajoute l’adresse IP, le sous-réseau, l’ICCID, l’identifiant eSIM, la technologie cellulaire, l’UDID, l’état de santé de la batterie et l’état d’iPad partagé. Nécessite une requête supplémentaire par appareil, donc les grands Tenant prennent plus de temps.
| Propriété | Valeur |
| -------------------------- | ----------------------------------- |
| Obligatoire | faux |
| Valeur par défaut | Faux |
| Type | Booléen |
| Nom d’affichage du portail | Inclure les détails réseau et SIM ? |
#### IncludePhoneNumber
Affiche la colonne du numéro de téléphone. Intune masque de toute façon une partie du numéro sur les appareils appartenant à des particuliers.
| Propriété | Valeur |
| -------------------------- | ---------------------------------- |
| Obligatoire | faux |
| Valeur par défaut | Vrai |
| Type | Booléen |
| Nom d’affichage du portail | Inclure les numéros de téléphone ? |
#### IncludeDeviceGroup
Uniquement les appareils de ce groupe Entra ID, y compris les groupes imbriqués. Laisser vide pour tous les appareils mobiles.
| Propriété | Valeur |
| -------------------------- | ------------------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne |
| Nom d’affichage du portail | Limiter aux appareils du groupe |
#### IncludeUserGroup
Uniquement les appareils dont l’utilisateur principal appartient à ce groupe, y compris les groupes imbriqués. Laisser vide pour tous.
| Propriété | Valeur |
| -------------------------- | --------------------------------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne |
| Nom d’affichage du portail | Limiter aux utilisateurs principaux du groupe |
#### 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 | XLSX uniquement |
| 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 |
#### 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 |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |
#### 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 | list-mobile-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) |
#### SendEmailReport
Envoyer le rapport à l’adresse e-mail du destinataire.
| 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) |
#### EmailTo
Envoyez le rapport à ces adresses. Séparez-en plusieurs par des virgules ; chaque destinataire reçoit un e-mail distinct.
| 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) |
[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/list-mobile-devices.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.