> 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). # Listar dispositivos móviles Enumera todos los dispositivos móviles administrados (Android, iOS/iPadOS) con detalles de inventario, seguridad y red específicos de dispositivos móviles. ### Descripción El runbook enumera todos los dispositivos móviles administrados por Intune con su inventario específico para móviles, como IMEI, número de serie, número de teléfono, operador, propiedad, cumplimiento y detalles de inscripción. Opcionalmente, por dispositivo se agregan la última dirección IP y subred informadas, ICCID, identificador de eSIM, tecnología celular, UDID, salud de la batería y estado de iPad compartido, lo que ayuda a ver en qué redes (Wi‑Fi) estuvieron activos por última vez los dispositivos. El resultado puede acotarse por plataforma y por un grupo de dispositivos de Entra y/o por un grupo de usuarios al que pertenezcan los usuarios principales. Opcionalmente, el inventario completo se envía como informe por correo electrónico con adjuntos CSV y/o Excel (xlsx) y/o se carga en un Azure Storage Account, devolviendo enlaces de descarga con tiempo limitado. Sin destinatario y sin la opción de enlace de descarga, el runbook solo imprime el resultado en la salida del trabajo. El parámetro ReportFileFormat controla qué formatos de archivo se generan y entregan (solo CSV, CSV y XLSX, o solo XLSX). Cuando el adjunto CSV supera el límite de tamaño del correo electrónico y se selecciona "CSV y XLSX", el correo electrónico recurre solo al libro de Excel. ### Columnas de salida El runbook imprime un bloque de resumen (recuentos de dispositivos por plataforma, estado de cumplimiento y propiedad, filtros aplicados y, con los detalles de red habilitados, el número de dispositivos sin una dirección IP informada) seguido de hasta tres tablas. Los mismos datos pueden entregarse opcionalmente como un informe por correo electrónico y/o como un enlace de descarga; consulte [Entrega del informe](#report-delivery). #### Inventario (siempre mostrado) | Columna | Fuente y significado | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | DeviceName | Nombre del dispositivo tal como lo informa Intune | | Usuario | Nombre principal de usuario del usuario principal | | OS / 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 está presente cuando `IncludePhoneNumber` está habilitado; de lo contrario, la columna se omite por completo | | Carrier | Operador de la suscripción de la SIM | | Ownership | `empresa` o `personal` | | Compliance | Estado de cumplimiento de Intune | | LastSync | Marca temporal de la última comprobación exitosa de Intune | #### Seguridad e inscripción (siempre mostrada) | Columna | Fuente y significado | | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Supervisado | Modo supervisado de iOS/iPadOS | | Encrypted | Estado de cifrado del dispositivo | | Con jailbreak | Si el dispositivo tiene jailbreak o acceso root | | ThreatState | Estado de amenaza informado por un socio de Mobile Threat Defense (solo tiene sentido cuando hay un socio MTD conectado) | | PatchLevel | Nivel del 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) | | Inscrito | Fecha de inscripción | #### Red y SIM (solo con `IncludeNetworkDetails` habilitado; desactivado de forma predeterminada) | Columna | Fuente y significado | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | IPv4 / Subred | Ú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 de eSIM, cuando se aprovisiona una eSIM | | Celular | Tecnología celular del dispositivo | | UDID | Identificador único del dispositivo (iOS/iPadOS) | | BatteryHealth | Porcentaje de salud de la batería, cuando se informa | | Compartido | Si el dispositivo es un iPad compartido | | LastSync | Marca temporal de la última comprobación exitosa 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 de los datos y limitaciones Todos los valores describen el estado de la última comprobación exitosa 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 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` de la configuración. ### Consideraciones de rendimiento Los detalles de red/SIM están deshabilitados 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 solo dispositivo, no en la respuesta de la lista de dispositivos. El runbook siempre envía estas solicitudes a través del endpoint batch de Graph en lotes 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 (`IncludeDeviceGroup`) y/o a dispositivos cuyo usuario principal sea miembro de un grupo de usuarios (`IncludeUserGroup`). Cuando ambos filtros están configurados, un dispositivo debe cumplir ambos. Se resuelven las pertenencias transitivas, por lo que se incluyen los miembros de grupos anidados. ### Entrega del informe De forma predeterminada, el runbook solo imprime las tablas en la salida del trabajo. Hay dos canales de entrega opcionales disponibles y pueden combinarse: * **Informe por correo electrónico** (`EmailTo`): envía un correo electrónico de resumen con el inventario completo adjunto como CSV y/o libro de trabajo de Excel (`ReportFileFormat`, predeterminado `solo XLSX`). Requiere el `RJReport.EmailSender` ajuste; la identidad visual del correo electrónico se toma de los `RJReport.Branding.*` ajustes, como en los otros runbooks de informes. Cuando el adjunto CSV supera el límite de tamaño del correo electrónico y `CSV & XLSX` se selecciona, el correo electrónico recurre solo al libro de trabajo de Excel. * **Enlace de descarga** (`CreateDownloadLink`): carga los archivos del informe en la cuenta de almacenamiento configurada en los `RJReport.StorageAccount.*` ajustes (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 o debe entregarse directamente a gestión de activos. Los archivos del informe contienen todas las columnas de las tablas anteriores, incluida la `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 trabajo de Excel. No se crean archivos cuando ningún dispositivo móvil coincide con las plataformas y filtros seleccionados. ### 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.0.0 | | Módulos requeridos | RealmJoin.RunbookHelper (>= 0.8.9)\nMicrosoft.Graph.Authentication (>= 2.39.0)\nAz.Accounts (>= 5.5.2) | | Programable | no | ### Notas Intune no informa del SSID Wi‑Fi de un dispositivo. La última dirección IP y subred informadas son el indicador de red más cercano y siempre deben interpretarse junto con la columna Last Sync, porque describen el estado de la última comprobación exitosa del dispositivo, que también puede haberse producido a través de red celular. Requisitos previos: * El parámetro EmailFrom debe configurarse en la personalización del runbook (ajuste RJReport.EmailSender) cuando se solicita un informe por correo electrónico * Los ajustes RJReport.StorageAccount.\* deben configurarse cuando se solicita un enlace de descarga Origen de los datos y actualidad: Todos los valores se toman del inventario de Intune de cada dispositivo, que se actualiza con la comprobación regular del dispositivo. Por tanto, describen el estado de la última comprobación exitosa y no necesariamente el estado actual. Los detalles de red y SIM (dirección IP, subred, ICCID, UDID, ...) no forman parte de la respuesta de la lista de dispositivos de Graph y se recuperan con una solicitud adicional de Graph por dispositivo, enviada a través del endpoint batch de Graph en lotes de hasta 20. Rendimiento: Los detalles de red/SIM están deshabilitados de forma predeterminada. Cuando se habilitan, el tiempo de ejecución crece linealmente con el número de dispositivos móviles. En tenants con muchos dispositivos móviles, combine la opción con los filtros de ámbito de grupo. 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 mediante ICCID e identificador de eSIM * Entregar el inventario completo de dispositivos móviles a gestión de activos como un libro de trabajo de Excel o un archivo CSV ### 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 ámbito de grupo)* * *Lee los miembros de los grupos para resolver los filtros opcionales de ámbito de grupo de dispositivos/usuarios* * Organization.Read.All *(opcional — función: Informe por correo electrónico / enlace de descarga)* * *Lee /organization para el nombre del tenant usado en los nombres de archivo del informe, el asunto del correo y el pie de página del correo; sin ello, el runbook recurre a 'Tenant desconocido'* * Mail.Send *(opcional — característica: informe por correo electrónico)* * *Envía el correo del informe mediante Send-RjRbReportEmail cuando EmailTo está configurado* #### Notas sobre permisos Azure Storage Account: rol 'Storage Account Contributor' para la identidad administrada de la Automation Account en la cuenta de almacenamiento de destino; la carga recupera las claves de la cuenta mediante listKeys (solo necesario cuando se usa CreateDownloadLink) ### Parámetros #### Android Incluir dispositivos Android en los resultados. | Propiedad | Valor | | ---------------------------- | ---------------------------- | | Obligatorio | false | | Valor predeterminado | True | | Tipo | Booleano | | Nombre mostrado en el portal | Incluir dispositivos Android | #### iOS Incluye dispositivos iOS e iPadOS en los resultados. | Propiedad | Valor | | ---------------------------- | ------------------------------- | | Obligatorio | false | | Valor predeterminado | True | | Tipo | Booleano | | Nombre mostrado en el portal | Incluir dispositivos iOS/iPadOS | #### IncludeNetworkDetails Añade al resultado la última dirección IP y subred informadas, ICCID, identificador de eSIM, tecnología celular, UDID, estado de salud de la batería y estado de iPad compartido. Requiere una solicitud adicional de Graph por dispositivo (enviada en lotes de 20), por lo que el tiempo de ejecución crece con el número de dispositivos. Deshabilitado de forma predeterminada. | Propiedad | Valor | | ---------------------------- | -------------------------------------------------------------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre mostrado en el portal | Incluir detalles de red/SIM (una llamada adicional a Graph por dispositivo: más lento con muchos dispositivos) | #### IncludePhoneNumber Controla si se recupera y muestra el número de teléfono. Cuando se deshabilita, la columna del número de teléfono se omite por completo. Tenga en cuenta que Intune, de todos modos, oculta parcialmente el número de teléfono de los dispositivos de propiedad personal. | Propiedad | Valor | | ---------------------------- | ------------------------------------------- | | Obligatorio | false | | Valor predeterminado | True | | Tipo | Booleano | | Nombre mostrado en el portal | Incluir números de teléfono en el resultado | #### IncludeDeviceGroup Incluye solo los dispositivos que sean miembros de este grupo de dispositivos de Entra. Se resuelven las pertenencias a grupos anidados. Déjelo vacío para incluir todos los dispositivos móviles. | Propiedad | Valor | | ---------------------------- | --------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Nombre mostrado en el portal | Limitar a dispositivos en el grupo (opcional) | #### IncludeUserGroup Incluye solo los dispositivos cuyo usuario principal sea miembro de este grupo de usuarios de Entra. Se resuelven las pertenencias a grupos anidados. Déjelo vacío para incluir todos los dispositivos móviles. | Propiedad | Valor | | ---------------------------- | ----------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Nombre mostrado en el portal | Limitar a usuarios principales en el grupo (opcional) | #### EmailFrom La dirección de correo electrónico del remitente. Esto debe configurarse en la personalización del runbook | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingHeaderImageUrl URL HTTPS pública opcional de una imagen de encabezado personalizada (PNG/JPEG/GIF, máx. 200 KB) para el correo electrónico del informe. Se obtiene de la configuración del tenant RJReport.Branding.HeaderImageUrl. Cuando está vacía, se usa el gráfico de encabezado predeterminado de RealmJoin. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingFooterImageUrl URL HTTPS pública opcional de una imagen de pie de página personalizada (PNG/JPEG/GIF, máx. 200 KB) para el correo electrónico del informe. Se obtiene de la configuración del tenant RJReport.Branding.FooterImageUrl. Cuando está vacía, se usa el gráfico de pie de página predeterminado de RealmJoin. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingFooterLink URL opcional a la que enlaza la imagen del pie de página. Se obtiene de la configuración del tenant RJReport.Branding.FooterLink. Cuando está vacía, se usa el enlace predeterminado (). | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingAccentColor Anulación opcional del color de acento (hexadecimal de 6 dígitos, por ejemplo '#0052cc') para la plantilla del correo electrónico del informe. Se obtiene de la configuración del tenant RJReport.Branding.AccentColor. Cuando está vacío o no es válido, se usa el color de acento predeterminado de RealmJoin. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingTextColor Anulación opcional del color de texto (hexadecimal de 6 dígitos) para la plantilla del correo electrónico del informe. Se obtiene de la configuración del tenant RJReport.Branding.TextColor. Cuando está vacío o no es válido, se usa el color de texto predeterminado de RealmJoin. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### ReportFileFormat Controla qué formatos de archivo del informe se generan y entregan: "solo CSV", "CSV y XLSX" o "solo XLSX" (predeterminado). | Propiedad | Valor | | ---------------------------- | ------------------------------ | | Obligatorio | false | | Valor predeterminado | solo XLSX | | Tipo | String | | Nombre mostrado en el portal | Formato de archivo del informe | **Opciones del portal** | Opción del portal | Valor | | ----------------- | ----- | | CSV & XLSX | | | solo CSV | | | solo XLSX | | #### CreateDownloadLink Si está habilitado, los archivos del informe se cargan en una Azure Storage Account y se devuelven enlaces de descarga con tiempo limitado. Deshabilitado de forma predeterminada. | Propiedad | Valor | | ---------------------------- | ----------------------------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre mostrado en el portal | ¿Crear un enlace de descarga de archivo (subir el informe al almacenamiento)? | **Opciones del portal** | Opción del portal | Valor | | ----------------------------------------------------- | ----- | | Sí: subir el informe y devolver un enlace de descarga | true | | No: no crear un enlace de descarga | false | #### ContainerName Nombre del contenedor de almacenamiento usado para la carga. Configurado por runbook (no es una configuración global de RJReport). | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | list-mobile-devices | | Tipo | String | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### ResourceGroupName Grupo de recursos que contiene la Storage Account. Procede de las configuraciones de Tenant de RJReport. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### StorageAccountName Nombre de la Storage Account usado para la carga. Procede de las configuraciones de Tenant de RJReport. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### LinkExpiryDays Número de días hasta que expira el enlace de descarga generado. Procede de las configuraciones de Tenant de RJReport. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | 6 | | Tipo | Int32 | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### EmailTo Si se especifica, se enviará un correo electrónico con el informe a la(s) dirección(es) proporcionada(s). Puede ser una sola dirección o varias direcciones separadas por comas (cadena). La función envía correos individuales a cada destinatario por motivos de privacidad. | Propiedad | Valor | | ---------------------------- | ----------------------------------------------------------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Nombre mostrado en el portal | Dirección(es) de correo electrónico del destinatario (opcional: deje vacío para solo la salida del trabajo) | [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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` 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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.