Compartir a través de

Consulta de dispositivos para varios dispositivos

Nota:

Esta funcionalidad está disponible como un complemento de Intune. Para obtener más información, consulte Uso de funcionalidades de complemento de Intune Suite.

La consulta de dispositivos para varios dispositivos le permite obtener información completa sobre toda la flota de dispositivos mediante Lenguaje de consulta Kusto (KQL) para consultar los datos de inventario recopilados de los dispositivos.

Antes de empezar

Requisitos previos adicionales para la consulta de dispositivos para varios dispositivos:

Requisitos de la plataforma de dispositivos

La consulta de dispositivos para varios dispositivos admite:

  • Windows
  • Android
    • Dispositivos Android Enterprise dedicados de propiedad corporativa (COSU)
    • Dispositivos Android Enterprise de propiedad corporativa totalmente administrados (COBO)
    • Perfil de trabajo de propiedad corporativa de Android Enterprise (COPE)
  • Apple
    • iOS/iPadOS
    • macOS

Requisitos de configuración del dispositivo

La consulta de dispositivos para varios dispositivos admite dispositivos que son:

  • Administrado por Intune y marcado como propiedad corporativa
  • Los dispositivos Windows deben tener implementada una directiva de catálogo de propiedades para recopilar datos de inventario.
    Para iOS/iPadOS, Android y macOS, los datos se recopilan automáticamente y no es necesario implementar una directiva de catálogo de propiedades independiente.

Requisitos de roles

Para usar la consulta de dispositivos para varios dispositivos, use una cuenta con al menos uno de los siguientes roles:

  • Operador del Servicio de asistencia
  • Rol personalizado que incluye:
    • El permiso Dispositivos administrados o consulta
    • Permisos que proporcionan visibilidad y acceso a los dispositivos administrados en Intune (por ejemplo, organización, lectura, dispositivos administrados o lectura)

Uso de la consulta de dispositivos para varios dispositivos

  1. En el centro de administración de Microsoft Intune, seleccione Dispositivos>Consulta de dispositivos.
  2. Escriba una consulta en el cuadro de consulta mediante las propiedades admitidas y los operadores admitidos.
  3. Seleccione Ejecutar para ejecutar la consulta.
  4. Los resultados se muestran en el área de pestaña Resultados .
    • Para ejecutar parte de una consulta o una sola consulta cuando hay varias consultas en la ventana, resalte la consulta que desea ejecutar y seleccione Ejecutar. Solo se ejecuta la consulta resaltada.

Puede expandir la vista en el lado izquierdo para ver todas las propiedades que se pueden consultar. Seleccione cualquiera para rellenarla en la consulta. Puede seleccionar y arrastrar los bordes del lado izquierdo y de la ventana de consulta para realizar ajustes.

Después de ejecutar una consulta, seleccione Exportar para guardar los resultados en un archivo .CSV. Tiene la opción de exportar todas las columnas del resultado de la consulta o solo las columnas que seleccione. Puede exportar hasta 50 000 resultados a un archivo.

Para obtener más información sobre Lenguaje de consulta Kusto, consulte Más información sobre Lenguaje de consulta Kusto.

Sugerencia

Use Copilot en Intune para generar consultas KQL para consultas de dispositivos mediante solicitudes de lenguaje natural. Para obtener más información, consulte Consulta con Copilot en la consulta de dispositivos.

Consultas de ejemplo

Para ayudarle a empezar, en esta sección se proporcionan algunas consultas de ejemplo. Para acceder a las consultas de ejemplo, expanda la sección consultas de ejemplo en la página Introducción y seleccione la que desea agregar a la ventana de consulta. En la sección siguiente se muestra la lista de consultas de ejemplo.

Principales procesadores por número de núcleos

Esta consulta muestra las cinco CPU principales por número de núcleos.

Cpu
| project Device, ProcessorId, Model, Architecture, CpuStatus, ProcessorType, CoreCount, LogicalProcessorCount, Manufacturer, AddressWidth
| order by CoreCount asc
| take 5

Dispositivos con discos no protegidos

Esta consulta enumera los dispositivos con discos sin cifrar.

EncryptableVolume
| where ProtectionStatus != "PROTECTED"
| join LogicalDrive on Device

Dispositivos Arm64

Esta consulta enumera todos los dispositivos con un procesador ARM64.

Cpu
| where Architecture == "ARM64"

Recuento de dispositivos por arquitectura de procesador

Esta consulta proporciona un resumen de los dispositivos por arquitectura de CPU.

