--- sourceDocument: Gestion des opérations IT Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/it-operations-management Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Gestion des opérations IT Xanadu ft:clusterId : - itom bundleId : - itom workflow : - Technology --- # Sonde CIM # Sonde CIM {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 minutes de lecture La sonde CIM utilise des protocoles WBEM pour interroger un serveur CIM particulier (le gestionnaire d'objets CIM) pour un ensemble d'objets et de propriétés de données. {#r_CIMProbe__ph_cim-probe-intro} Pour obtenir des instructions sur la configuration des paramètres de sonde, consultez [Configurer les paramètres de sonde](https://servicenow-prod.fluidtopics.net/wZkXxBFZR_Tkn6gBkzSd7Q "Utilisez les paramètres de sonde pour contrôler le comportement d'une sonde spécifique chaque fois qu'elle est déclenchée."). Les paramètres suivants peuvent être transmis à la sonde CIM : {#r_CIMProbe__table_s1j_w2v_m4__entry__3} | Paramètre | Description | Valeur par défaut | |-|-|-| | source | \[Requis\] Hôte initial auquel se connecter. | Aucun | | port | Port auquel se connecter. Si ce champ est vide, la valeur est déterminée par le paramètre \<\< schema \>\> : http = 5988, https = 5989. | 5988 ou 5989 | | schema | \[Requis\] Schéma à utiliser : \<\< http \>\> ou \<\< https \>\>. | http | | namespace | \[Requis\] Espace de noms CIM. Peut être remplacé par une requête. | Aucun | | queries | \[Requis\] Liste de requêtes de sonde CIM délimitée par des points-virgules pour traiter et renvoyer les résultats. | Aucun | | retries | Nombre de nouvelles tentatives si une requête échoue en raison de problèmes de connectivité réseau. | 2 | | connection_timeout | Délai de connexion de la sonde à un serveur, en millisecondes. | 5000 | | socket_timeout | Délai de lecture de données de la part de la sonde, en millisecondes. | 5000 | [Tableau 1. Sonde CIM] {#r_CIMProbe__table_s1j_w2v_m4} Le langage CimIQL (CIM Intermediate Query Language) utilise des clés, des filtres et des remontées pas-à-pas pour parcourir le schéma CIM. ## Expansion des paramètres {#r_CIMProbe__section_mvx_ncg_dcb} Le langage de requête CIM prend en charge l'extension du paramètre de sonde prétraitée SNC standard. Placez les variables dans les requêtes en encapsulant leurs noms comme suit : ${foobar}.CIM_RunningOS[0].Name CIM_ComputerSystem.${barfoo} Le texte ${foobar} est remplacé par le contenu du paramètre foobarprobe transmis à la sonde CIM ; idem pour barfoo. ## CIMIQL {#r_CIMProbe__section_wyd_pcg_dcb} CimIQL (CIM Intermediate Query Language) est un langage intermédiaire conçu pour simplifier le processus d'interrogation des fournisseurs CIM. {#r_CIMProbe__ph_cim-query-lang-intro} CimIQL prend actuellement en charge la pile de protocoles WBEM (Web-Based Enterprise Management) standard, mais d'autres piles, telles que WS-MAN (Web Services-Management), peuvent être ajoutées ultérieurement. La syntaxe du langage de requête emprunté des éléments du langage de requête WMI de Microsoft et de la commande wbemcli de UNIX. La bibliothèque CimIQL est une implémentation Java pure.{#r_CIMProbe__p_cimiql-content} Remarque : CimIQL se prononce comme suit : \<\< simicle \>\>. ## Syntaxe CimIQL {#ariaid-title2} La syntaxe CimIQL se compose de plusieurs éléments, notamment d'une requête et de différents jetons. {#r_CimIQLSyntax__table_drq_3vc_lp__entry__2} | Élément | Description | |-|-| | Instruction | L'élément le plus élémentaire de CimIQL est une valide . Une instruction contient plusieurs requêtes délimitées par un point (.). | | Requête | Une représente une requête unique de haut niveau, indépendante du protocole. Chaque requête est constituée de composants de langage imbriqués et de sous-composants appelés jetons. | | Jeton | Un décrit un aspect lexical spécifique de la syntaxe CimIQL. | | [Jeton d'opération](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens "La sonde CimIQL nécessite des jetons d'opération.") | Le premier jeton de chaque requête doit être un , qui représente l'opération logique globale à effectuer. | | [Jeton de composant](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens "La sonde CimIQL nécessite des jetons de composant, qui sont des sous-composants de jetons opérationnels.") | Un est un sous-composant d'un jeton d'opération. | | Résultat | Chaque requête est associée à un résultat, qui est ensuite fourni comme entrée à la requête suivante dans l'instruction. Un est composé d'un ensemble d'objets et de leurs propriétés. | [Tableau 2. Descriptions des éléments de la syntaxe CimIQL] {#r_CimIQLSyntax__table_drq_3vc_lp} ## Jetons d'opération CimIQL {#ariaid-title3} La sonde CimIQL nécessite des jetons d'opération. Chacune des opérations principales suivantes a une contrepartie dans les [Opérations CIM via HTTP](http://www.dmtf.org/sites/default/files/standards/documents/DSP0200_1.3.1.pdf) standard. {#r_CimIQLOperationTokens__table_rk1_jzc_lp__entry__3} | Valeur de retour | Détails | Opération CIM via HTTP équivalente | |-|-|-| | objet de classe | [Obtenir un objet](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens__GetObjectToken) Récupère un objet unique d'une classe spécifique en spécifiant toutes ses clés uniques (en tant que [jetons de clé](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__KeyToken)) et tous les [jetons de paramètres](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__ParameterToken) facultatifs, séparés par des virgules. | GetInstance | | objet de classe | [Énumérer les objets](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens__EnumerateObjectsToken) Récupère les objets qui correspondent à un ensemble de [jetons de condition](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__ConditionToken) et [de jetons de paramètre](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__ParameterToken). | EnumerateInstances | | objet de classe | [Énumérer les objets associés](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken) Récupère les objets associés à chaque résultat de la requête précédente. | Associateurs | | résultats d'instruction | [Substitution](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens__SubstitutionToken) Jeton sans opération qui alimente les résultats d'une instruction nommée précédente comme entrée dans la requête suivante de sa propre instruction. | Référencer les résultats d'une instruction nommée | [Tableau 3. Récapitulatif des jetons d'opération CimIQL] {#r_CimIQLOperationTokens__table_rk1_jzc_lp} ### Obtenir le jeton d'objet \{\,\,...} * Récupère un objet unique d'une classe spécifique en spécifiant toutes ses clés uniques (en tant que jetons de clé[jetons de clé](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__KeyToken)) et tous les [jetons de paramètre](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__ParameterToken) facultatifs, séparés par des virgules. Ce jeton est également connu sous le nom de . * \ correspond au nom de classe CIM sensible à la casse de l'objet souhaité. Par défaut, les objets de la classe spécifiée et de toutes les classes étendues sont récupérés. * Les jetons de clé et de paramètre sont entourés d'une paire d'accolades { ... }. * Ce jeton ne doit être utilisé que comme première requête dans une instruction. * Renvoie : objet de classe * Exemple : CIM_ComputerSystem{CreationClassName='Linux_ComputerSystem',Name='runtime'}.* {#r_CimIQLOperationTokens__ul_ibd_vcd_lp} ### Énumérer les jetons d'objet \{{\,\,...}}\ OU \\ * Récupère les objets qui correspondent à un ensemble de [jetons de condition](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__ConditionToken) et [de jetons de paramètre](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__ParameterToken). Ce jeton est également connu sous le nom de . * Les jetons de condition et de paramètre sont entourés de deux paires d'accolades {{ ... }}. Les accolades sont facultatives si aucune condition ou aucun paramètre n'est nécessaire. * \ correspond au nom de classe CIM sensible à la casse des objets souhaités. Par défaut, les objets de la classe spécifiée et de toutes les classes étendues sont récupérés. * Le [jeton d'index](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__IndexToken) est facultatif. * Ce jeton ne doit être utilisé que comme première requête dans une instruction. * Renvoie : objet de classe * Exemple : CIM_ComputerSystem{{Name!='runtime'}}.* {#r_CimIQLOperationTokens__ul_rlm_zdd_lp} ### Énumérer les jetons d'objet associés \{{\,\,...}}\ OU \\ * Récupère les objets associés à chaque résultat de la requête précédente. * Les [jetons de condition](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__ConditionToken) et les [jetons de paramètre](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__ParameterToken) sont entourés de deux paires d'accolades {{ ... }}. Les accolades sont facultatives si aucun filtre de propriété ou aucun paramètre n'est nécessaire. * \ correspond au nom de la classe plusieurs à plusieurs ou un à plusieurs qui associe deux objets ensemble. Par défaut, les objets de la classe spécifiée et de toutes les classes étendues sont récupérés. * Le jeton de paramètre, ResultClass, peut être spécifié pour filtrer les résultats en fonction du nom de classe de l'objet résultant. * Le [jeton d'index](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__IndexToken) est facultatif. * Ce jeton ne doit pas être utilisé comme première requête dans une instruction. * Renvoie : objet de classe * Exemple : CIM_ComputerSystem{{Name='runtime'}}[2].* {#r_CimIQLOperationTokens__ul_c1c_p2d_lp} ### Jeton de substitution ${\} * Jeton sans opération qui alimente les résultats d'une instruction nommée précédente comme entrée dans la requête suivante de sa propre instruction. * Renvoie : nul * Exemple : $(lastComputer).ElementName {#r_CimIQLOperationTokens__ul_fz3_tgd_lp} ## Jetons de composant CimIQL {#ariaid-title4} La sonde CimIQL nécessite des jetons de composant, qui sont des sous-composants de jetons opérationnels. Les jetons suivants sont des sous-composants des [jetons d'opération](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens "La sonde CimIQL nécessite des jetons d'opération.").{#r_CimIQLComponentTokens__table_rk1_jzc_lp__entry__2} | Jeton | Détails | |-|-| | Jeton de propriétés | \* OU \,\,... Spécifie les propriétés à renvoyer pour chaque objet de l'ensemble de résultats final. | | Jeton de délimiteur de | . (Point) Sépare les requêtes. | | Jeton | \[index\] Réduit les résultats d'une requête précédente à un seul objet sur l'index entier spécifié. | | Jeton de | \='\' Correspond à une propriété d'objet désignée comme clé par valeur exacte. | | Jeton de | \\\ Correspond à une propriété unique d'un objet en fonction de la condition spécifiée. | | Jeton de | \:'\' Transmet un paramètre par \ à l'opération appelée. Le paramètre peut être utilisé pendant le prétraitement CimIQL ou par le CIMOM via la demande, selon le paramètre. | [Tableau 4. Récapitulatif des jetons de composant CimIQL] {#r_CimIQLComponentTokens__table_rk1_jzc_lp} ### Jeton de propriétés \* OU \,\,... * Spécifie les propriétés à renvoyer pour chaque objet de l'ensemble de résultats final. * Le caractère générique \* renvoie toutes les propriétés disponibles. Sinon, chaque nom de propriété souhaité est fourni dans une liste séparée par des virgules. * Ce jeton est requis à la fin de chaque instruction. * Exemple : CIM_ComputerSystem[0].* {#r_CimIQLComponentTokens__ul_kt1_pkd_lp} ### Jeton de délimiteur de requête . (Point) * Sépare les requêtes. * Exemple : CIM_ComputerSystem.PrimaryOwnerContact ### Jeton d'index \[index\] * Réduit les résultats d'une requête précédente à un seul objet sur l'index entier spécifié. * Ce jeton est toujours facultatif. * Exemple : CIM_ComputerSystem[0].* {#r_CimIQLComponentTokens__ul_tkg_1ld_lp} ### Jeton de clé \='\' * Correspond à une propriété d'objet désignée comme clé par valeur exacte. * \ correspond au nom de la propriété utilisée comme clé. * Exemple : CIM_ComputerSystem{CreationClassName='Linux_ComputerSystem',Name='runtime'}.* {#r_CimIQLComponentTokens__ul_mw1_tld_lp} ### Jeton de condition \\\ * Correspond à une propriété unique d'un objet en fonction de la condition spécifiée. * \ correspond au nom de la propriété à mettre en correspondance. * \ détermine la façon dont la valeur réelle de la propriété est comparée à sa valeur attendue. Les opérateurs disponibles sont les suivants : égalité (=) et inégalité (!=). * \ doit être l'une des valeurs suivantes : * Valeur littérale entourée de guillemets simples ' ... '. Par exemple, foo='bar' * Expression régulière, entourée d'une paire de barres obliques /... /. Par exemple, foo=/bar.\*/ {#r_CimIQLComponentTokens__ul_hpg_zld_lp} * Exemple : CIM_ComputerSystem{{Name!='runtime'}}.* {#r_CimIQLComponentTokens__ul_lv3_yld_lp} ### Jeton de paramètre \:'\' * Transmet un paramètre par \ à l'opération appelée. Le paramètre peut être utilisé pendant le prétraitement CimIQL ou par le CIMOM (Common Information Model Object Manager) via la demande, selon le paramètre. * Exemple : CIM_ComputerSystem.CIM_RunningOS{{ResultClass:'Win32_ComputerSystem'}}.* {#r_CimIQLComponentTokens__ul_i4g_mmd_lp} ## Didacticiel CimIQL {#ariaid-title5} Il s'agit d'un didacticiel où chaque exemple s'appuie sur l'exemple précédent. {#r_CimIQLTutorial__table_e4t_35d_lp__entry__3} | Ordre | Instruction CimIQL | Résultat | |-|-|-| | 1 | CIM_ComputerSystem\[0\].\* | Récupère le [premier résultat](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__IndexToken) de toutes les instances de CIM_ComputerSystem et de ses descendants. Récupère toutes les [propriétés](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__PropertiesToken). | | 2 | CIM_ComputerSystem.PrimaryOwnerContact | Récupère toutes les instances de CIM_ComputerSystem et de ses descendants. Récupère une seule [propriété](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__PropertiesToken), PrimaryOwnerContact. | | 3 | CIM_ComputerSystem{CreationClassName='Linux_ComputerSystem',Name='runtime'}.\* | Récupère une instance unique de CIM_ComputerSystem et de ses descendants. Tous les [jetons de clé](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__KeyToken) doivent être spécifiés dans le { } [jeton d'identité](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens__GetObjectToken). | | 4 | CIM_ComputerSystem{{Name!='runtime'}}.\* | Récupère toutes les instances et tous les descendants de CIM_ComputerSystem dont le nom de [propriété](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__PropertiesToken) n'est pas \<\< runtime \>\>. Le [jeton de filtre](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens__EnumerateObjectsToken) {{ }} filtre les instances qui ne contiennent pas toutes les propriétés/clés spécifiées. | | 5 | CIM_ComputerSystem{{Name=/\^run.\*$/}}.\* | Récupère toutes les instances et tous les descendants de CIM_ComputerSystem qui ont une valeur correspondant à l'expression régulière contenue dans les caractères / /. Remarque : L'expression régulière ne nécessite pas l'utilisation de guillemets simples. Le [jeton de filtre](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens__EnumerateObjectsToken) {{ }} filtre les instances qui ne contiennent pas toutes les propriétés/clés spécifiées. | | 6 | CIM_ComputerSystem{{Name='runtime'}}\[2\].\* | Récupère le [second résultat](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken) de toutes les instances de CIM_ComputerSystem et de leurs descendants [dont](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens__EnumerateObjectsToken) le nom de propriété est \<\< runtime \>\>. L'ordre des opérations suit la syntaxe de la requête. 1. [Interrogez](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens__GetObjectToken) le serveur pour connaître tous les CIM_ComputerSystem et leurs descendants. 2. [Filtrez](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens__EnumerateObjectsToken) les résultats en fonction de la propriété Nom. 3. [Récupérez la deuxième](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken) instance qui a respecté le filtre. {#r_CimIQLTutorial__ol_x1l_zxd_lp} | | 7 | CIM_ComputerSystem.CIM_RunningOS\[0\].Name | Récupère la [propriété](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__PropertiesToken) de nom pour la première instance CIM_OperatingSystem de chaque instance CIM_ComputerSystem. Le jeton intermédiaire, CIM_RunningOS, est le nom de la [classe Associateur](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken) et non le résultat final. | | 8 | CIM_ComputerSystem.CIM_RunningOS{{Name=/CentOS/}}\[0\].Name | Récupère la [propriété](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLComponentTokens__PropertiesToken) de nom de la première instance CIM_OperatingSystem de chaque instance CIM_ComputerSystem, [où](https://servicenow-prod.fluidtopics.net/M6FPTrnFehpZvkI19JavaQ#r_CimIQLOperationTokens__EnumerateObjectsToken) chaque instance CIM_OperatingSystem possède une propriété de nom contenant 'CentOS'. | [Tableau 5. Didacticiel CimIQL] {#r_CimIQLTutorial__table_e4t_35d_lp} ## Résultats CimIQL {#ariaid-title6} Les résultats de la sonde CIM sont transmis au capteur de sonde en tant que document XML incorporé dans l'élément \. Voici un exemple commenté d'un résultat de traitement par lots CimQuery. CIM_ComputerSystem[0].PrimaryOwnerContact <_classname>Linux_ComputerSystem <_key>