Asociación de espacios empresariales: información general sobre el uso de CMPivot
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
countsi solo necesita el número de elementos devueltos. - Use
projectsi solo necesita columnas específicas. - Use
takepara devolver hasta el número especificado de filas. - Use
toppara 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 id. 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 |
| Rodapié | Rodapié |
| 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 versiones posteriores 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 |
| PhysicalDisk | PhysicalDisk |
| 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 | Estado de cliente de Configuration Manager |
| 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. |
| distinto | 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%' |
| !gustar | 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) |
| Otra posibilidad: | 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
Importante
Estos elementos no se admiten al ejecutar CMPivot desde el Centro de administración de Microsoft Intune.
| Tipo | Item | Descripción |
|---|---|---|
| Entidad | AccountSID | SID de cuenta |
| Entidad | FileContent() | Contenido de un archivo específico |
| Entidad | NAPClient | Cliente NAP |
| Entidad | NAPSystemHealthAgent | Agente de mantenimiento del sistema NAP |
| Entidad | RegistryKey() | Devuelve todas las claves del Registro que coinciden con la expresión especificada (a partir de la versión 2107) |
| Operador table | render | Representa los resultados como salida gráfica |
Pasos siguientes
Para obtener más información, vea Iniciar CMPivot desde el centro de administración Para obtener más scripts de ejemplo, vea Asociación de inquilinos de Microsoft Intune: ejemplos de script de CMPivot.