Cpu
| summarize DeviceCount = count() by Architecture

Principales dispositivos por capacidad de batería

En esta consulta se enumeran los 10 dispositivos principales por capacidad de batería totalmente cargada.

Battery
| project Device, InstanceName, Manufacturer, Model, SerialNumber, CycleCount,
          DesignedCapacity,
          FullChargedCapacity,
          FullChargedCapacityPercent = (FullChargedCapacity * 100) / DesignedCapacity
| top 10 by FullChargedCapacityPercent asc

Información de memoria de dispositivos

En esta consulta se enumeran los dispositivos con memoria física y virtual en GB.

MemoryInfo
| project Device,
          PhysicalMemoryGB = PhysicalMemoryTotalBytes/(1000*1000*1000),
          VirtualMemoryGB = VirtualMemoryTotalBytes/(1000*1000*1000)
| order by PhysicalMemoryGB asc

Recuento de dispositivos por versión del sistema operativo

Esta consulta proporciona un resumen de los dispositivos por versión del sistema operativo.

OsVersion| summarize DevicesCount = count() by OsVersion

Información del bios de dispositivos

En esta consulta se enumeran los dispositivos basados en el fabricante del BIOS.

BiosInfo| where Manufacturer contains "Microsoft"

Dispositivos con TPM deshabilitado

En esta consulta se enumeran los dispositivos que tienen TPM deshabilitado.

Tpm | where Enabled != true

Operadores admitidos

La consulta de dispositivo solo admite un subconjunto de los operadores admitidos en el Lenguaje de consulta Kusto (KQL). Actualmente se admiten los siguientes operadores:

Operadores de tabla

Los operadores de tabla se pueden usar para filtrar, resumir y transformar flujos de datos. Se admiten los operadores siguientes:

Operador table Description
count Devuelve una tabla con un único registro que contiene el número de registros.
distinct Genera una tabla con combinaciones distintas de las columnas proporcionadas a partir de la tabla de entrada.
join Combina filas de dos tablas para formar una nueva tabla basada en valores coincidentes en las columnas especificadas. Se admiten los siguientes tipos de combinación:
- innerunique (valor predeterminado)
- inner
- leftouter
- rightouter
- fullouter
- leftsemi
- rightsemi
- leftanti
- rightanti

Las instrucciones Join admiten una cláusula opcional on . En escenarios de consulta de dispositivos, normalmente se usa on Device al combinar tablas que contienen una Device entidad. La sintaxis común de join es : LeftTable | join [hints] (RightTable) on Conditions.

Importante: Ya no se admiten las combinaciones que usan on Device.DeviceID . Las consultas que especifiquen on Device.DeviceId actualmente deben cambiar a mediante on Deviceo omitir la on cláusula al unirse a la Device entidad.

Para obtener más información, vea Operador join.
order by Ordena las filas de la tabla de entrada por una o varias columnas.
project Selecciona las columnas para incluir, cambiar el nombre o quitar e inserta nuevas columnas calculadas.
take Devuelve hasta el número especificado de filas.
top Devuelve los primeros N registros ordenados por las columnas especificadas.
where Filtra una tabla al subconjunto de filas que satisfacen un predicado.
summarize Genera una tabla que agrega el contenido de la tabla de entrada.

Nota:

Device es un tipo de entidad y no se puede usar directamente en operadores que requieren valores escalares (como distinct, summarizey order by). Para estos operadores, use una propiedad escalar específica del dispositivo (por ejemplo, Device.SerialNumber o Device.OSVersion).

Operadores escalares

Los operadores escalares se pueden usar para realizar operaciones en valores individuales. Se admiten los operadores siguientes:

Operadores Description Ejemplo
== Igual 1 == 1, 'aBc' == 'AbC'
!= No es igual 1 != 2, 'abc' != 'abcd'
< Menos 1 < 2, 'abc' < 'DEF'
> Mayor 2 > 1, 'xyz' > 'XYZ'
<= Menor o igual 1 <= 2, 'abc' <= 'abc'
>= Mayor o igual 2 >= 1, 'abc' >= 'ABC'
+ Agregar 2 + 1, now() + 1d
- Subtract 2 - 1, now() - 1h
* Multiplicar 2 * 2
/ Dividir 2 / 1
% Módulo 2 % 1
like LHS contiene una coincidencia para RHS 'abc' like '%B%'
contains RHS se produce como una subsecuencia de LHS 'abc' contains 'b'
!contains RHS no se produce en LHS 'team' !contains 'i'
startswith RHS es una subsecuencia inicial de LHS 'team' startswith 'tea'
!startswith RHS no es una subsecuencia inicial de LHS 'abc' !startswith 'bc'
endswith RHS es una subsecuencia de cierre de LHS 'abc' endswith 'bc'
!endswith RHS no es una subsecuencia de cierre de LHS 'abc' !endswith 'a'
and True si y solo si RHS y LHS son true (1 == 1) and (2 == 2)
or True si y solo si RHS o LHS es true (1 == 1) or (1 == 2)

