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 .
    • Si solo desea ejecutar parte de la consulta o si tiene varias consultas en la ventana de consulta y solo quiere ejecutar una, puede resaltar la consulta que desea ejecutar y seleccionar Ejecutar. Solo se ejecuta esa consulta.

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

En esta consulta se enumeran las cinco CPU principales ordenadas 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

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:

Operadores de tabla Description
count Devuelve una tabla con un único registro que contiene el número de registros.
distinct Genera una tabla con la combinación distinta de las columnas proporcionadas de la tabla de entrada.
join Combine las filas de dos tablas para formar una nueva tabla mediante una fila coincidente para el mismo dispositivo. Solo se admiten los tipos de combinación de innerunique, Leftouter, Fullouter, Rightoutery inner. Si escribe un tipo de combinación distinto de los admitidos, se omitirán. Las instrucciones Join admiten on la sintaxis si se combinan con Device o Device.Deviceid. La sintaxis común para la combinación es LeftEntity | join [hints] (RightEntity) en Condiciones. Para obtener más información, consulte la documentación de unión .
order by Ordene las filas de la tabla de entrada en orden por una o varias columnas.
project Selecciona las columnas que desea incluir, cambia el nombre o elimina e inserta nuevas columnas calculadas.
take Devuelve el número de filas especificado.
top Devuelve los primeros N registros ordenados por las columnas especificadas.
where Filtra una tabla hasta llegar al subconjunto de filas que satisfacen un predicado.
summarize genera una tabla que agrega el contenido de la tabla de entrada.

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 entidad device permite hacer referencia al dispositivo asociado a una fila resultante sin necesidad de escribir una consulta independiente para unirlos. Básicamente, actúa como una combinación automática para incluir información del dispositivo en los resultados de la consulta.

La entidad de dispositivo se une automáticamente a todas las demás entidades para facilitar su uso. La entidad de dispositivo es la primera columna en la que consultan los resultados, a menos que la consulta actualice el tipo de valor devuelto mediante el uso de operadores como project, summarizeo distinct.

El uso de Device por sí mismo en una consulta analiza en Device.DeviceId. En la columna Device devuelta de forma predeterminada, DeviceId se traduce a DeviceName para permitir una identificación más sencilla de los dispositivos. También se puede hacer referencia a la entidad de dispositivo y sus propiedades en las consultas haciendo referencia a Device. [Propiedad Insert].

La consulta siguiente devuelve toda la información de DiskDrive para todos los dispositivos con el número de serie 123:

DiskDrive
where Device.SerialNumber = 123

La consulta siguiente proyecta las propiedades Device ID y Manufacturer de la entidad DiskDrive:

DiskDrive | project Device.DeviceId, Manufacturer

Aunque la entidad Device que se muestra como la primera columna aparece de forma predeterminada como nombres de dispositivo mediante El dispositivo por sí mismo en una consulta analiza a Device.DeviceId. Esta consulta devuelve los resultados ordenados por DeviceID, no por DeviceName:

MemoryInfo | order by Device

De forma similar, esta consulta no devuelve ningún resultado a menos que el identificador del dispositivo sea Desktop123. No consulta el nombre del dispositivo:

Cpu | where Device == "Desktop123"

Use el ejemplo siguiente para consultar el nombre del dispositivo:

Cpu | where Device.DeviceName == 'Desktop123"

Limitaciones conocidas

  • El uso de la entidad Device en las funciones de agregación muestra un subrayado rojo. Sin embargo, la consulta todavía se puede ejecutar y puede devolver los resultados según lo esperado. Por ejemplo, en la consulta siguiente se muestra un subrayado rojo en Dispositivo , pero se sigue ejecutando:

    Cpu | summarize max(Device) by Manufacturer.

  • Las consultas con un operador join, los parámetros $left y $right muestran un subrayado rojo en $left y $right. Sin embargo, la consulta todavía se puede ejecutar y devuelve los resultados según lo esperado.

  • Una sola consulta puede contener un máximo de tres operadores de combinación. 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. Cualquier otra consulta en el mismo minuto producirá un error.

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

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

  • Hacer referencia a una variable que se ha resumido mediante una función de agregación produce un error. Asignar un nombre explícito a la variable permite que la consulta se realice correctamente de nuevo. Por ejemplo, el dispositivo de consulta | summarize dcount(DeviceId) | por dcount_DeviceId producirá un error. Dispositivo | summarize DCountDeviceIdRename=dcount(DeviceId) | order by DCountDeviceIdRename se realiza correctamente.

  • Last updated on