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

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 y registro. Opcionalmente se agregan la última dirección IP y subred informadas, ICCID, identificador eSIM, tecnología celular, UDID, estado de 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 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 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 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 una Resumen tabla (recuentos 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 consola muestra los mismos recuentos, 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 vínculo de descarga; consulte la sección sobre la 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

Número de serie

Número de serie del hardware

IMEI

Identificador 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; de lo contrario, la columna se omite por completo

Operador

Operador suscriptor de la SIM

Propiedad

de la empresa o personal

Cumplimiento

Estado de cumplimiento de Intune

Última sincronización

Marca de tiempo del último ingreso correcto a Intune

Seguridad y registro (siempre mostrado)

Columna
Origen y significado

Supervisado

Modo supervisado de iOS/iPadOS

Cifrado

Estado de cifrado del dispositivo

Con jailbreak

Si el dispositivo tiene jailbreak o root

Estado de amenaza

Estado de amenaza informado por un socio de Mobile Threat Defense (solo tiene sentido cuando hay conectado un socio MTD)

Nivel de parche

Nivel del parche de seguridad de Android (vacío en iOS/iPadOS)

Tipo de registro / perfil de registro

Cómo se registró el dispositivo y el perfil de registro utilizado

Categoría

Categoría del dispositivo en Intune

GB libres / GB totales

Almacenamiento libre y total (vacío cuando el dispositivo no informa un inventario de almacenamiento utilizable, común en los perfiles de trabajo de Android Enterprise)

Registrado

Fecha de registro

Red y SIM (solo con IncludeNetworkDetails habilitado; desactivado de forma predeterminada)

Columna
Origen 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

MAC de Wi‑Fi

Dirección MAC de Wi‑Fi del dispositivo

ICCID

Número de identificación único de la tarjeta SIM

eSIM

Identificador 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 salud de la batería, cuando se informa

Compartido

Si el dispositivo es un iPad compartido

Última sincronización

Marca de tiempo del último ingreso correcto a Intune: indica cuán antigua es la información de IP

Esta tabla se ordena 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 ingreso correcto del dispositivo a Intune, no necesariamente el estado actual: interprételos siempre junto con la columna LastSync. Intune no informa el 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 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 deshabilitados de forma predeterminada y deben habilitarse con cuidado en inquilinos 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 punto de conexión 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 por grupo.

Filtrado por ámbito

El ámbito puede limitarse a los miembros de un grupo de dispositivos de Entra ID (IncludeDeviceGroup) y/o a los dispositivos cuyo usuario principal es miembro de un grupo de usuarios (IncludeUserGroup). Cuando se establecen ambos filtros, un dispositivo debe cumplir 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 Output Data 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 del vínculo de descarga son independientes y pueden combinarse; la Formato del archivo del informe está predeterminada solo para 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 ningún dispositivo móvil coincide, el correo electrónico indica que no se encontró ningún dispositivo y no lleva ningún adjunto.

  • Vínculo de descarga: carga los archivos del informe en la cuenta de almacenamiento de Azure configurada en el RJReport.StorageAccount.* en la configuración del inquilino (contenedor list-mobile-devices de forma predeterminada) y muestra vínculos SAS de descarga 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 gestión de activos. La carga al almacenamiento se autentica con la identidad administrada de la cuenta de Automation; esa identidad necesita la Storage Account Contributor rol RBAC en la Storage Account de destino (esto es una asignación de Azure RBAC, no un permiso de aplicación de Graph).

Los archivos del informe contienen todas las columnas de las tablas anteriores, incluida la Id. de dispositivo. La Número de teléfono 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 opción existía siguen enviando su correo electrónico: un destinatario almacenado por sí solo aún les habilita el correo electrónico. Cuando una programación de este tipo se abre para edición, la opción muestra solo Output Data; 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 opción incluye un correo electrónico; entonces se requiere un destinatario. La dirección del remitente se toma de RJReport.EmailSender configuración del tenant.

Este runbook envía correos electrónicos usando la API de Microsoft Graph. Para enviar correos electrónicos mediante la API de Graph, 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 para obtener detalles sobre todas las configuraciones disponibles.

Branding del correo electrónico

El correo electrónico del informe respeta las opciones opcionales RJReport.Branding.* de configuración del tenant:

  • Imagen de encabezado y pie de página - URLs 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 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: Branding del correo electrónico.

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.9) Microsoft.Graph.Authentication (>= 2.39.0) 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 — característica: filtrado por ámbito de grupo)

      • Lee los miembros del grupo para resolver los filtros opcionales de ámbito por 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 el nombre del inquilino usado en los nombres de los archivos del informe, el asunto del correo electrónico y el pie de página del correo electrónico; sin ello, el runbook recurre a 'Unknown Tenant'

Notas de permisos

Azure Storage Account: rol 'Storage Account Contributor' 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

Requerido

falso

Valor predeterminado

Verdadero

Tipo

Booleano

Nombre para mostrar en el portal

¿Incluir dispositivos Android?

iOS

Incluye dispositivos iOS e iPadOS.

Propiedad
Valor

Requerido

falso

Valor predeterminado

Verdadero

Tipo

Booleano

Nombre para mostrar en el portal

¿Incluir dispositivos iOS/iPadOS?

IncludeNetworkDetails

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

Propiedad
Valor

Requerido

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 oculta parte del número en los dispositivos de propiedad personal.

Propiedad
Valor

Requerido

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. Dejar vacío para todos los dispositivos móviles.

Propiedad
Valor

Requerido

falso

Valor predeterminado

Tipo

Cadena

Nombre para mostrar en el portal

Limitar a dispositivos del grupo

IncludeUserGroup

Solo dispositivos cuyo usuario principal esté en este grupo, incluidos los grupos anidados. Dejar vacío para todos.

Propiedad
Valor

Requerido

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. Tomada de la configuración del tenant RJReport.EmailSender.

Propiedad
Valor

Requerido

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido 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). Tomada de la configuración del tenant RJReport.Branding.HeaderImageUrl; se usa el encabezado predeterminado de RealmJoin cuando está vacía.

Propiedad
Valor

Requerido

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido 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). Tomada 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

Requerido

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

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

Propiedad
Valor

Requerido

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 hexagonal de 6 dígitos. Tomada de la configuración del tenant RJReport.Branding.AccentColor; se usa el valor predeterminado de RealmJoin cuando está vacío o no es válido.

Propiedad
Valor

Requerido

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 hexagonal de 6 dígitos. Tomada de la configuración del tenant RJReport.Branding.TextColor; se usa el valor predeterminado de RealmJoin cuando está vacío o no es válido.

Propiedad
Valor

Requerido

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

Requerido

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

También carga el informe y devuelve un enlace de descarga que caduca después de unos días.

Propiedad
Valor

Requerido

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 cargan los archivos del informe. Configurar por runbook.

Propiedad
Valor

Requerido

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 Storage Account para las cargas del informe. Tomado de la configuración Tenant RJReport.StorageAccount.ResourceGroup.

Propiedad
Valor

Requerido

falso

Valor predeterminado

Tipo

Cadena

Oculto en el portal

sí (preestablecido mediante la personalización del runbook)

StorageAccountName

Storage Account para las cargas del informe. Tomado de la configuración Tenant RJReport.StorageAccount.StorageAccountName.

Propiedad
Valor

Requerido

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. Tomado de la configuración Tenant RJReport.StorageAccount.LinkExpiryDays.

Propiedad
Valor

Requerido

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

Requerido

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. Separe varias con comas; cada destinatario recibe un correo electrónico independiente.

Propiedad
Valor

Requerido

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)

Última actualización

¿Te fue útil?