Funciones de agregación

Las funciones de agregación se pueden usar para resumir los datos. Se admiten las siguientes funciones:

Función Descripción
avg() Devuelve el promedio de los valores del grupo.
count() Devuelve un recuento de los registros por grupo de resumen.
countif() Devuelve un recuento de filas para las que Predicate se evalúa como true.
dcount() Devuelve el número de valores distintos del grupo.
max() Devuelve el valor máximo en el grupo.
maxif() Devuelve el valor máximo en el grupo para el que Predicate se evalúa como true.
min() Devuelve el valor mínimo en el grupo.
minif() Devuelve el valor mínimo en el grupo para el que Predicate se evalúa como true.
percentile() Devuelve una estimación del percentil de clasificación más cercano especificado de la población definida por Expr.
sum() Devuelve la suma de los valores en el grupo.
sumif() Devuelve una suma de Expr para la que Predicate se evalúa como true.

Funciones escalares

Las funciones escalares se pueden usar para realizar operaciones en valores individuales. Se admiten las siguientes funciones:

Función Descripción
ago() Resta el intervalo de tiempo especificado de la hora utc actual.
bin() Redondea los valores a un número de múltiplos de fecha y hora de un tamaño de contenedor determinado.
case() Evalúa una lista de predicados y devuelve la primera expresión de resultado cuyo predicado se cumple.
datetime_add() Calcula una nueva fecha y hora a partir de una parte de fecha especificada multiplicada por una cantidad especificada, agregada a una fecha y hora especificada. No se admiten valores negativos para el parámetro amount.
datetime_diff() Calcula la diferencia entre dos valores datetime.
iif() Evalúa el primer argumento y devuelve el valor del segundo o tercer argumento en función de si el predicado se evaluó como true (segundo) o false (tercero).
indexof() Notifica el índice de base cero de la primera aparición de una cadena especificada dentro de la cadena de entrada.
isnotnull() Evalúa su único argumento y devuelve un valor booleano que indica si el argumento se evalúa como un valor distinto de NULL.
isnull() Evalúa su único argumento y devuelve un valor booleano que indica si el argumento se evalúa como un valor NULL.
now() Devuelve la hora actual del reloj UTC.
strcat() Concatena entre 1 y 64 argumentos.
strlen() Devuelve la longitud, en caracteres, de la cadena de entrada.
substring() Extrae una subcadena de una cadena de origen que comienza desde algún índice hasta el final de la cadena.
tostring() Convierte la entrada en una representación de cadena.

Propiedades admitidas

La consulta de dispositivo admite las siguientes entidades. Para obtener más información sobre qué propiedades se admiten para cada entidad, consulte Intune Esquema de la plataforma de datos.

  • Apple Auto Setup Admin Accounts
  • Apple Device States
  • Apple Update Settings
  • Battery
  • Bios Info
  • Bluetooth
  • Cellular
  • CPU
  • Device Storage
  • Disk Drive
  • Encryptable Volume
  • Logical Drive
  • Memory Info
  • Network Adapter
  • Os Version
  • Shared iPad
  • Sim Info
  • System Enclosure
  • SystemInfo
  • Time
  • Tpm
  • Video Controller
  • Windows Qfe

Entidad de dispositivo

La consulta de dispositivos para varios dispositivos admite una entidad vinculada. La entidad Device se puede usar con todas las demás entidades admitidas. La entidad de dispositivo admite las siguientes propiedades:

