> 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/es/automatizacion/runbooks/runbook-references/org/devices/list-mobile-devices.md).
# Enumerar dispositivos móviles
Enumerar dispositivos móviles administrados con detalles de inventario y red
### Descripción
Enumera todos los dispositivos Android, iOS e iPadOS administrados por Intune con su inventario: IMEI, número de serie, número de teléfono, operador, propiedad, cumplimiento e inscripción. Opcionalmente se añaden la última dirección IP y subred informadas, ICCID, identificador de eSIM, tecnología celular, UDID, estado de la batería y estado de iPad compartido. Eso muestra en qué redes estuvieron activos por última vez los dispositivos. La lista puede limitarse por plataforma, un grupo de dispositivos o un grupo de los usuarios principales. El informe puede enviarse por correo electrónico o proporcionarse como un enlace de descarga.
### Casos de uso comunes
* Inventario de todos los dispositivos móviles, incluidos IMEI, número de serie, número de teléfono y operador
* Identificar en qué redes (Wi‑Fi) estuvieron activos por última vez los dispositivos móviles, por ejemplo escáneres portátiles en distintas ubicaciones de almacén
* Revisar el estado de cumplimiento, supervisión y cifrado de la flota móvil
* Inventario de SIM/eSIM a través de ICCID y el identificador de eSIM
* Entregar el inventario móvil completo a gestión de activos como libro de Excel o archivo CSV
### Columnas de salida
Cada ejecución escribe una **Resumen** tabla (conteos de dispositivos por plataforma, dispositivos no conformes y de propiedad personal y, con los detalles de red habilitados, el número de dispositivos sin una dirección IP informada) y hasta tres tablas de dispositivos en la pestaña Datos de salida del portal RealmJoin. La salida de la consola muestra los mismos conteos, además del desglose por estado de cumplimiento y propiedad, y los filtros aplicados. Los mismos datos también pueden entregarse como archivos de informe por correo electrónico y/o como un enlace de descarga; consulte la sección sobre entrega de informes más abajo.
#### Inventario (siempre mostrado)
| Columna | Origen y significado |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Nombre del dispositivo | Nombre del dispositivo según lo informado por Intune |
| Usuario principal | Nombre principal de usuario del usuario principal |
| Sistema operativo / versión del SO | Sistema operativo (Android, iOS, iPadOS) y versión |
| Fabricante / modelo | Fabricante y modelo del hardware |
| SerialNumber | Número de serie del hardware |
| IMEI | Identidad internacional de equipo móvil del dispositivo |
| Número de teléfono | Número de teléfono de la SIM - solo presente cuando `IncludePhoneNumber` está habilitado; en caso contrario, la columna se omite por completo |
| Operador | Operador del suscriptor de la SIM |
| Propiedad | `empresa` o `personal` |
| Cumplimiento | estado de cumplimiento de Intune |
| Última sincronización | Marca de tiempo del último check-in correcto de Intune |
#### Seguridad e inscripción (siempre mostrado)
| Columna | Origen y significado |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Supervisado | modo supervisado de iOS/iPadOS |
| Cifrado | Estado de cifrado del dispositivo |
| Con jailbreak | Indica si el dispositivo tiene jailbreak o root |
| Estado de amenaza | Estado de amenaza informado por un socio de defensa frente a amenazas móviles (solo tiene sentido cuando hay conectado un socio MTD) |
| Nivel de parche | Nivel de parche de seguridad de Android (vacío en iOS/iPadOS) |
| Tipo de inscripción / Perfil de inscripción | Cómo se inscribió el dispositivo y el perfil de inscripción utilizado |
| Categoría | categoría de dispositivo de Intune |
| GB libres / GB totales | Almacenamiento libre y total (vacío cuando el dispositivo no informa de un inventario de almacenamiento utilizable, algo común en perfiles de trabajo de Android Enterprise) |
| Inscrito | Fecha de inscripción |
#### Red y SIM (solo con `IncludeNetworkDetails` habilitado: desactivado de forma predeterminada)
| Columna | Origen y significado |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| IPv4 / subred | La última dirección IP y subred notificadas por el dispositivo: el indicador más cercano de la red (Wi‑Fi) en la que el dispositivo estuvo activo por última vez |
| MAC de Wi‑Fi | Dirección MAC Wi‑Fi del dispositivo |
| ICCID | Número de identificación único de la tarjeta SIM |
| eSIM | identificador de eSIM, cuando se aprovisiona una eSIM |
| Celular | Tecnología celular del dispositivo |
| UDID | Identificador único del dispositivo (iOS/iPadOS) |
| Estado de la batería | Porcentaje de estado de la batería, cuando se informa |
| Compartido | Indica si el dispositivo es un iPad compartido |
| Última sincronización | Marca de tiempo del último check-in correcto de Intune: indica cuán antigua es la información de IP |
Esta tabla está ordenada por subred, de modo que los dispositivos se agrupan visualmente por la red en la que se vieron por última vez.
### Actualidad y limitaciones de los datos
Todos los valores describen el estado del último check-in correcto del dispositivo con Intune, no necesariamente el estado actual; interprételos siempre junto con la columna LastSync. Intune no informa del SSID Wi‑Fi de un dispositivo; la última dirección IP y subred son el indicador de red más cercano. Tenga en cuenta que la dirección IP informada también puede proceder de una conexión celular cuando el dispositivo se conectó por última vez a través de datos móviles. Intune oculta parcialmente el número de teléfono de los dispositivos de propiedad personal independientemente de la `IncludePhoneNumber` configuración.
### Consideraciones de rendimiento
Los detalles de red/SIM están desactivados de forma predeterminada y deben habilitarse con cuidado en tenants grandes o con muchos dispositivos móviles: Microsoft Graph devuelve estos valores solo en una solicitud de un único dispositivo, no en la respuesta de la lista de dispositivos. El runbook siempre envía estas solicitudes a través del endpoint por lotes de Graph en fragmentos de hasta 20, pero el tiempo de ejecución sigue creciendo linealmente con el número de dispositivos: miles de dispositivos móviles implican ejecuciones correspondientemente largas y un mayor riesgo de limitación de Graph (las solicitudes limitadas se reintentan automáticamente con el tiempo de espera informado por Graph). En entornos grandes, combine `IncludeNetworkDetails` con los filtros de ámbito de grupo.
### Filtrado por ámbito
El ámbito puede limitarse a los miembros de un grupo de dispositivos de Entra ID (`IncludeDeviceGroup`) y/o a dispositivos cuyo usuario principal sea miembro de un grupo de usuarios (`IncludeUserGroup`). Cuando ambos filtros están establecidos, un dispositivo debe coincidir con ambos. Las pertenencias transitivas se resuelven, por lo que se incluyen los miembros de grupos anidados.
### Entrega del informe
Los archivos de informe solo se generan cuando la **Entrega del informe** opción incluye un correo electrónico o un enlace de descarga. Cuando *Solo datos de salida* está seleccionado, los resultados se leen directamente en la pestaña Datos de salida del portal RealmJoin, donde cada tabla también puede exportarse a Excel. La entrega por correo electrónico y la generación de enlaces de descarga son independientes y pueden combinarse; *Formato del archivo del informe* el valor predeterminado es solo el libro de Excel.
* **Correo electrónico**: envía un correo electrónico de resumen con el inventario completo adjunto como CSV y/o libro de Excel. Cuando el adjunto CSV supera el límite de tamaño del correo electrónico y *CSV y XLSX* se selecciona, el correo electrónico recurre solo al libro de Excel. Cuando ningún dispositivo móvil coincide, el correo electrónico indica que no se encontró ningún dispositivo y no lleva adjuntos.
* **Enlace de descarga**: carga los archivos de informe en la cuenta de Storage Account de Azure configurada en la `RJReport.StorageAccount.*` configuración del Tenant (contenedor `list-mobile-devices` de forma predeterminada) e imprime enlaces de descarga SAS con tiempo limitado en la salida del trabajo. Adecuado cuando el inventario es demasiado grande para un adjunto de correo electrónico o debe entregarse directamente a la gestión de activos. La carga al almacenamiento se autentica con la identidad administrada de la cuenta de Automation; esa identidad necesita el **Reader and Data Access** rol RBAC en la Storage Account de destino (esto es una asignación de RBAC de Azure, no un permiso de aplicación de Graph).
Los archivos de informe contienen todas las columnas de las tablas anteriores, incluida la `DeviceId`. `Número de teléfono` y las columnas de red/SIM solo forman parte de los archivos cuando se habilitan las opciones correspondientes. Los dispositivos no conformes se resaltan en el libro de Excel. No se crean archivos cuando ningún dispositivo móvil coincide con las plataformas y filtros seleccionados.
Las programaciones que se crearon antes de que la **Entrega del informe** opción existiera siguen enviando su correo electrónico: con un destinatario almacenado solo, el correo electrónico sigue estando habilitado para ellos. Cuando se abre una programación de ese tipo para editarla, la opción muestra *Solo datos de salida*; seleccione de nuevo la entrega antes de guardar; de lo contrario, la programación deja de enviar el informe.
### Configuración relacionada con el envío de correo electrónico
Enviar un informe por correo electrónico es opcional y solo ocurre cuando la **Entrega del informe** la opción incluye un correo electrónico; entonces se requiere un destinatario. La dirección del remitente se toma de la `RJReport.EmailSender` configuración del Tenant.
Este runbook envía correos electrónicos usando la API de Microsoft Graph. Para enviar correos electrónicos a través de la API de Graph, debe configurar una dirección de correo electrónico existente en la personalización del runbook.
Consulte la [documentación de configuración de informes de RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obtener detalles sobre todas las configuraciones disponibles.
#### Marca del correo electrónico
El correo electrónico del informe tiene en cuenta la opción opcional `RJReport.Branding.*` del Tenant:
* **Imagen de encabezado y pie de página** - URL HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada una
* **Enlace del pie de página** - destino de la imagen del pie de página
* **Color de acento y de texto** - valores hexadecimales de 6 dígitos, p. ej. `#0052cc`
Cuando estos ajustes no están configurados, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen que no puede descargarse o validarse, o un valor de color no válido, nunca impide el correo electrónico del informe; en su lugar se usa el valor predeterminado correspondiente.
Instrucciones de configuración y requisitos de imagen: [Marca del correo electrónico](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).
### Ubicación
Organización → Dispositivos → Listar dispositivos móviles
**Nombre completo del runbook**
rjgit-org\_devices\_list-mobile-devices
### Detalles
| Propiedad | Valor |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
| Versión | 1.1.0 |
| Módulos requeridos | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
Az.Accounts (>= 5.5.2)
|
| Programable | no |
### Permisos
#### Permisos de aplicación
* **Tipo**: Microsoft Graph
* DeviceManagementManagedDevices.Read.All
* *Enumera los dispositivos móviles administrados por Intune, incluidos los detalles de hardware, SIM y red*
* Directory.Read.All *(opcional — función: filtrado por alcance de grupo)*
* *Lee los miembros de grupos para resolver los filtros opcionales de ámbito de grupo de dispositivos/usuarios*
* Mail.Send *(opcional — característica: informe por correo electrónico)*
* *Envía el correo electrónico del informe mediante Send-RjRbReportEmail cuando se selecciona la entrega por correo electrónico*
* Organization.Read.All *(opcional — característica: informe por correo electrónico)*
* *Lee /organization para obtener el nombre del Tenant usado en los nombres de archivo del informe, el asunto del correo electrónico y el pie de página del correo electrónico; sin ello, el runbook recurre a 'Tenant desconocido'*
#### Notas sobre permisos
Azure Storage Account: rol 'Reader and Data Access' para la identidad administrada de la Automation Account en la Storage Account de destino - la carga recupera las claves de la cuenta mediante listKeys (solo necesario para las opciones de enlace de descarga)
### Parámetros
#### Android
Incluye dispositivos Android.
| Propiedad | Valor |
| ------------------------------ | ------------------------------ |
| Requerido | falso |
| Valor predeterminado | Verdadero |
| Tipo | Booleano |
| Nombre para mostrar del portal | ¿Incluir dispositivos Android? |
#### iOS
Incluye dispositivos iOS y iPadOS.
| Propiedad | Valor |
| ------------------------------ | --------------------------------- |
| Requerido | falso |
| Valor predeterminado | Verdadero |
| Tipo | Booleano |
| Nombre para mostrar del portal | ¿Incluir dispositivos iOS/iPadOS? |
#### IncludeNetworkDetails
Añade la dirección IP, subred, ICCID, identificador de eSIM, tecnología celular, UDID, estado de la batería y estado de iPad compartido. Necesita una solicitud adicional por dispositivo, por lo que los tenants grandes tardan más.
| Propiedad | Valor |
| ------------------------------ | ------------------------------- |
| Requerido | falso |
| Valor predeterminado | Falso |
| Tipo | Booleano |
| Nombre para mostrar del portal | ¿Incluir detalles de red y SIM? |
#### IncludePhoneNumber
Muestra la columna del número de teléfono. De todos modos, Intune oculta parte del número en los dispositivos de propiedad personal.
| Propiedad | Valor |
| ------------------------------ | ----------------------------- |
| Requerido | falso |
| Valor predeterminado | Verdadero |
| Tipo | Booleano |
| Nombre para mostrar del portal | ¿Incluir números de teléfono? |
#### IncludeDeviceGroup
Solo dispositivos de este grupo de Entra ID, incluidos los grupos anidados. Déjelo vacío para todos los dispositivos móviles.
| Propiedad | Valor |
| ------------------------------ | ------------------------------------ |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar del portal | Limitar a los dispositivos del grupo |
#### IncludeUserGroup
Solo dispositivos cuyo usuario principal está en este grupo, incluidos los grupos anidados. Déjelo vacío para todos.
| Propiedad | Valor |
| ------------------------------ | ------------------------------------------ |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar del portal | Limitar a usuarios principales en el grupo |
#### EmailFrom
Dirección del remitente del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.EmailSender.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### BrandingHeaderImageUrl
Imagen de encabezado del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Se toma de la configuración del Tenant RJReport.Branding.HeaderImageUrl; se usa el encabezado predeterminado de RealmJoin cuando está vacío.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### BrandingFooterImageUrl
Imagen de pie de página del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Se toma de la configuración del Tenant RJReport.Branding.FooterImageUrl; se usa el pie de página predeterminado de RealmJoin cuando está vacío.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### BrandingFooterLink
Enlace asociado a la imagen de pie de página del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.Branding.FooterLink; realmjoin.com se usa cuando está vacío.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### BrandingAccentColor
Color de acento del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.AccentColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### BrandingTextColor
Color de texto del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.TextColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### ReportFileFormat
Entrega el informe como CSV, como un libro de Excel o ambos.
| Propiedad | Valor |
| ------------------------------ | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | Solo XLSX |
| Tipo | Cadena |
| Nombre para mostrar del portal | Formato del archivo del informe |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
**Opciones del portal**
| Opción del portal | Valor |
| ----------------- | ---------- |
| CSV y XLSX | CSV y XLSX |
| Solo CSV | Solo CSV |
| Solo XLSX | Solo XLSX |
#### CreateDownloadLink
También carga el informe y devuelve un enlace de descarga que expira después de unos días.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | Falso |
| Tipo | Booleano |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### ContainerName
Contenedor de almacenamiento al que se cargan los archivos del informe. Se configura por runbook.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | list-mobile-devices |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### ResourceGroupName
Grupo de recursos de la Storage Account para las cargas del informe. Obtenido de la configuración del Tenant RJReport.StorageAccount.ResourceGroup.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### StorageAccountName
Storage Account para las cargas del informe. Obtenido de la configuración del Tenant RJReport.StorageAccount.StorageAccountName.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### LinkExpiryDays
Número de días que un enlace de descarga permanece válido. Obtenido de la configuración del Tenant RJReport.StorageAccount.LinkExpiryDays.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | 6 |
| Tipo | Int32 |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### SendEmailReport
Enviar el informe a la dirección de correo electrónico del destinatario.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | Falso |
| Tipo | Booleano |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### EmailTo
Envía el informe a estas direcciones. Separe varias con comas; cada destinatario recibe un correo electrónico independiente.
| Propiedad | Valor |
| ------------------------------ | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar del portal | Dirección(es) de correo electrónico del destinatario |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
[Volver a la vista general de referencia del runbook](/es/automatizacion/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/es/automatizacion/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.