--- sourceDocument: Yokohama IT Operations Management sourceDocumentLink: https://www.servicenow.com/docs/r/ja-JP/yokohama/it-operations-management Release : - yokohama ft:locale : - ja-JP ft:publication_title : - Yokohama IT Operations Management ft:clusterId : - itom bundleId : - itom workflow : - Technology --- # CIM プローブ # CIM プローブ {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：15分 CIM プローブは、WBEM プロトコルを使用して、一連のデータオブジェクトとプロパティについて、特定の CIM サーバー、CIM オブジェクトマネージャーをクエリーします。{#r_CIMProbe__ph_cim-probe-intro} プローブパラメーターの設定手順については、「[プローブパラメーターを設定](https://www.servicenow.com/docs/DzU~XDrsGAFGyjbhCUkSNw "プローブパラメーターを使用して、トリガーされるたびに特定のプローブの動作を制御します。")」を参照してください。 CIM プローブには、次のパラメーターを渡すことができます。 {#r_CIMProbe__table_s1j_w2v_m4__entry__3} | パラメーター | 説明 | デフォルト値 | |-|-|-| | ソース | \[必要\] 接続する最初のホストです。 | なし | | ポート | 接続するポートです。空の場合、値は「schema」パラメーター：http = 5988, https = 5989 によって決定されます。 | 5988 または 5989 | | スキーマ | \[必要\] 使用するスキーマ：「http」または「https」です。 | http | | 名前空間 | \[必要\] CIM のネームスペースです。クエリーによって上書きされる場合があります。 | なし | | クエリ | \[必要\] 結果を処理して結果を返すための、CIM プローブクエリーをセミコロンで区切って列挙します。 | なし | | retries | ネットワーク接続の問題により失敗した場合にクエリーを再試行する回数です。 | 2 | | connection_timeout | プローブがサーバーにコネクトする際に経過するミリ秒数です。 | 5000 | | socket_timeout | プローブがデータを読み取る際に経過するミリ秒数です。 | 5000 | [表 : 1. CIM プローブ] {#r_CIMProbe__table_s1j_w2v_m4} CIM 中間クエリー言語 (CimIQL) は、キー、フィルター、ドット連結を使用して CIM スキーマをスキャンします。 ## パラメーター展開 {#r_CIMProbe__section_mvx_ncg_dcb} CIM クエリー言語は、標準 SNC の前処理されたプローブパラメーター展開をサポートしています。次のように名前をカプセル化してクエリーに変数を配置します。 ${foobar}.CIM_RunningOS[0].Name CIM_ComputerSystem.${barfoo} テキスト ${foobar} は、CIM プローブに渡された foobar プローブパラメーターのコンテンツに置き換えられます。barfoo に対しても同様です。 ## CIMIQL {#r_CIMProbe__section_wyd_pcg_dcb} CIM 中間クエリー言語 (CimIQL) は、CIM プロバイダをクエリーするプロセスを簡素化するために設計された中間言語です。{#r_CIMProbe__ph_cim-query-lang-intro} CimIQL は現在、標準的な Web ベースのエンタープライズ管理 (WBEM) プロトコルスタックをサポートしていますが、その他 (Web Service Management (WS-MAN) など) も将来追加される可能性があります。クエリー言語の構文は、Microsoft の WMI クエリー言語および UNIX の wbemcli コマンドの要素から取り入れられます。CimIQL ライブラリーは、Pure Java の実装です。{#r_CIMProbe__p_cimiql-content} 注: CimIQL は「シミクル」と発音されます。 ## CimIQL の構文 {#ariaid-title2} CimIQL の構文は、クエリーやさまざまなトークンを含む複数の要素で構成されます。 {#r_CimIQLSyntax__table_drq_3vc_lp__entry__2} | 要素 | 説明 | |-|-| | ステートメント | CimIQL の最も基本的な要素は、有効なです。ステートメントには、ピリオドで区切られた複数のクエリーが含まれています。 | | クエリ | は、プロトコルに依存しない単一の高レベル要求を表します。各クエリーは、「トークン」と呼ばれる、ネストされた言語コンポーネントとサブコンポーネントで構成されています。 | | トークン | は、CimIQL 構文の特定の字句的側面を記述します。 | | [運用トークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens "CimIQL プローブには、運用トークンが必要です。") | 各クエリーの最初のトークンは、実行される全体的な論理操作を表すである必要があります。 | | [コンポーネントトークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens "CimIQL プローブには、運用トークンのサブコンポーネントであるコンポーネントトークンが必要です。") | は、運用トークンのサブコンポーネントです。 | | 結果 | 各クエリーは結果とペアになり、ステートメント内の次のクエリーへの入力として提供されます。は、一連のオブジェクトとそのプロパティで構成されます。 | [表 : 2. CimIQL の構文要素の説明] {#r_CimIQLSyntax__table_drq_3vc_lp} ## CimIQL 運用トークン {#ariaid-title3} CimIQL プローブには、運用トークンが必要です。 次のそれぞれのコア運用は、[HTTP による CIM 運用](http://www.dmtf.org/sites/default/files/standards/documents/DSP0200_1.3.1.pdf)と対応しています。 {#r_CimIQLOperationTokens__table_rk1_jzc_lp__entry__3} | リターン値 | 詳細 | HTTP による同等の CIM 運用 | |-|-|-| | class object | [オブジェクトの取得](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens__GetObjectToken) 固有のキー ([キートークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__KeyToken)として) をすべて指定し、オプションの[パラメータートークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__ParameterToken)をカンマで区切って指定することによって、特定のクラスの単一のオブジェクトを取得します。 | GetInstance | | class object | [オブジェクトの列挙](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens__EnumerateObjectsToken) 一連の[条件トークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__ConditionToken)と[パラメータートークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__ParameterToken)に一致するオブジェクトを取得します。 | EnumerateInstances | | class object | [関連オブジェクトの列挙](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken) 前のクエリーの各結果に関連付けられたオブジェクトを取得します。 | アソシエーター | | statement results | [代入](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens__SubstitutionToken) 前の名前付きステートメントの結果を、その独自のステートメントの次のクエリーに入力としてフィードする、非運用トークンです。 | 名前付きステートメントの結果の参照 | [表 : 3. CimIQL 運用トークンの概要] {#r_CimIQLOperationTokens__table_rk1_jzc_lp} ### オブジェクトトークンの取得 \<クラス名\>{\<キートークン\>,\<パラメータートークン\>,...} * 固有のキーすべてを (キートークン[キートークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__KeyToken)として) 指定し、オプションの[パラメータートークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__ParameterToken)をカンマで区切って指定することによって、特定のクラスの単一のオブジェクトを取得します。このトークンは、とも呼ばれます。 * \<クラス名\> は、目的のオブジェクトの大文字と小文字を区別する CIM クラス名です。デフォルトでは、指定されたクラスとそのすべての拡張クラスのオブジェクトが取得されます。 * キーおよびパラメータートークンは、一組の波かっこ ({...}) で囲まれています。 * このトークンは、かならずステートメント内の最初のクエリーとして使用する必要があります。 * リターン：クラスオブジェクト * 例： CIM_ComputerSystem{CreationClassName='Linux_ComputerSystem',Name='runtime'}.* {#r_CimIQLOperationTokens__ul_ibd_vcd_lp} ### オブジェクトトークンの列挙 \<クラス名\>{{\<条件トークン\>,\<パラメータートークン\>,...}}\<アレイインデックストークン\> または \<クラス名\>\<アレイインデックストークン\> * 一連の[条件トークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__ConditionToken)と[パラメータートークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__ParameterToken)に一致するオブジェクトを取得します。このトークンは、とも呼ばれます。 * 条件トークンおよびパラメータートークンは、二組の波かっこ ({{...}}) で囲まれています。条件またはパラメーターが必要ない場合、波かっこはオプションになります。 * \<クラス名\> は、目的のオブジェクトの大文字と小文字を区別する CIM クラス名です。デフォルトでは、指定されたクラスとそのすべての拡張クラスのオブジェクトが取得されます。 * [インデックストークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__IndexToken)はオプションです。 * このトークンは、かならずステートメント内の最初のクエリーとして使用する必要があります。 * リターン：クラスオブジェクト * 例： CIM_ComputerSystem{{Name!='runtime'}}.* {#r_CimIQLOperationTokens__ul_rlm_zdd_lp} ### 関連オブジェクトトークンの列挙 \<関連クラス名\>{{\<プロパティフィルタートークン\>,\<パラメータートークン\>,...}}\<アレイインデックストークン\> または \<関連クラス名\>\<アレイインデックストークン\> * 前のクエリーの各結果に関連付けられたオブジェクトを取得します。 * [条件トークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__ConditionToken)および[パラメータートークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__ParameterToken)は、二組の波かっこ ({{...}}) で囲まれています。プロパティフィルターまたはパラメーターが必要ない場合、波かっこはオプションになります。 * \<関連クラス名\> は、2 つのオブジェクトを関連付ける多対多または 1 対多のクラスの名前です。デフォルトでは、指定されたクラスとそのすべての拡張クラスのオブジェクトが取得されます。 * 結果のオブジェクトのクラス名に基づいて結果をフィルタリングするために、\<パラメータートークン\>, ResultClass を指定することができます。 * [インデックストークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__IndexToken)はオプションです。 * このトークンは、ステートメント内の最初のクエリとして使用することができません。 * リターン：クラスオブジェクト * 例： CIM_ComputerSystem{{Name='runtime'}}[2].* {#r_CimIQLOperationTokens__ul_c1c_p2d_lp} ### 代入トークン ${\<ステートメント名\>} * 前の名前付きステートメントの結果を、その独自のステートメントの次のクエリーに入力としてフィードする、非運用トークンです。 * リターン：void * 例： $(lastComputer).ElementName {#r_CimIQLOperationTokens__ul_fz3_tgd_lp} ## CimIQL コンポーネントトークン {#ariaid-title4} CimIQL プローブには、運用トークンのサブコンポーネントであるコンポーネントトークンが必要です。 次のトークンは、[運用トークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens "CimIQL プローブには、運用トークンが必要です。")のサブコンポーネントです。{#r_CimIQLComponentTokens__table_rk1_jzc_lp__entry__2} | トークン | 詳細 | |-|-| | プロパティトークン | \* または \<プロパティ名\>,\<プロパティ名\>,... 最終結果セットの各オブジェクトに対してどのプロパティを返すかを指定します。 | | クエリ区切り文字トークン | . (ピリオド) クエリーを分割します。 | | インデックストークン | \[インデックス\] 先行するクエリーの結果を、指定された整数インデックスの単一のオブジェクトに削減します。 | | キートークン | \<キー名\>='\<値\>' 正確な値でキーとして指定されたオブジェクトプロパティに一致します。 | | 条件トークン | \<プロパティ名\>\< 条件付き演算子\>\<囲まれた値\> 指定された条件に基づいて、オブジェクトの単一のプロパティに一致します。 | | パラメータートークン | \<パラメーター名\>:'\<値\>' 呼び出される操作に \<パラメーター名\> でパラメーターを渡します。パラメーターに応じて、CimIQL の前処理中に、または要求による CIMOM によってパラメーターが使用される場合があります。 | [表 : 4. CimIQL コンポーネントトークンの概要] {#r_CimIQLComponentTokens__table_rk1_jzc_lp} ### プロパティトークン \* または \<プロパティ名\>,\<プロパティ名\>,... * 最終結果セットの各オブジェクトに対してどのプロパティを返すかを指定します。 * ワイルドカード \* を使用すると、利用可能なすべてのプロパティが返されます。それ以外の場合、各プロパティ名はカンマで区切られたリストで提供されます。 * このトークンは、各ステートメントの最後に必要です。 * 例： CIM_ComputerSystem[0].* {#r_CimIQLComponentTokens__ul_kt1_pkd_lp} ### クエリー区切り文字トークン . (ピリオド) * クエリーを分割します。 * 例： CIM_ComputerSystem.PrimaryOwnerContact ### インデックストークン \[インデックス\] * 先行するクエリーの結果を、指定された整数インデックスの単一のオブジェクトに削減します。 * このトークンは常にオプションです。 * 例： CIM_ComputerSystem[0].* {#r_CimIQLComponentTokens__ul_tkg_1ld_lp} ### キートークン \<キー名\>='\<値\>' * 正確な値でキーとして指定されたオブジェクトプロパティに一致します。 * \<キー名\> は、キーとして使用されるプロパティの名前です。 * 例： CIM_ComputerSystem{CreationClassName='Linux_ComputerSystem',Name='runtime'}.* {#r_CimIQLComponentTokens__ul_mw1_tld_lp} ### 条件トークン \<プロパティ名\>\< 条件付き演算子\>\<囲まれた値\> * 指定された条件に基づいて、オブジェクトの単一のプロパティに一致します。 * \<プロパティ名\> は、照合するプロパティの名前です。 * \<条件付き演算子\> は、プロパティの実際の値を予期される値と比較する方法を決定します。利用可能な演算子は、等値 (=) および非等値 (! =) です。 * \<囲まれた値\> は、次のいずれかである必要があります。 * リテラル値は単一引用符で囲まれます (' ... ')。例：foo='bar' * 正規表現は、一組のスラッシュで囲まれます (/ ... /)。例：foo=/bar.\*/ {#r_CimIQLComponentTokens__ul_hpg_zld_lp} * 例： CIM_ComputerSystem{{Name!='runtime'}}.* {#r_CimIQLComponentTokens__ul_lv3_yld_lp} ### パラメータートークン \<パラメーター名\>:'\<値\>' * 呼び出される操作に \<パラメーター名\> でパラメーターを渡します。パラメーターに応じて、CimIQL の前処理中に、または要求による CIMOM によってパラメーターが使用される場合があります。 * 例： CIM_ComputerSystem.CIM_RunningOS{{ResultClass:'Win32_ComputerSystem'}}.* {#r_CimIQLComponentTokens__ul_i4g_mmd_lp} ## CimIQL チュートリアル {#ariaid-title5} このチュートリアルは、それぞれの例が前の例でビルドされる例を示しています。 {#r_CimIQLTutorial__table_e4t_35d_lp__entry__3} | 順序 | CimIQL ステートメント | 結果 | |-|-|-| | 1 | CIM_ComputerSystem \[0\]. \* | CIM_ComputerSystem とその派生のすべてのインスタンスの[最初の結果](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__IndexToken)を取得します。すべての[プロパティ](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__PropertiesToken)を取得します。 | | 2 | CIM_ComputerSystem.PrimaryOwnerContact | CIM_ComputerSystem とその派生のすべてのインスタンスを取得します。1 つの[プロパティ](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__PropertiesToken)、PrimaryOwnerContact のみを取得します。 | | 3 | CIM_ComputerSystem{CreationClassName='Linux_ComputerSystem',Name='runtime'}.\* | CIM_ComputerSystem とその派生の単一の固有のインスタンスを取得します。すべての[キートークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__KeyToken)は、{} [ID トークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens__GetObjectToken)内で指定する必要があります。 | | 4 | CIM_ComputerSystem{{Name!='runtime'}}.\* | \[名前\] [プロパティ](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__PropertiesToken)が「runtime」でない CIM_ComputerSystem のすべてのインスタンスと派生を取得します。 [フィルタートークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens__EnumerateObjectsToken) {{}} は、指定されたすべてのプロパティ / キーを含まないインスタンスをフィルタリングします。 | | 5 | CIM_ComputerSystem{{Name=/\^run.\*$/}}.\* | / / 文字内に含まれる正規表現に一致する値を持つ CIM_ComputerSystem のすべてのインスタンスと派生を取得します。 注: 正規表現には単一の引用符は必要ありません。 [フィルタートークン](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens__EnumerateObjectsToken) {{}} は、指定されたすべてのプロパティ / キーを含まないインスタンスをフィルタリングします。 | | 6 | CIM_ComputerSystem{{Name='runtime'}}\[2\].\* | プロパティ名が「runtime」[である](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens__EnumerateObjectsToken) CIM_ComputerSystem のすべてのインスタンスとその派生について、[2 番目の結果](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken)を取得します。 操作の順序は、クエリーの構文に従います。 1. すべての CIM_ComputerSystem と派生に対してサーバーを[クエリー](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens__GetObjectToken)します。 2. 名前プロパティに基づいて結果を[フィルタリング](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens__EnumerateObjectsToken)します。 3. フィルターを通過した [2 番目のインスタンスを取得](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken)します。 {#r_CimIQLTutorial__ol_x1l_zxd_lp} | | 7 | CIM_ComputerSystem.CIM_RunningOS\[0\].Name | 各 CIM_ComputerSystem インスタンスの最初の CIM_OperatingSystem インスタンスの名前[プロパティ](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__PropertiesToken)を取得します。 中央のトークンである CIM_RunningOS は、最終結果ではなく、[アソシエータークラス](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens__EnumerateAssociatedObjectsToken)の名前です。 | | 8 | CIM_ComputerSystem.CIM_RunningOS{{Name=/CentOS/}}\[0\].Name | 各 CIM_ComputerSystem インスタンスの最初の CIM_OperatingSystem インスタンスの名前[プロパティ](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLComponentTokens__PropertiesToken)を取得します。[ここで](https://www.servicenow.com/docs/~EKxE67cQnqRLaD41uNcDg#r_CimIQLOperationTokens__EnumerateObjectsToken)、各 CIM_OperatingSystem インスタンスの名前プロパティには「CentOS」が含まれます。 | [表 : 5. CimIQL チュートリアル] {#r_CimIQLTutorial__table_e4t_35d_lp} ## CimIQL 結果 {#ariaid-title6} CIM プローブの結果は、\ 要素内に埋め込まれた XML ドキュメントとしてプローブセンサーに渡されます。 次に、CimQuery バッチ結果のコメント付きの例を示します。 CIM_ComputerSystem[0].PrimaryOwnerContact <_classname>Linux_ComputerSystem <_key>