Propiedad Tipo Descripción
DeviceId Cadena Identificador único generado por Intune como parte de la inscripción de dispositivos.
EntraDeviceId Cadena Identificador único generado por Microsoft Entra como parte de Microsoft Entra registro o unión.
ManagementName Cadena Nombre de dispositivo fácilmente reconocible que solo se usa en el centro de administración de Intune. Al cambiar este nombre no se cambia el nombre del dispositivo ni el nombre de la Portal de empresa.
DeviceName Cadena Nombre del dispositivo.
SerialNumber Cadena Número de serie del dispositivo
Manufacturer Cadena Fabricante del dispositivo.
Model Cadena Modelo del dispositivo.
OSDescription Cadena Descripción completa de la edición del sistema operativo
OSVersion Cadena Versión del sistema operativo del dispositivo.
EnrollmentProfileName Cadena Nombre del perfil de inscripción asignado al dispositivo. El valor predeterminado es una cadena vacía que indica que no se asignó ningún perfil de inscripción al dispositivo.
EnrolledDateTime Datetime Fecha y hora en que el dispositivo se inscribió en Intune.
CertExpirationDateTime Datetime Notifica la fecha de expiración del certificado de administración de dispositivos.
EnrolledByUserId Cadena Identificador único del usuario que inscribió el dispositivo
PrimaryUserId Cadena Identificador único del usuario asociado al dispositivo.
LastLoggedOnUserId Cadena Identificador único del usuario que inició sesión por última vez en el dispositivo.
InCompliancePeriodUntilDateTime Datetime Fecha y hora en que expira el período de gracia de cumplimiento del dispositivo.
DeviceCategoryId Cadena Nombre para mostrar de la categoría de dispositivo. El valor predeterminado es una cadena vacía.
LastSeenDateTime Cadena Fecha y hora en que el dispositivo se conectó a Intune por última vez.
Ownership Cadena Propiedad del dispositivo.

La Device entidad permite hacer referencia a la información del dispositivo asociada a cada fila resultante sin necesidad de unirse explícitamente a una tabla de dispositivos.

De forma predeterminada, los resultados de la consulta incluyen una Device columna de entidad que proporciona contexto de dispositivo para cada fila. Operadores como project, summarizeo distinct pueden cambiar qué columnas se devuelven.

Device representa el dispositivo asociado a la fila resultante y se puede hacer referencia directamente como una columna de tipo entidad. Cuando se muestra en los resultados de la consulta, la Device entidad se muestra mediante un identificador descriptivo, como el nombre del dispositivo, para facilitar la identificación de los dispositivos.

Puede hacer referencia a las propiedades de la Device entidad en las consultas mediante Device.[Property].

La consulta siguiente devuelve toda la DiskDrive información de los dispositivos con un número de serie específico:

DiskDrive
| where Device.SerialNumber == "123"

La consulta siguiente proyecta la Device entidad y la Manufacturer propiedad de la DiskDrive entidad:


DiskDrive
| project Device, Manufacturer

De forma predeterminada, los resultados de la consulta incluyen una Device entidad que representa el dispositivo asociado a cada fila. La Device entidad es una columna de tipo entidad y no se resuelve implícitamente en una propiedad escalar específica. Al ordenar o filtrar los resultados, haga referencia explícitamente a la propiedad de dispositivo que desea usar. Por ejemplo, esta consulta ordena los resultados por nombre de dispositivo:


MemoryInfo
| order by Device.DeviceName

De forma similar, para filtrar por nombre de dispositivo, haga referencia a la DeviceName propiedad directamente:


Cpu
| where Device.DeviceName == "Desktop123"

Limitaciones conocidas

  • El uso de columnas de tipo entidad, como Device en las funciones de agregación, puede mostrar un subrayado rojo en el editor porque las funciones de agregación requieren valores escalares. Para evitarlo, haga referencia a una propiedad escalar específica de la entidad. Por ejemplo:

    Cpu
| summarize max(CpuUsage) by Device.Manufacturer

  • Las consultas que usan el join operador con $left los parámetros y $right pueden mostrar un subrayado rojo en el editor. Sin embargo, la consulta todavía puede ejecutarse y devolver los resultados según lo esperado.

  • Una sola consulta puede contener un máximo de tres join operadores. Se produce un error en las consultas con más combinaciones.

  • Se devuelve un máximo de ~50 000 registros para una consulta.

  • Se puede enviar un máximo de 10 consultas por minuto. Se produce un error en consultas adicionales en el mismo minuto.

  • Se pueden enviar un máximo de 1000 consultas al mes.

  • No se admiten valores negativos para el amount parámetro de la datetime_add() función.

  • Hacer referencia a una variable generada por una función de agregación sin denominarla explícitamente puede provocar un error en una consulta. Asignar un nombre explícito a la variable permite que la consulta se realice correctamente. Por ejemplo:

    • Se produce un error en la consulta Device | summarize dcount(DeviceId) | order by dcount_DeviceId .
    • La consulta Device | summarize DCountDeviceIdRename = dcount(DeviceId) | order by DCountDeviceIdRename se realiza correctamente.
  • Last updated on