--- sourceDocument: Xanadu IT Operations Management sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/it-operations-management Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Xanadu IT Operations Management ft:clusterId : - itom bundleId : - itom workflow : - Technology --- # Probe CIM # Probe CIM {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 min. de leitura O probe CIM usa protocolos WBEM para consultar um servidor CIM específico, o CIM Object Manager, em busca de um conjunto de objetos de dados e propriedades. {#r_CIMProbe__ph_cim-probe-intro} Para obter instruções sobre como configurar parâmetros de probe, consulte [Definir parâmetros de probe](https://servicenow-prod.fluidtopics.net/J0RA~MTgeoq6ZHmkNhySVw "Use parâmetros de probe para controlar o comportamento de um probe específico sempre que ele for acionado."). Os seguintes parâmetros podem ser passados para o probe CIM: {#r_CIMProbe__table_s1j_w2v_m4__entry__3} | Parâmetro | Descrição | Valor padrão | |-|-|-| | origem | \[Obrigatório\] O host inicial ao qual se conectar. | Nenhum(a) | | porta | A porta à qual se conectar. Se estiver vazio, o valor será determinado pelo parâmetro "schema": http = 5988, https = 5989. | 5988 ou 5989 | | esquema | \[Obrigatório\] O esquema a ser usado: '"http"' ou '"https"'. | http | | namespace | \[Obrigatório\] O namespace CIM. Pode ser substituído por uma consulta. | Nenhum(a) | | consultas | \[Obrigatório\] Uma lista delimitada por ponto e vírgula de consultas de probe CIM para processar e retornar resultados. | Nenhum(a) | | novas tentativas | O número de vezes para tentar novamente uma consulta se ela falhar devido a problemas de conectividade de rede. | 2 | | connection_timeout | O número de milissegundos que o probe tem para se conectar a um servidor. | 5000 | | soquete_timeout | O número de milissegundos que o probe tem para ler dados. | 5000 | [Tabela 1. Probe CIM] {#r_CIMProbe__table_s1j_w2v_m4} A linguagem de consulta intermediária CIM (CimIQL) usa chaves, filtros e referência com pontos para percorrer o esquema CIM. ## Expansão de parâmetro {#r_CIMProbe__section_mvx_ncg_dcb} A linguagem de consulta CIM oferece suporte à expansão de parâmetro de probe pré-processada SNC padrão. Coloque variáveis em consultas encapsulando seus nomes como este: ${foobar}.CIM_RunningOS[0].Name CIM_ComputerSystem.${barfoo} O texto ${foobar} é substituído pelo conteúdo do parâmetro foobarprobe passado para o probe CIM; da mesma forma para barfoo. ## CIMIQL {#r_CIMProbe__section_wyd_pcg_dcb} A CIM Intermediate Query Language (CimIQL) é uma linguagem intermediária projetada para simplificar o processo de consulta de provedores de CIM. {#r_CIMProbe__ph_cim-query-lang-intro} No momento, o CimIQL oferece suporte à pilha de protocolos padrão do Web-Based Enterprise Management (WBEM), mas outros, como o Web Services-Management (WS-MAN), podem ser adicionados no futuro. A sintaxe da linguagem de consulta é emprestada de elementos da linguagem de consulta WMI de MicrosoftUNIXe do comando wbemcli de \[\]. A biblioteca CimIQL é uma implementação Java pura.{#r_CIMProbe__p_cimiql-content} Nota: Pronuncia-se CimIQL "simicle". ## Sintaxe do CimIQL {#ariaid-title2} A sintaxe da CimIQL consiste em vários elementos, incluindo uma consulta e diferentes tokens. {#r_CimIQLSyntax__table_drq_3vc_lp__entry__2} | Elemento | Descrição | |-|-| | Declaração | O elemento mais básico da CimIQL é uma válida. Uma declaração contém várias consultas delimitadas por um ponto. caractere. | | Consulta | Uma representa uma única solicitação independente de protocolo de alto nível. Cada consulta é composta por componentes de linguagem aninhados e subcomponentes conhecidos como tokens. | | Token | Um descreve um aspecto lexical específico da sintaxe da CimIQL. | | [Token de operação](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens "O probe CimIQL requer tokens de operação.") | O primeiro token de cada consulta deve ser um , que representa a operação lógica geral a ser executada. | | [Token do componente](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens "O probe CimIQL requer tokens de componente, que são subcomponentes de tokens operacionais.") | Um é um subcomponente de um token de operação. | | Resultado | Cada consulta é emparelhada com um resultado, que é fornecido como entrada para a próxima consulta na declaração. Um é composto por um conjunto de objetos e suas propriedades. | [Tabela 2. Descrições do elemento de sintaxe da CimIQL] {#r_CimIQLSyntax__table_drq_3vc_lp} ## Tokens de operação CimIQL {#ariaid-title3} O probe CimIQL requer tokens de operação. Cada uma das seguintes operações principais tem uma contraparte no padrão [Operações CIM sobre HTTP](http://www.dmtf.org/sites/default/files/standards/documents/DSP0200_1.3.1.pdf). {#r_CimIQLOperationTokens__table_rk1_jzc_lp__entry__3} | Retornar Valor | Detalhes | Operação CIM equivalente sobre HTTP | |-|-|-| | objeto de classe | [Obter objeto](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens__GetObjectToken) Recupera um único objeto de uma classe específica especificando todas as suas chaves exclusivas (como [tokens de chave](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__KeyToken)) e quaisquer [tokens de parâmetro](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__ParameterToken)opcionais, separados por vírgulas. | Obter instância | | objeto de classe | [Enumerar objetos](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens__EnumerateObjectsToken) Recupera objetos que correspondem a um conjunto de [tokens de condição](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__ConditionToken) e de [parâmetro](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__ParameterToken). | Enumerar instâncias | | objeto de classe | [Enumerar objetos associados](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken) Recupera objetos associados a cada resultado da consulta anterior. | Associadores | | resultados da declaração | [Substituição](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens__SubstitutionToken) Um token não operacional que alimenta os resultados de uma declaração nomeada anterior como entrada na próxima consulta de sua própria declaração. | Referenciar os resultados de uma declaração nomeada | [Tabela 3. Resumo do token de operação da CimIQL] {#r_CimIQLOperationTokens__table_rk1_jzc_lp} ### Obter token do objeto \{\ ,\ ,...} * Recupera um único objeto de uma classe específica especificando todas as suas chaves exclusivas (como tokens de[chave](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__KeyToken)tokens de chave ) e quaisquer [tokens de parâmetro](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__ParameterToken)opcionais, separados por vírgulas. Este token também é conhecido como . * O\ é o nome da classe CIM que diferencia maiúsculas de minúsculas do objeto desejado. Por padrão, os objetos da classe especificada e de quaisquer classes estendidas são recuperados. * Os tokens de chave e de parâmetro são delimitados por um único par de chaves { ... }. * Este token só deve ser usado como a primeira consulta em uma declaração. * Retorna: objeto de classe * Exemplo: CIM_ComputerSystem{CreationClassName='Linux_ComputerSystem',Name='runtime'}.* {#r_CimIQLOperationTokens__ul_ibd_vcd_lp} ### Enumerar token de objetos \{{\ ,\ ,...}}\ OU * Recupera objetos que correspondem a um conjunto de [tokens de condição](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__ConditionToken) e de [parâmetro](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__ParameterToken). Este token também é conhecido como o . * Os tokens de condição e os tokens de parâmetro são colocados entre dois pares de chaves {{ ... }}. Os colchetes são opcionais se não houver condições ou parâmetros necessários. * O\ é o nome da classe CIM que diferencia maiúsculas de minúsculas dos objetos desejados. Por padrão, os objetos da classe especificada e de quaisquer classes estendidas são recuperados. * O [token de índice](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__IndexToken) é opcional. * Este token só deve ser usado como a primeira consulta em uma declaração. * Retorna: objeto de classe * Exemplo: CIM_ComputerSystem{{Name!='runtime'}}.* {#r_CimIQLOperationTokens__ul_rlm_zdd_lp} ### Enumerar token de objetos associados \{{\ ,\ ,...}}\ OU * Recupera objetos associados a cada resultado da consulta anterior. * Os tokens de [condição e os tokens](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__ConditionToken) de [parâmetro](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__ParameterToken) são colocados entre dois pares de chaves {{ ... }}. Os colchetes são opcionais se não houver filtros de propriedades ou parâmetros necessários. * O\ é o nome da classe many-to-many ou one-to-many que associa dois objetos. Por padrão, os objetos da classe especificada e de quaisquer classes estendidas são recuperados. * O\ , ResultClass, pode ser especificado para filtrar resultados com base no nome da classe do objeto resultante. * O [token de índice](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__IndexToken) é opcional. * Este token não deve ser usado como a primeira consulta em uma declaração. * Retorna: objeto de classe * Exemplo: CIM_ComputerSystem{{Name='runtime'}}[2].* {#r_CimIQLOperationTokens__ul_c1c_p2d_lp} ### Token de substituição ${\ } * Um token não operacional que alimenta os resultados de uma declaração nomeada anterior como entrada na próxima consulta de sua própria declaração. * Retorna: vazio * Exemplo: $(lastComputer).ElementName {#r_CimIQLOperationTokens__ul_fz3_tgd_lp} ## Tokens do componente CimIQL {#ariaid-title4} O probe CimIQL requer tokens de componente, que são subcomponentes de tokens operacionais. Os tokens a seguir são subcomponentes dos [tokens de operação](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens "O probe CimIQL requer tokens de operação.").{#r_CimIQLComponentTokens__table_rk1_jzc_lp__entry__2} | Token | Detalhes | |-|-| | Token de propriedades | \* OU\ , ,... Especifica quais propriedades devem ser retornadas para cada objeto do conjunto de resultados final. | | Token do delimitador de de consulta | . (Período) Separa consultas. | | Token Token de índice | \[índice\] Reduz os resultados de uma consulta anterior a um único objeto no índice inteiro especificado. | | Token de Token de chave | \='\ ' Corresponde a uma propriedade de objeto designada como uma chave pelo valor exato. | | Token Token de condição | \\\ Corresponde a uma única propriedade de um objeto com base na condição especificada. | | Token Token de parâmetro | \:'\ ' Passa um parâmetro até\ à operação que está sendo chamada. O parâmetro pode ser consumido durante o pré-processamento do CimIQL ou pelo CIMOM por meio de solicitação, dependendo do parâmetro. | [Tabela 4. Resumo do token do componente CimIQL] {#r_CimIQLComponentTokens__table_rk1_jzc_lp} ### Token de propriedades \* OU\ , ,... * Especifica quais propriedades devem ser retornadas para cada objeto do conjunto de resultados final. * O curinga \* retorna todas as propriedades disponíveis. Caso contrário, cada nome de propriedade desejado será fornecido em uma lista separada por vírgulas. * Este token é necessário no final de cada declaração. * Exemplo: CIM_ComputerSystem[0].* {#r_CimIQLComponentTokens__ul_kt1_pkd_lp} ### Token do delimitador de consulta . (Período) * Separa consultas. * Exemplo: CIM_ComputerSystem.PrimaryOwnerContact ### Token de índice \[índice\] * Reduz os resultados de uma consulta anterior a um único objeto no índice inteiro especificado. * Este token é sempre opcional. * Exemplo: CIM_ComputerSystem[0].* {#r_CimIQLComponentTokens__ul_tkg_1ld_lp} ### Token de chave \='\ ' * Corresponde a uma propriedade de objeto designada como uma chave pelo valor exato. * O\ é o nome da propriedade usada como uma chave. * Exemplo: CIM_ComputerSystem{CreationClassName='Linux_ComputerSystem',Name='runtime'}.* {#r_CimIQLComponentTokens__ul_mw1_tld_lp} ### Token de condição \\\ * Corresponde a uma única propriedade de um objeto com base na condição especificada. * O\ é o nome da propriedade a ser correspondida. * O\ determina como o valor real da propriedade é comparado ao valor esperado. Os operadores disponíveis são igualdade (=) e inequação (!=). * O\ deve ser um dos seguintes: * Valor literal entre aspas simples ' ... '. Por exemplo, foo='bar' * Expressão regular, entre barras / ... /. Por exemplo, foo=/bar.\*/ {#r_CimIQLComponentTokens__ul_hpg_zld_lp} * Exemplo: CIM_ComputerSystem{{Name!='runtime'}}.* {#r_CimIQLComponentTokens__ul_lv3_yld_lp} ### Token de Parâmetro \:'\ ' * Passa um parâmetro até\ à operação que está sendo chamada. O parâmetro pode ser consumido durante o pré-processamento do CimIQL ou pelo CIMOM (Common Information Model Object Manager) por meio de solicitação, dependendo do parâmetro. * Exemplo: CIM_ComputerSystem.CIM_RunningOS{{ResultClass:'Win32_ComputerSystem'}}.* {#r_CimIQLComponentTokens__ul_i4g_mmd_lp} ## Tutorial do CimIQL {#ariaid-title5} Este é um tutorial por exemplo em que cada exemplo se baseia no exemplo anterior. {#r_CimIQLTutorial__table_e4t_35d_lp__entry__3} | Ordem | Instrução CimIQL | Resultado | |-|-|-| | 1 | CIM_ComputerSystem\[0\].\* | Recupera o [primeiro resultado](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__IndexToken) de todas as instâncias de CIM_ComputerSystem e seus descendentes. Recupera todas as [propriedades](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__PropertiesToken). | | 2 | CIM_ComputerSystem.PrimaryOwnerContact | Recupera todas as instâncias de CIM_ComputerSystem e seus descendentes. Recupera apenas uma [propriedade](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__PropertiesToken), PrimaryOwnerContact. | | 3 | CIM_ComputerSystem{CreationClassName='Linux_ComputerSystem',Name='runtime'}.\* | Recupera uma única instância exclusiva de CIM_ComputerSystem e seus descendentes. Todos [os tokens de chave](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__KeyToken) devem ser especificados no [token de identidade](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens__GetObjectToken){ } . | | 4 | CIM_ComputerSystem{{Name!='runtime'}}.\* | Recupera todas as instâncias e descendentes de CIM_ComputerSystem que não têm uma [propriedade](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__PropertiesToken) Nome de "tempo de execução". O [token de filtro](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens__EnumerateObjectsToken) {{ }} filtra instâncias que não contêm todas as propriedades/chaves especificadas. | | 5 | CIM_ComputerSystem{{Name=/\^run.\*$/}.\* | Recupera todas as instâncias e descendentes de CIM_ComputerSystem que têm um valor correspondente à expressão regular contida nos caracteres / /. Nota: A expressão regular não requer aspas simples. O [token de filtro](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens__EnumerateObjectsToken) {{ }} filtra instâncias que não contêm todas as propriedades/chaves especificadas. | | 6 | CIM_ComputerSystem{{Name='runtime'}}\[2\].\* | Recupera o [segundo resultado](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken) de todas as instâncias de CIM_ComputerSystem e seus descendentes [em que](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens__EnumerateObjectsToken) as instâncias têm uma propriedade Nome de "tempo de execução". A ordem de operações segue a sintaxe da consulta. 1. Servidor de[consulta](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens__GetObjectToken) para todos os CIM_ComputerSystem e descendentes. 2. [Filtrar](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens__EnumerateObjectsToken) resultados com base na propriedade Nome. 3. [Recupere a segunda](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken) instância que passou no filtro. {#r_CimIQLTutorial__ol_x1l_zxd_lp} | | 7 | CIM_ComputerSystem.CIM_RunningOS\[0\].Nome | Recupera a [propriedade](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__PropertiesToken) Nome da primeira instância CIM_OperatingSystem de cada instância CIM_ComputerSystem. O token do meio, CIM_RunningOS, é o nome da [classe do Associador](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken), não o resultado final. | | 8 | CIM_ComputerSystem.CIM_RunningOS{{Nome=/CentOS{}}\[0\].Nome | Recupera a [propriedade](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLComponentTokens__PropertiesToken) Nome da primeira instância CIM_OperatingSystem de cada instância CIM_ComputerSystem, [em que](https://servicenow-prod.fluidtopics.net/UnkHXDK7mLQqGTHChjCrJA#r_CimIQLOperationTokens__EnumerateObjectsToken) cada instância CIM_OperatingSystem tem uma propriedade Nome que contém "CentOS". | [Tabela 5. Tutorial da CimIQL] {#r_CimIQLTutorial__table_e4t_35d_lp} ## Resultados da CimIQL {#ariaid-title6} Os resultados da Probe CIM são passados para o sensor da probe como um documento XML incorporado ao elemento \. A seguir está um exemplo comentado de um resultado em lote de CimQuery. CIM_ComputerSystem[0].PrimaryOwnerContact <_classname>Linux_ComputerSystem <_key>