Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a: Configuration Manager (ramificação atual)
O CMPivot permite avaliar rapidamente o estado de um dispositivo em seu ambiente e tomar medidas. Quando você inserir uma consulta, o CMPivot executará uma consulta em tempo real no dispositivo atualmente conectado. Os dados retornados podem ser filtrados, agrupados e refinados para responder perguntas comerciais, resolver problemas em seu ambiente ou responder a ameaças à segurança. Para obter mais informações sobre como usar o CMPivot, confira Usar o CMPivot.
Refinar consultas do CMPivot
Ao utilizar o CMPivot a partir do centro de administração do Microsoft Intune, certifique-se de que as consultas estão otimizadas para desempenho. Se você solicitar uma consulta com um conjunto de dados muito grande, poderá obter Error: The query result is too large, retry with additional filters. Caso veja esse erro, refine sua consulta para ela ser mais específica. Os seguintes operadores são os usados geralmente para refinar consultas:
- Use
countse precisar apenas do número de itens retornados. - Use
projectse precisar apenas de colunas específicas. - Use
takepara retornar até o número especificado de linhas. - Use
toppara retornar os primeiros N registros classificados pelas colunas especificadas.
Importante
Ao usar o CMPivot para consultar um dispositivo, a consulta expirará se não houver uma resposta dentro de 10 minutos.
Consultas
As consultas podem ser utilizadas para pesquisar termos, identificar tendências, analisar padrões e fornecer muitas outras informações com base nos seus dados. O CMPivot utiliza um subconjunto do modelo de fluxo de dados do Azure Log Analytics para a instrução de expressão tabular. A estrutura típica de uma instrução de expressão tabular é uma composição de entidades cliente e operadores de dados tabulares (como filtros e projeções). A composição é representada pelo caráter de pipe (|), dando à instrução um formulário regular que representa visualmente o fluxo de dados tabulares da esquerda para a direita. Cada operador aceita um conjunto de dados tabular "do pipe" e entradas adicionais (incluindo outros conjuntos de dados tabulares) do corpo do operador e, em seguida, emite um conjunto de dados tabular para o operador seguinte que se segue: entity | operator1 | operator2 | ...
No exemplo seguinte, a entidade é CCMRecentlyUsedApplications (uma referência às aplicações utilizadas recentemente) e o operador é onde (que filtra os registos da respetiva entrada de acordo com algum predicado por registo):
CCMRecentlyUsedApplications | where CompanyName like '%Microsoft%' | project CompanyName, ExplorerFileName, LastUsedTime, LaunchCount, FolderPath
Entidades
As entidades são objetos que podem ser consultados a partir do cliente. Atualmente, suportamos as seguintes entidades:
| Entidade | Descrição |
|---|---|
| AadStatus | Estado do ID do Microsoft Entra |
| Administradores | Membros do grupo de administradores locais |
| AppCrash | Relatórios de falhas de aplicação recentes |
| AppVClientApplication | Aplicação Cliente AppV |
| AppVClientPackage | Pacote de Cliente AppV |
| AutoStartSoftware | Software que é iniciado automaticamente com ou imediatamente após o sistema operativo |
| Quadro Base | Quadro Base |
| Bateria | Bateria |
| Bios | Informações do BIOS do Sistema |
| BitLocker | BitLocker |
| BitLockerEncryptionDetails | Detalhes de Encriptação do BitLocker |
| BitLockerPolicy | Política bitLocker |
| BootConfiguration | Configuração de Arranque |
| BrowserHelperObject | Objeto Auxiliar do Browser |
| BrowserUsage | Utilização do Browser |
| CcmLog() | Linhas dentro de 24 horas (por predefinição) a partir de um ficheiro de Registo ccm |
| CCMRAX | CCM_RAX |
| CCMRecentlyUsedApplications | Aplicações Utilizadas Recentemente |
| CCMWebAppInstallInfo | Aplicativos Web |
| CDROM | Unidade CDROM |
| ClientEvents | Eventos do Cliente |
| Sistema Informático | Sistema informático |
| ComputerSystemEx | Sistema Informático Ex |
| ComputerSystemProduct | Produto do Sistema informático |
| ConnectedDevice | Dispositivo Ligado |
| Conexão | Uma ligação TCP ativa dentro ou fora do dispositivo |
| Desktop | Desktop |
| DesktopMonitor | Monitor de Ambiente de Trabalho |
| Dispositivo | Informações básicas sobre o dispositivo |
| Disco | Informações do dispositivo de armazenamento local num sistema informático com o Windows |
| DMA | DMA |
| DMAChannel | Canal DMA |
| DriverVxD | Controlador - VxD |
| EmbeddedDeviceInformation | Informações do Dispositivo Incorporado |
| Ambiente | Ambiente |
| EPStatus | Estado do software antimalware no computador recolhido pelo Get-MpComputerStatus cmdlet . Suportado no Windows 10 e Server 2016 ou posterior com o Defender em execução. |
| EventLog() | Eventos dentro de 24 horas (por predefinição) a partir de um registo de eventos |
| Ficheiro() | Informações sobre um ficheiro específico |
| FileShare | Informações de partilha de ficheiros ativa |
| Firmware | Firmware |
| IDEController | Controlador IDE |
| InstalledExecutable | Executável Instalado |
| InstalledSoftware | Uma aplicação instalada no dispositivo |
| IPConfig | Obtém a configuração de rede, incluindo interfaces utilizáveis, endereços IP e servidores DNS |
| IRQTable | Tabela IRQ |
| Teclado | Teclado |
| LoadOrderGroup | Grupo de Encomendas de Carga |
| LogicalDisk | Disco Lógico |
| MDMDevDetail | Informações do Dispositivo |
| Memória | Memória |
| Modem | Modem |
| Placa principal | Placa principal |
| NetworkAdapter | Placa de Rede |
| NetworkAdapterConfiguration | Configuração da Placa de Rede |
| NetworkClient | Cliente de Rede |
| NetworkLoginProfile | Perfil de Início de Sessão de Rede |
| NTEventlogFile | Ficheiro de Registo de Eventos NT |
| Office365ProPlusConfigurations | Configurações de Aplicações do Office 365 |
| OfficeAddin | Suplementos do Office |
| OfficeClientMetric | Métrica de Cliente do Office |
| OfficeDeviceSummary | Resumo de Dispositivos do Office |
| OfficeDocumentMetric | Métricas de documentos do Office |
| OfficeDocumentSolution | Solução para Documentos do Office |
| OfficeMacroError | Erro de Macro do Office |
| OfficeProductInfo | Informações de Produto do Office |
| OfficeVbaRuleViolation | Violação da Regra do Office Vba |
| OfficeVbaSummary | Resumo da análise do VBA do Office |
| OperatingSystem | Sistema operacional |
| OperatingSystemEx | Sistema Operativo Ex |
| OperatingSystemRecoveryConfiguration | Configuração de Recuperação do Sistema Operativo |
| OptionalFeature | Funcionalidade Opcional |
| SO | Informações básicas sobre o sistema operativo |
| PageFileSetting | Definição de Ficheiro de Página |
| ParallelPort | Porta Paralela |
| Partition | Partições de Disco |
| PCMCIAController | Controlador PCMCIA |
| PhysicalDisk | PhysicalDisk |
| PhysicalMemory | Memória Física |
| PNPDEVICEDRIVER | Controlador de Dispositivo PNP |
| PointingDevice | Dispositivo Apontador |
| PortableBattery | Bateria Portátil |
| Portas | Portas |
| PowerCapabilities | Capacidades de Energia |
| PowerClientOptOutSettings | Definições de Exclusão da Gestão de Energia |
| PowerConfigurations | Configuração de Energia |
| PowerManagementDaily | Dados Diários do Power Management |
| PowerManagementInsomniaReasons | Motivos para a Insónia no Poder |
| PowerManagementMonthly | Dados Mensais do Power Management |
| PowerSettings | Definições de Energia |
| PrinterConfiguration | Configuração da Impressora |
| PrinterDevice | Dispositivo de Impressora |
| PrintJobs | Tarefas de Impressão |
| Processo | Um processo num sistema operativo |
| ProcessModule() | Módulos carregados por processos especificados |
| Processador | Processador |
| ProtectedVolumeInformation | Informações de Volume Protegido |
| Protocolo | Protocolo |
| QuickFixEngineering | Engenharia de Correções Rápidas |
| Registro | Todos os valores de uma chave de registo específica A partir da versão 2107, o Valor da chave foi adicionado à entidade Registry() |
| SCSIController | Controlador SCSI |
| SerialPortConfiguration | Configuração da Porta de Série |
| SerialPorts | Portas de Série |
| ServerFeature | Funcionalidade de Servidor |
| Serviço | Um serviço num sistema informático com o Windows |
| Serviços | Serviços |
| Partilhas | Partilhas |
| SMBConfig | Configuração SMB de um dispositivo |
| SMSAdvancedClientPorts | Portas de Cliente do Configuration Manager |
| SMSAdvancedClientSSLConfigurations | Configurações de SSL do Cliente do Configuration Manager |
| SMSAdvancedClientState | Estado do Cliente do Configuration Manager |
| SMSDefaultBrowser | Browser Predefinido |
| SMSSoftwareTag | Etiqueta de Software |
| SMSWindows8Application | Aplicação Do Windows |
| SMSWindows8ApplicationUserInfo | Informações de Utilizador da aplicação Windows |
| SoftwareShortcut | Atalho de Software |
| SoftwareUpdate | Uma atualização de software aplicável, mas não instalada no dispositivo |
| Dispositivos Sonoros | Dispositivos de Som |
| SWLicensingProduct | Produto de Licenciamento de Software |
| SWLicensingService | Serviço de Licenciamento de Software |
| SystemAccount | Conta de Sistema |
| SystemBootData | Dados de Arranque do Sistema |
| SystemBootSummary | Resumo do Arranque do Sistema |
| SystemConsoleUsage | Utilização da Consola do Sistema |
| SystemConsoleUser | Utilizador da Consola do Sistema |
| SystemDevices | Dispositivos de Sistema |
| SystemDrivers | Controladores de Sistema |
| SystemEnclosure | Bastidor do Sistema |
| TapeDrive | Unidade de Banda |
| TimeZone | Fuso Horário |
| TPM | TPM |
| TPMStatus | Estado do TPM |
| TSIssuedLicense | Licença Emitida do TS |
| TSLicenseKeyPack | Pacote de Chaves de Licença do TS |
| UninterruptiblePowerSupply | Fonte de Alimentação Ininterrupta |
| USBController | Controlador USB |
| USBDevice | Dispositivo USB |
| Usuário | Uma conta de utilizador com uma ligação ativa ao dispositivo |
| USMFolderRedirectionHealth | Estado de Funcionamento do Redirecionamento de Pastas |
| USMUserProfile | Estado de Funcionamento do Perfil de Utilizador |
| VideoController | Controlador de Vídeo |
| VirtualMachine | Máquina Virtual |
| VirtualMachine64 | Máquina Virtual (64) |
| Volume | Volume |
| WindowsUpdate | Windows Update |
| WindowsUpdateAgentVersion | Versão do Agente do Windows Update |
| WinEvent() | Eventos dentro de 24 horas (por predefinição) a partir de um registo de eventos do Windows |
| WriteFilterState | Estado do Filtro de Escrita |
Operadores de tabela
Os operadores de tabela podem ser utilizados para filtrar, resumir e transformar fluxos de dados. Atualmente, são suportados os seguintes operadores:
| Operadores de tabela | Descrição |
|---|---|
| count | Devolve uma tabela com um único registo que contém o número de registos |
| distinct | Produz uma tabela com a combinação distinta das colunas fornecidas da tabela de entrada |
| participar | Intercalar as linhas de duas tabelas para formar uma nova tabela ao corresponder a linha para o mesmo dispositivo |
| ordenar por | Ordenar as linhas da tabela de entrada por uma ou mais colunas |
| projeto | Selecione as colunas a incluir, mudar o nome ou largar e inserir novas colunas calculadas |
| tomar | Regressar ao número especificado de linhas |
| top | Devolve os primeiros N registos ordenados pelas colunas especificadas |
| em que | Filtra uma tabela para o subconjunto de linhas que satisfazem um predicado |
Operadores Escalares
A tabela seguinte resume os operadores:
| Operadores | Descrição | Exemplo |
|---|---|---|
| == | Igual a | 1 == 1, 'aBc' == 'AbC' |
| != | Não Igual | 1 != 2, 'abc' != 'abcd' |
| < | Menos | 1 < 2, 'abc' < 'DEF' |
| > | Maior | 2 > 1, 'xyz' > 'XYZ' |
| <= | Menor ou Igual | 1 <= 2, 'abc' <= 'abc' |
| >= | Maior ou Igual | 2 >= 1, 'abc' >= 'ABC' |
| + | Adicionar | 2 + 1, now() + 1d |
| - | Subtrair | 2 - 1, now() - 1h |
| * | Multiplicar | 2 * 2 |
| / | Dividir | 2 / 1 |
| % | Modulo | 2 % 1 |
| como | O Lado Esquerdo (LHS) contém uma correspondência para o Lado Direito (RHS) | 'abc' like '%B%' |
| !like | O LHS não contém uma correspondência para RHS | 'abc' !like '_d_' |
| contains | O RHS ocorre como uma subsecção do LHS | 'abc' contains 'b' |
| !contém | O RHS não ocorre no LHS | 'team' !contains 'i' |
| startswith | O RHS é uma subsecção inicial do LHS | 'team' startswith 'tea' |
| !começacom | O RHS não é uma subsecção inicial do LHS | 'abc' !startswith 'bc' |
| endswith | O RHS é uma subsecção de fecho do LHS | 'abc' endswith 'bc' |
| !terminacom | O RHS não é uma subsecção de fecho do LHS | 'abc' !endswith 'a' |
| e | Verdadeiro se e apenas se RHS e LHS forem verdadeiros | (1 == 1) and (2 == 2) |
| ou | Verdadeiro se e apenas se RHS ou LHS for verdadeiro | (1 == 1) or (1 == 2) |
Funções de agregação
As funções de agregação podem ser utilizadas com o operador resumir tabela para calcular valores resumidos. Atualmente, são suportadas as seguintes funções de agregação:
| Função | Descrição |
|---|---|
| avg() | Devolve a média dos valores em todo o grupo |
| count() | Devolve uma contagem dos registos por grupo de resumo |
| countif() | Devolve uma contagem de linhas para as quais Predicado é avaliado como verdadeiro |
| dcount() | Devolve o número de valores distintos no grupo |
| max() | Devolve o valor máximo em todo o grupo |
| maxif() | A partir da versão 2107, pode utilizar maxif com o operador resumir tabela.
Devolve o valor máximo em todo o grupo para o qual Predicado avalia como true. |
| min() | Devolve o valor mínimo em todo o grupo |
| minif() | A partir da versão 2107, pode utilizar minif com o operador resumir tabela.
Devolve o valor mínimo no grupo para o qual Predicado é avaliado como true. |
| percentil() | Devolve uma estimativa para o percentil de classificação mais próximo especificado da população definida por Expr |
| sum() | Devolve a soma dos valores em todo o grupo |
| sumif() | Devolve uma soma de Expr para a qual Predicado avalia como verdadeiro |
Funções escalares
As funções escalares podem ser utilizadas em expressões. Atualmente, são suportadas as seguintes funções escalares:
| Função | Descrição |
|---|---|
| ago() | Subtrai o período de tempo especificado à hora atual do relógio UTC |
| bin() | Arredonda os valores para um número de datetime múltiplos de um determinado tamanho de discretização |
| case() | Avalia uma lista de predicados e devolve a primeira expressão de resultado cujo predicado é satisfeito |
| datetime_add() | Calcula um novo datetime a partir de uma parte de data especificada multiplicada por uma quantidade especificada, adicionada a um datetime especificado |
| datetime_diff() | Calcula a diferença entre dois valores de data/hora |
| iif() | Avalia o primeiro argumento e devolve o valor do segundo ou terceiro argumentos consoante o predicado avaliado como verdadeiro (segundo) ou falso (terceiro) |
| indexof() | A função comunica o índice baseado em zero da primeira ocorrência de uma cadeia especificada na cadeia de entrada |
| isnotnull() | Avalia o seu único argumento e devolve um valor Booleano que indica se o argumento é avaliado como um valor não nulo |
| isull() | Avalia o seu único argumento e devolve um valor Booleano que indica se o argumento é avaliado como um valor nulo |
| now() | Devolve a hora atual do relógio UTC |
| strcat() | Concatena entre 1 e 64 argumentos |
| strlen() | Devolve o comprimento, em carateres, da cadeia de entrada |
| subcadeia() | Extrai uma subcadeia de uma cadeia de origem a partir de um índice para o fim da cadeia |
| tostring() | Converte a entrada numa representação de cadeia |
Entidades, operadores e funções adicionais para CMPivot a partir do Configuration Manager
Importante
Estes itens não são suportados quando executa o CMPivot a partir do centro de administração do Microsoft Intune.
| Tipo | Item | Descrição |
|---|---|---|
| Entidade | AccountSID | SID da Conta |
| Entidade | FileContent() | Conteúdo de um ficheiro específico |
| Entidade | NAPClient | Cliente NAP |
| Entidade | NAPSystemHealthAgent | Agente do Estado de Funcionamento do Sistema NAP |
| Entidade | RegistryKey() | Devolve todas as chaves de registo correspondentes à expressão especificada (a partir da versão 2107) |
| Operador de tabela | render | Compõe os resultados como saída gráfica |
Próximas etapas
Para obter mais informações, veja Launch CMPivot from the admin center (Iniciar o CMPivot a partir do centro de administração ) Para obter mais scripts de exemplo, veja Microsoft Intune tenant attach: CMPivot script samples (Anexação do inquilino do Microsoft Intune: exemplos de script CMPivot).