--- sourceDocument: Gestion des opérations IT Australie sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/it-operations-management Release : - australia ft:locale : - fr-FR ft:publication_title : - Gestion des opérations IT Australie ft:clusterId : - itom bundleId : - itom workflow : - Technology --- # Sonde CIM # Sonde CIM {#ariaid-title1} * Rversion finale: Australia * * Mis à jour 12 mars 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 10 minutes de lecture La sonde CIM utilise les protocoles WBEM pour interroger un serveur CIM particulier, le gestionnaire d'objets CIM, pour un ensemble d'objets de données et de propriétés. {#r_CIMProbe__ph_cim-probe-intro} Pour plus d'informations sur la configuration des paramètres de sonde, reportez-vous à la section [Définir les paramètres de sonde](https://servicenow-prod.fluidtopics.net/CrV1bN5DEVRc_uHaiDalvA "Utilisez les paramètres de sonde pour contrôler le comportement d’une sonde particulière 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 | \[Obligatoire\] L'hôte initial auquel se connecter. | Néant | | port | Port auquel se connecter. S'il est vide, la valeur est déterminée par le paramètre \<\< schema \>\> : http = 5988, https = 5989. | 5988 ou 5989 | | Schéma | \[Obligatoire\] Le schéma à utiliser : '"http"' ou '"https"'. | http | | espace de noms | \[Obligatoire\] Espace de noms CIM. Peut être remplacé par une requête. | Néant | | requêtes | \[Obligatoire\] Liste délimitée par des points-virgules des requêtes de sonde CIM à traiter et pour lesquelles renvoyer les résultats. | Néant | | Nouveaux essais | Nombre de nouvelles tentatives d'une requête si elle échoue en raison de problèmes de connectivité réseau. | 2 | | connection_timeout | Nombre de millisecondes dont dispose la sonde pour se connecter à un serveur. | 5000 | | socket_timeout | Nombre de millisecondes dont la sonde dispose pour lire les données. | 5000 | [Tableau 1. Sonde CIM] {#r_CIMProbe__table_s1j_w2v_m4} Le langage de requête intermédiaire CIM (CimIQL) utilise des clés, des filtres et une remontée pas à pas pour parcourir le schéma CIM. ## Extension de paramètre {#r_CIMProbe__section_mvx_ncg_dcb} Le langage de requête CIM prend en charge l'expansion des paramètres de sonde prétraitée SNC standard. Placez des variables dans les requêtes en encapsulant leurs noms comme ceci : ${foobar}.CIM_RunningOS[0].Name CIM_ComputerSystem.${barfoo} Le texte ${foobar} est remplacé par le contenu du paramètre foobarprobe passé à la sonde CIM ; De même pour Barfoo. ## Le CIMIQL {#r_CIMProbe__section_wyd_pcg_dcb} Le CIM Intermediate Query Language (CimIQL) 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), mais d'autres, tels que WS-MAN (Web Services-Management), pourraient être ajoutés à l'avenir. La syntaxe du langage de requête emprunte à des éléments du langage UNIX de requête WMI de et de Microsoft la commande wbemcli de . La bibliothèque CimIQL est une implémentation purement Java.{#r_CIMProbe__p_cimiql-content} Remarque : CimIQL se prononce \<\< simicle \>\>. ## Syntaxe de CimIQL {#ariaid-title2} La syntaxe de CimIQL se compose de plusieurs éléments, dont une requête et différents jetons. {#r_CimIQLSyntax__table_drq_3vc_lp__entry__2} | Élément | Description | |-|-| | Instruction | L'élément le plus fondamental de CimIQL est une valide. Une instruction contient plusieurs requêtes délimitées par un point . caractère. | | Requête | Une représente une requête unique de haut niveau indépendante du protocole. Chaque requête est composée de composants et de sous-composants de langage imbriqués 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/rtWbDuAzMECZGxIokohDzQ#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/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens "La sonde CimIQL nécessite des jetons de composant, qui sont des sous-composants des 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 de l'instruction. Un est composé d'un ensemble d'objets et de leurs propriétés. | [Tableau 2. Descriptions d'éléments de 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 de base suivantes a une contrepartie dans la norme [Opérations CIM sur HTTP](http://www.dmtf.org/sites/default/files/standards/documents/DSP0200_1.3.1.pdf) . {#r_CimIQLOperationTokens__table_rk1_jzc_lp__entry__3} | Valeur de retour | Détails | Opération CIM équivalente sur HTTP | |-|-|-| | Objet de classe | [Obtenir un objet](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLOperationTokens__GetObjectToken) Récupère un objet unique d'une classe spécifique en spécifiant toutes ses clés uniques (sous forme de [jetons de clé](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__KeyToken)) et tous les [jetons de paramètre facultatifs](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__ParameterToken), séparés par des virgules. | GetInstance | | Objet de classe | [Énumérer les objets](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLOperationTokens__EnumerateObjectsToken) Récupère les objets qui correspondent à un ensemble de [jetons de condition](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__ConditionToken) et de [jetons de paramètre](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__ParameterToken). | EnumerateInstances | | Objet de classe | [Énumérer les objets associés](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken) Récupère les objets associés à chaque résultat de la requête précédente. | Associateurs | | Résultats des relevés | [Substitution](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLOperationTokens__SubstitutionToken) Jeton no-op qui alimente les résultats d'une instruction nommée précédente en tant qu'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ésumé du jeton 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 (sous forme de jetons de clé, de [jetons de clé](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__KeyToken)) et tous les [jetons de paramètre facultatifs](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__ParameterToken), séparés par des virgules. Ce jeton est également connu sous le nom de . * Le \ est le 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 seule paire d'accolades { ... }. * Ce jeton ne doit être utilisé que comme première requête d'une instruction. * Renvoie : objet de classe * Exemple : CIM_ComputerSystem{CreationClassName='Linux_ComputerSystem',Name='runtime'}.* {#r_CimIQLOperationTokens__ul_ibd_vcd_lp} ### Énumérer le jeton d'objets \{{\,\,...}}\ OU \\ * Récupère les objets qui correspondent à un ensemble de [jetons de condition](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__ConditionToken) et de [jetons de paramètre](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__ParameterToken). Ce jeton est également connu sous le nom de . * Les jetons de condition et les jetons 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. * Le \ est le 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/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__IndexToken) est facultatif. * Ce jeton ne doit être utilisé que comme première requête d'une instruction. * Renvoie : objet de classe * Exemple : CIM_ComputerSystem{{Name!='runtime'}}.* {#r_CimIQLOperationTokens__ul_rlm_zdd_lp} ### Énumérer le jeton d'objets associés \{{\,jeton de paramètre \<\>,...}}\ 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/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__ConditionToken) et [les jetons de paramètre](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__ParameterToken) sont entourés de deux paires d'accolades {{ ... }}. Les accolades sont facultatives si aucune propriété, filtre ou paramètre n'est nécessaire. * Le \ est le nom de la classe plusieurs-à-plusieurs ou un-à-plusieurs qui associe deux objets. Par défaut, les objets de la classe spécifiée et de toutes les classes étendues sont récupérés. * Le \, 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/rtWbDuAzMECZGxIokohDzQ#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 no-op qui alimente les résultats d'une instruction nommée précédente en tant qu'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 des jetons opérationnels. Les jetons suivants sont des sous-composants des [jetons d'opération](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#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 du | . (Un point c'est tout) Sépare les requêtes. | | Jeton | \[Index\] Réduit les résultats d'une requête précédente à un seul objet à 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 paramètre | \ :'\' Transmet un paramètre par \ à l'opération appelée. Le paramètre peut être consommé pendant le prétraitement de CimIQL ou par le CIMOM sur demande, selon le paramètre. | [Tableau 4. Résumé du jeton 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. Dans le cas contraire, 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 du délimiteur de requête . (Un point c'est tout) * 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 à 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. * Le \< nom de la clé \> est le 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. * Le \< nom de la propriété \> correspond au nom de la propriété à mettre en correspondance. * L'\ détermine comment la valeur réelle de la propriété est comparée à sa valeur attendue. Les opérateurs disponibles sont égalité (=) et inégalité ( !=). * La \ doit être l'une des suivantes : * Valeur littérale entre 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 consommé pendant le prétraitement CimIQL ou par le gestionnaire d'objets CIMOM (Common Information Model Object Manager) via demande, selon le paramètre. * Exemple : CIM_ComputerSystem.CIM_RunningOS{{ResultClass:'Win32_ComputerSystem'}}.* {#r_CimIQLComponentTokens__ul_i4g_mmd_lp} ## Tutoriel CimIQL {#ariaid-title5} Il s'agit d'un didacticiel par exemple où chaque exemple s'appuie sur l'exemple précédent. {#r_CimIQLTutorial__table_e4t_35d_lp__entry__3} | Ordre | Déclaration CimIQL | Résultat | |-|-|-| | 1 | CIM_ComputerSystem\[0\].\* | Récupère le [premier résultat](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#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/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__PropertiesToken). | | 2 | CIM_ComputerSystem.ContactPropriétairePrimaire | Récupère toutes les instances de CIM_ComputerSystem et leurs descendants. Récupère une seule [propriété](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#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é doivent être spécifiés](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__KeyToken) dans le [jeton d'identité](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLOperationTokens__GetObjectToken) { }. | | 4 | CIM_ComputerSystem{{Name !='runtime'}}.\* | Récupère toutes les instances et les descendants des CIM_ComputerSystem qui n'ont pas de [propriété](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__PropertiesToken) de nom \<\< runtime \>\>. Le [jeton de filtre](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#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 les descendants de CIM_ComputerSystem dont la valeur correspond à l'expression régulière contenue dans les caractères / /. Remarque : L'expression régulière ne nécessite pas de guillemets simples. Le [jeton de filtre](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#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 [deuxième résultat](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken) de toutes les instances de CIM_ComputerSystem et de ses descendants [lorsque](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLOperationTokens__EnumerateObjectsToken) les instances ont un nom de propriété \<\< runtime \>\>. L'ordre des opérations suit la syntaxe de la requête. 1. [Serveur de requêtes](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLOperationTokens__GetObjectToken) pour tous les CIM_ComputerSystem et descendants. 2. [Filtrer](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#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/rtWbDuAzMECZGxIokohDzQ#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken) instance qui a réussi le filtre. {#r_CimIQLTutorial__ol_x1l_zxd_lp} | | 7 | CIM_ComputerSystem.CIM_RunningOS\[0\]. Name (Nom) | Récupère la [propriété](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__PropertiesToken) Nom de la première instance CIM_OperatingSystem de chaque instance CIM_ComputerSystem. Le jeton du milieu, CIM_RunningOS, est le nom de la [classe Associateur](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken), et non le résultat final. | | 8 | CIM_ComputerSystem.CIM_RunningOS{{Nom=/CentOS/}}\[0\]. Name (Nom) | Récupère la [propriété](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLComponentTokens__PropertiesToken) Nom de la première instance CIM_OperatingSystem de chaque instance CIM_ComputerSystem, [où](https://servicenow-prod.fluidtopics.net/rtWbDuAzMECZGxIokohDzQ#r_CimIQLOperationTokens__EnumerateObjectsToken) chaque instance CIM_OperatingSystem a une propriété Nom contenant \<\< CentOS \>\>. | [Tableau 5. Tutoriel 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 sous la forme d'un document XML incorporé dans l'élément \ . Voici un exemple commenté d'un résultat de lot CimQuery. CIM_ComputerSystem[0].PrimaryOwnerContact <_classname>Linux_ComputerSystem <_key>