> 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 agregan la última dirección IP y subred informadas, ICCID, identificador eSIM, tecnología celular, UDID, estado de la batería y estado de Shared iPad. 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 vínculo 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 manuales en distintas ubicaciones del almacén
* Revisar el estado de cumplimiento, supervisión y cifrado de la flota móvil
* Inventario de SIM/eSIM mediante ICCID e identificador eSIM
* Entregar el inventario móvil completo a la gestión de activos como un libro de Excel o un archivo CSV

### Columnas de salida

Cada ejecución escribe un **Resumen** tabla (conteo 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 Output Data del portal de RealmJoin. La salida de la consola muestra los mismos conteos más el 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 vínculo de descarga; consulte la sección sobre entrega de informes más abajo.

#### Inventario (siempre mostrado)

| Columna                     | Fuente y significado                                                                                                                        |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Nombre del dispositivo      | Nombre del dispositivo según lo informado por Intune                                                                                        |
| PrimaryUser                 | Nombre principal de usuario del usuario principal                                                                                           |
| OperatingSystem / OSVersion | Sistema operativo (Android, iOS, iPadOS) y versión                                                                                          |
| Manufacturer / Model        | Fabricante de hardware y modelo                                                                                                             |
| SerialNumber                | Número de serie del hardware                                                                                                                |
| IMEI                        | Identidad internacional de equipo móvil del dispositivo                                                                                     |
| PhoneNumber                 | Número de teléfono de la SIM - solo presente cuando `IncludePhoneNumber` está habilitado; de lo contrario, la columna se omite por completo |
| Operador                    | Operador de suscriptor de la SIM                                                                                                            |
| Propiedad                   | `empresa` o `personal`                                                                                                                      |
| Cumplimiento                | Estado de cumplimiento de Intune                                                                                                            |
| LastSync                    | Marca de tiempo del último inicio de sesión correcto en Intune                                                                              |

#### Seguridad e inscripción (siempre mostrado)

| Columna                            | Fuente y significado                                                                                                                                                      |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Supervised                         | modo supervisado de iOS/iPadOS                                                                                                                                            |
| Encrypted                          | Estado de cifrado del dispositivo                                                                                                                                         |
| Jailbroken                         | Si el dispositivo tiene jailbreak o está rooteado                                                                                                                         |
| ThreatState                        | Estado de amenaza informado por un socio de Mobile Threat Defense (solo tiene sentido cuando hay conectado un socio MTD)                                                  |
| PatchLevel                         | Nivel de parche de seguridad de Android (vacío en iOS/iPadOS)                                                                                                             |
| EnrollmentType / EnrollmentProfile | Cómo se inscribió el dispositivo y el perfil de inscripción utilizado                                                                                                     |
| Categoría                          | Categoría de dispositivo de Intune                                                                                                                                        |
| FreeGB / TotalGB                   | Almacenamiento libre y total (vacío cuando el dispositivo no informa un inventario de almacenamiento utilizable, algo común en perfiles de trabajo de Android Enterprise) |
| Enrolled                           | Fecha de inscripción                                                                                                                                                      |

#### Red y SIM (solo con `IncludeNetworkDetails` habilitado - desactivado de forma predeterminada)

| Columna       | Fuente y significado                                                                                                                                         |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| IPv4 / Subnet | Última dirección IP y subred informadas por el dispositivo: el indicador más cercano de la red (Wi‑Fi) en la que el dispositivo estuvo activo por última vez |
| WiFiMAC       | Dirección MAC Wi‑Fi del dispositivo                                                                                                                          |
| ICCID         | Número de identificación único de la tarjeta SIM                                                                                                             |
| ESIM          | Identificador eSIM, cuando se aprovisiona una eSIM                                                                                                           |
| Cellular      | Tecnología celular del dispositivo                                                                                                                           |
| UDID          | Identificador único del dispositivo (iOS/iPadOS)                                                                                                             |
| BatteryHealth | Porcentaje de estado de la batería, cuando se informa                                                                                                        |
| Shared        | Si el dispositivo es un iPad compartido                                                                                                                      |
| LastSync      | Marca de tiempo del último inicio de sesión correcto en Intune: indica cuán antigua es la información de IP                                                  |

Esta tabla está ordenada por subred, por lo 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 inicio de sesión correcto del dispositivo en 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 provenir de una conexión celular cuando el dispositivo se registró por última vez mediante datos móviles. Intune enmascara 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 deshabilitados de forma predeterminada y deben habilitarse con cuidado en Tenant 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 extremo por lotes de Graph en fragmentos de hasta 20, pero el tiempo de ejecución sigue creciendo de forma lineal 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 de á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. Se resuelven las pertenencias transitivas, 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 vínculo de descarga. Con *solo Datos de salida* seleccionada, los resultados se leen directamente en la pestaña Output Data del portal de RealmJoin, donde cada tabla también puede exportarse a Excel. La entrega por correo electrónico y la generación del vínculo de descarga son independientes y pueden combinarse; la *Formato del archivo del informe* usa de forma predeterminada 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 archivo adjunto CSV supera el límite de tamaño del correo electrónico y *CSV y XLSX* está seleccionado, el correo electrónico recurre solo al libro de Excel. Cuando no coincide ningún dispositivo móvil, el correo electrónico indica que no se encontró ningún dispositivo y no lleva ningún archivo adjunto.
* **Enlace de descarga**: carga el/los archivo(s) de informe en la Storage Account de Azure configurada en la `RJReport.StorageAccount.*` configuración del Tenant (contenedor `list-mobile-devices` de forma predeterminada) e imprime vínculos de descarga SAS con tiempo limitado en la salida del trabajo. Adecuado cuando el inventario es demasiado grande para un archivo 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 la **Reader and Data Access** rol RBAC en la Storage Account de destino (esta es una asignación de Azure RBAC, no un permiso de aplicación de Graph).

Los archivos de informe contienen todas las columnas de las tablas anteriores, incluidas las `DeviceId`. El `PhoneNumber` y las columnas de red/SIM solo forman parte de los archivos cuando las opciones correspondientes están habilitadas. 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 la **Entrega del informe** existiera la opción siguen enviando su correo electrónico: un destinatario almacenado por sí solo sigue habilitando el correo electrónico para ellos. Cuando se abre una programación de este tipo para editarla, la opción muestra *solo Datos de salida*; vuelva a seleccionar la entrega antes de guardar; de lo contrario, la programación deja de enviar el informe.

### Configuración relativa al envío de correos electrónicos

El envío de un informe por correo electrónico es opcional y solo ocurre cuando la **Entrega del informe** opción incluye un correo electrónico; entonces se requiere un destinatario. La dirección del remitente se toma de la `RJReport.EmailSender` de Tenant.

Este runbook envía correos electrónicos mediante la API de Microsoft Graph. Para enviar correos mediante Graph API, debes configurar una dirección de correo electrónico existente en la personalización del runbook.

Consulta la [documentación de configuración de informes de RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para conocer todos los ajustes disponibles.

#### Marca del correo electrónico

El correo electrónico del informe respeta las `RJReport.Branding.*` configuraciones opcionales de Tenant:

* **Imagen de cabecera 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 estas configuraciones no están definidas, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen que no se puede descargar o validar, 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

Organization → Devices → List Mobile Devices

**Nombre completo del runbook**

rjgit-org\_devices\_list-mobile-devices

### Detalles

| Propiedad          | Valor                                                                                                              |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
| Versión            | 1.2.0                                                                                                              |
| Módulos requeridos | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| 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 — característica: filtrado por ámbito de grupo)*
    * *Lee los miembros del grupo 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 él, el runbook recurre a 'Unknown Tenant'*

#### Notas sobre permisos

Azure Storage Account: rol 'Reader and Data Access' para la identidad administrada de la cuenta de Automation 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                          |
| -------------------------------- | ------------------------------ |
| Obligatorio                      | falso                          |
| Valor predeterminado             | Verdadero                      |
| Tipo                             | Booleano                       |
| Nombre para mostrar en el portal | ¿Incluir dispositivos Android? |

#### iOS

Incluye dispositivos iOS e iPadOS.

| Propiedad                        | Valor                             |
| -------------------------------- | --------------------------------- |
| Obligatorio                      | falso                             |
| Valor predeterminado             | Verdadero                         |
| Tipo                             | Booleano                          |
| Nombre para mostrar en el portal | ¿Incluir dispositivos iOS/iPadOS? |

#### IncludeNetworkDetails

Agrega la dirección IP, la subred, ICCID, identificador eSIM, tecnología celular, UDID, estado de la batería y estado de Shared iPad. Requiere una solicitud adicional por dispositivo, por lo que los Tenant grandes tardan más.

| Propiedad                        | Valor                           |
| -------------------------------- | ------------------------------- |
| Obligatorio                      | falso                           |
| Valor predeterminado             | Falso                           |
| Tipo                             | Booleano                        |
| Nombre para mostrar en el portal | ¿Incluir detalles de red y SIM? |

#### IncludePhoneNumber

Muestra la columna del número de teléfono. Intune, de todos modos, enmascara parte del número en los dispositivos de propiedad personal.

| Propiedad                        | Valor                         |
| -------------------------------- | ----------------------------- |
| Obligatorio                      | falso                         |
| Valor predeterminado             | Verdadero                     |
| Tipo                             | Booleano                      |
| Nombre para mostrar en el portal | ¿Incluir números de teléfono? |

#### IncludeDeviceGroup

Solo dispositivos en este grupo de Entra ID, incluidos los grupos anidados. Déjelo vacío para todos los dispositivos móviles.

| Propiedad                        | Valor                                |
| -------------------------------- | ------------------------------------ |
| Obligatorio                      | falso                                |
| Valor predeterminado             |                                      |
| Tipo                             | Cadena                               |
| Nombre para mostrar en el 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                                        |
| -------------------------------- | -------------------------------------------- |
| Obligatorio                      | falso                                        |
| Valor predeterminado             |                                              |
| Tipo                             | Cadena                                       |
| Nombre para mostrar en el portal | Limitar a los usuarios principales del grupo |

#### EmailFrom

Dirección del remitente del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.EmailSender.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### BrandingHeaderImageUrl

Imagen de cabecera 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 la cabecera predeterminada de RealmJoin cuando está vacía.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### BrandingFooterImageUrl

Imagen del 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ía.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### BrandingFooterLink

Enlace detrás de la imagen del pie de página del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.Branding.FooterLink; se usa realmjoin.com cuando está vacía.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido 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                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### BrandingTextColor

Color del 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                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### ReportFileFormat

Entrega el informe como CSV, como un libro de Excel o ambos.

| Propiedad                        | Valor                                                       |
| -------------------------------- | ----------------------------------------------------------- |
| Obligatorio                      | falso                                                       |
| Valor predeterminado             | Solo XLSX                                                   |
| Tipo                             | Cadena                                                      |
| Nombre para mostrar en el portal | Formato del archivo del informe                             |
| Oculto en el portal              | sí (preestablecido 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 sube el informe y devuelve un enlace de descarga que expira después de unos días.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado | Falso                                                       |
| Tipo                 | Booleano                                                    |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### ContainerName

Contenedor de almacenamiento al que se suben los archivos del informe. Se establece por runbook.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado | list-mobile-devices                                         |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### ResourceGroupName

Grupo de recursos de la cuenta de almacenamiento para las cargas del informe. Se toma de la configuración del Tenant RJReport.StorageAccount.ResourceGroup.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### StorageAccountName

Cuenta de almacenamiento para las cargas del informe. Se toma de la configuración del Tenant RJReport.StorageAccount.StorageAccountName.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### SubscriptionId

ID de suscripción de la cuenta de almacenamiento para las cargas del informe. Se toma de la configuración del Tenant RJReport.StorageAccount.SubscriptionId; cuando está vacío, se usa la suscripción en la que inicia sesión la identidad administrada.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### LinkExpiryDays

Número de días que un enlace de descarga permanece válido. Se toma de la configuración del Tenant RJReport.StorageAccount.LinkExpiryDays.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado | 6                                                           |
| Tipo                 | Int32                                                       |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### SendEmailReport

Envía el informe a la dirección de correo electrónico del destinatario.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado | Falso                                                       |
| Tipo                 | Booleano                                                    |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### EmailTo

Envía el informe a estas direcciones. Separa varias con comas; cada destinatario recibe un correo electrónico independiente.

| Propiedad                        | Valor                                                       |
| -------------------------------- | ----------------------------------------------------------- |
| Obligatorio                      | falso                                                       |
| Valor predeterminado             |                                                             |
| Tipo                             | Cadena                                                      |
| Nombre para mostrar en el portal | Dirección(es) de correo electrónico del destinatario        |
| Oculto en el portal              | sí (preestablecido mediante la personalización del runbook) |

[Volver al resumen de referencia de Runbook](https://docs.realmjoin.com/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=<question>&goal=<user_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.
