Asociación de espacios empresariales: información general sobre el uso de CMPivot

Artículo
04/04/2023

Se aplica a: Configuration Manager (rama actual)

CMPivot le permite evaluar rápidamente el estado de un dispositivo en su entorno y tomar medidas. Al escribir una consulta, CMPivot ejecutará una consulta en tiempo real en el dispositivo que esté conectado en ese momento. Los datos devueltos se pueden filtrar, agrupar y refinar para responder a las preguntas empresariales, solucionar problemas en su entorno o reaccionar ante amenazas de seguridad. Para obtener más información sobre el uso de CMPivot, vea Uso de CMPivot.

Refinar consultas de CMPivot

Al usar CMPivot desde el centro de administración de Microsoft Intune, asegúrese de que las consultas están optimizadas para el rendimiento. Si solicita una consulta con un conjunto de datos demasiado grande, puede recibir Error: The query result is too large, retry with additional filters. Refine la consulta para que sea más específica si ve este error. Los siguientes operadores se usan normalmente para refinar consultas:

Use count si solo necesita el número de elementos devueltos.
Use project si solo necesita columnas específicas.
Use take para devolver hasta el número especificado de filas.
Use top para devolver los primeros N registros ordenados por columnas especificadas.

Importante

Cuando se usa CMPivot para consultar un dispositivo, si no hay una respuesta en 10 minutos, se agotará el tiempo de espera de la consulta.

Consultas

Las consultas se pueden usar para buscar términos, identificar tendencias, analizar patrones y proporcionar muchas otras conclusiones basadas en los datos. CMPivot usa un subconjunto del modelo de flujo de datos de Azure Log Analytics para la instrucción de expresión tabular. La estructura típica de una instrucción de expresión tabular es una composición de entidades cliente y operadores de datos tabulares (como filtros y proyecciones). La composición se representa mediante el carácter de canalización (|), lo que proporciona a la instrucción una forma regular que representa visualmente el flujo de datos tabulares de izquierda a derecha. Cada operador acepta un conjunto de datos tabulares "desde la canalización" y entradas adicionales (incluidos otros conjuntos de datos tabulares) del cuerpo del operador y, a continuación, emite un conjunto de datos tabulares al operador siguiente: entity | operator1 | operator2 | ...

En el ejemplo siguiente, la entidad es CCMRecentlyUsedApplications (una referencia a las aplicaciones usadas recientemente) y el operador es donde (que filtra los registros de su entrada según algún predicado por registro):

CCMRecentlyUsedApplications | where CompanyName like '%Microsoft%' | project CompanyName, ExplorerFileName, LastUsedTime, LaunchCount, FolderPath

Entidades

Las entidades son objetos que se pueden consultar desde el cliente. Actualmente se admiten las siguientes entidades:

Entidad	Descripción
AadStatus	Estado del identificador de Microsoft Entra
Administradores	Miembros del grupo de administradores locales
AppCrash	Informes de bloqueo de aplicaciones recientes
AppVClientApplication	Aplicación cliente de AppV
AppVClientPackage	Paquete de cliente de AppV
AutoStartSoftware	Software que se inicia automáticamente con el sistema operativo o inmediatamente después
Zócalo	Zócalo
Batería	Batería
Bios	Información del BIOS del sistema
BitLocker	BitLocker
BitLockerEncryptionDetails	Detalles del cifrado de BitLocker
BitLockerPolicy	Directiva de BitLocker
BootConfiguration	Configuración de arranque
BrowserHelperObject	Browser Helper (objeto)
BrowserUsage	Uso del explorador
CcmLog()	Líneas en un plazo de 24 horas (de forma predeterminada) desde un archivo de registro de Ccm
CCMRAX	CCM_RAX
CCMRecentlyUsedApplications	Aplicaciones usadas recientemente
CCMWebAppInstallInfo	Aplicaciones web
CDROM	Unidad CDROM
ClientEvents	Eventos de cliente
ComputerSystem	Sistema informático
ComputerSystemEx	Sistema de equipo Ex
ComputerSystemProduct	Producto del sistema informático
ConnectedDevice	Dispositivo conectado
Connection	Una conexión Tcp activa dentro o fuera del dispositivo
Escritorio	Escritorio
DesktopMonitor	Monitor de escritorio
Dispositivo	Información básica sobre el dispositivo
Disco	Información del dispositivo de almacenamiento local en un sistema de equipo que ejecuta Windows
DMA	DMA
DMAChannel	Canal DMA
DriverVxD	Controlador: VxD
EmbeddedDeviceInformation	Información del dispositivo incrustado
Entorno	Entorno
EPStatus	Estado del software antimalware en el equipo recopilado por el `Get-MpComputerStatus` cmdlet . Compatible con Windows 10 y Server 2016 o posterior con defender en ejecución.
EventLog()	Eventos en un plazo de 24 horas (de forma predeterminada) desde un registro de eventos
File()	Información sobre un archivo específico
Fileshare	Información del recurso compartido de archivos activo
Firmware	Firmware
IDEController	Controlador IDE
InstalledExecutable	Ejecutable instalado
InstalledSoftware	Una aplicación instalada en el dispositivo
IPConfig	Obtiene la configuración de red, incluidas las interfaces utilizables, las direcciones IP y los servidores DNS.
IRQTable	Tabla IRQ
Keyboard	Keyboard
LoadOrderGroup	Grupo de pedidos de carga
Disco lógico	Disco lógico
MDMDevDetail	Información del dispositivo
Memoria	Memoria
Módem	Módem
Placa base	Placa base
NetworkAdapter	Adaptador de red
NetworkAdapterConfiguration	Configuración del adaptador de red
NetworkClient	Cliente de red
NetworkLoginProfile	Perfil de inicio de sesión de red
NTEventlogFile	Archivo de registro de eventos NT
Office365ProPlusConfigurations	Configuraciones de aplicaciones de Office 365
OfficeAddin	Complementos de Office
OfficeClientMetric	Métrica de cliente de Office
OfficeDeviceSummary	Resumen de dispositivos de Office
OfficeDocumentMetric	Métricas de documentos de Office
OfficeDocumentSolution	Solución de documento de Office
OfficeMacroError	Office Macro Error
OfficeProductInfo	Información del producto de Office
OfficeVbaRuleViolation	Infracción de la regla de Vba de Office
OfficeVbaSummary	Resumen del examen de VBA de Office
OperatingSystem	Sistema operativo
OperatingSystemEx	Sistema operativo Ex
OperatingSystemRecoveryConfiguration	Configuración de recuperación del sistema operativo
OptionalFeature	Característica opcional
SO	Información básica sobre el sistema operativo
PageFileSetting	Configuración del archivo de página
ParallelPort	Puerto paralelo
Partition	Particiones de disco
PCMCIAController	Controlador PCMCIA
Discofísico	Discofísico
PhysicalMemory	Memoria física
PNPDEVICEDRIVER	Controlador de dispositivo PNP
PointingDevice	Dispositivo señalador
PortableBattery	Batería portátil
Puertos	Puertos
Capacidades de energía	Funcionalidades de energía
PowerClientOptOutSettings	Configuración de exclusión de administración de energía
PowerConfigurations	Configuración de energía
PowerManagementDaily	Datos diarios de administración de energía
PowerManagementInsomniaReasons	Motivos de insomnio de energía
PowerManagementMonthly	Datos mensuales de Power Management
PowerSettings	Configuración de energía
PrinterConfiguration	Configuración de la impresora
PrinterDevice	Dispositivo de impresora
PrintJobs	Trabajos de impresión
Proceso	Un proceso en un sistema operativo
ProcessModule()	Módulos cargados por procesos especificados
Procesador	Procesador
ProtectedVolumeInformation	Información de volumen protegida
Protocolo	Protocolo
QuickFixEngineering	Ingeniería de corrección rápida
Registro	Todos los valores de una clave del Registro específica a partir de la versión 2107, el valor De clave se agregó a la entidad Registry()
SCSIController	Controlador SCSI
SerialPortConfiguration	Configuración del puerto serie
SerialPorts	Puertos serie
ServerFeature	Característica de servidor
Servicio	Un servicio en un sistema informático que ejecuta Windows
Servicios	Servicios
Acciones	Acciones
SMBConfig	Configuración de SMB de un dispositivo
SMSAdvancedClientPorts	puertos de cliente de Configuration Manager
SMSAdvancedClientSSLConfigurations	configuraciones SSL de cliente de Configuration Manager
SMSAdvancedClientState	Configuration Manager estado de cliente
SMSDefaultBrowser	Explorador predeterminado
SMSSoftwareTag	Etiqueta de software
SMSWindows8Application	Aplicación de Windows
SMSWindows8ApplicationUserInfo	Información de usuario de la aplicación Windows
SoftwareShortcut	Acceso directo de software
SoftwareUpdate	Una actualización de software aplicable pero no instalada en el dispositivo
SoundDevices	Dispositivos de sonido
SWLicensingProduct	Producto de licencias de software
SWLicensingService	Servicio de licencias de software
SystemAccount	Cuenta del sistema
SystemBootData	Datos de arranque del sistema
SystemBootSummary	Resumen de arranque del sistema
SystemConsoleUsage	Uso de la consola del sistema
SystemConsoleUser	Usuario de la consola del sistema
SystemDevices	Dispositivos del sistema
SystemDrivers	Controladores del sistema
SystemEnclosure	Caja del sistema
TapeDrive	Unidad de cinta
TimeZone	Zona horaria
TPM	TPM
TPMStatus	Estado de TPM
TSIssuedLicense	Licencia emitida por TS
TSLicenseKeyPack	Paquete de claves de licencia de TS
UninterruptiblePowerSupply	Fuente de alimentación ininterrumpida
USBController	Controlador USB
USBDevice	Dispositivo USB
Usuario	Una cuenta de usuario con una conexión activa al dispositivo
USMFolderRedirectionHealth	Estado del redireccionamiento de carpetas
USMUserProfile	Estado del perfil de usuario
VideoController	Controlador de vídeo
VirtualMachine	Máquina virtual
VirtualMachine64	Máquina virtual (64)
Volumen	Volumen
WindowsUpdate	Windows Update
WindowsUpdateAgentVersion	Versión del agente de Windows Update
WinEvent()	Eventos en un plazo de 24 horas (de forma predeterminada) desde un registro de eventos de Windows
WriteFilterState	Escribir estado de filtro

Operadores de tabla

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

Operadores de tabla	Descripción
count	Devuelve una tabla con un único registro que contiene el número de registros.
Distintas	Genera una tabla con la combinación distinta de las columnas proporcionadas de la tabla de entrada.
join	Combinar las filas de dos tablas para formar una nueva tabla mediante una fila coincidente para el mismo dispositivo
order by	Ordenar las filas de la tabla de entrada en orden por una o varias columnas
proyecto	Seleccione las columnas que desea incluir, cambiar el nombre o quitar e insertar nuevas columnas calculadas.
Tomar	Devolver hasta el número especificado de filas
top	Devuelve los primeros N registros ordenados por las columnas especificadas.
Dónde	Filtra una tabla al subconjunto de filas que satisfacen un predicado

Operadores escalares

En la tabla siguiente se resumen los operadores:

Operadores	Descripción	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`
como	El lado izquierdo (LHS) contiene una coincidencia para el lado derecho (RHS)	`'abc' like '%B%'`
!Como	LHS no contiene una coincidencia para RHS	`'abc' !like '_d_'`
contains	RHS se produce como una subsecuencia de LHS	`'abc' contains 'b'`
!Contiene	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'`
y	True si y solo si RHS y LHS son true	`(1 == 1) and (2 == 2)`
o	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 con el operador de tabla summarize para calcular los valores resumidos. Actualmente se admiten las siguientes funciones de agregación:

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()	A partir de la versión 2107, puede usar maxif con el operador de tabla summarize. 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()	A partir de la versión 2107, puede usar minif con el operador de tabla summarize. 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 en expresiones. Actualmente se admiten las siguientes funciones escalares:

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.
datetime_diff()	Calcula la diferencia entre dos valores de fecha y hora
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()	La función 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 que no es 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 desde algún índice hasta el final de la cadena.
tostring()	Convierte la entrada en una representación de cadena

Entidades, operadores y funciones adicionales para CMPivot desde Configuration Manager