KACE Systems Management Appliance 13.2 Common Documents - Administrator Guide (Japanese - 13.0)

カスタムインベントリルールの構文

カスタムインベントリルールの構文

カスタムインベントリルールの関数の名前と引数に正しい構文を使用します。

条件付きルールと値戻しルールでは次の構文を使用します。

関数とそれらの引数の詳細については、次の情報を参照してください。

関数の構文

開始かっこの前に「functionName」を入力し、その開始かっこと終了かっこで引数を囲みます。関数の名前と開始かっことの間にスペースは許可されません。

引数の構文

コマンドとregex（正規表現）を除くすべてのルールについて、引数を次のような構文で入力します。

例えば、次の構文は同じです。

ルールでの値としてのコンマとかっこ

コンマ、開始かっこ、または終了かっこをルール内の値として使用する場合、{{comma}}、{{op}}、および{{cp}}のようにそれぞれエスケープする必要があります。

例えば、ユーザーが、値の名前が「test,value」であるレジストリ値に対してテストを実行する場合、レジストリ値の名前がカスタムインベントリ（CI）関数の最後の引数ではないため、この場合はコンマをエスケープする必要があります。

ユーザーが、値自体にコンマが含まれるレジストリ値に対してテストを実行する場合、値がカスタムインベントリ関数の最後の引数であるため、エスケープする必要はありません。次のカスタムインベントリでは、レジストリ値HKLM\SOFTWARE\TestSoft\test1をテストし、値が「2,4」と等しいかどうかを確認します。

カスタムインベントリ関数に1つのパラメータのみが含まれる場合、かっこで囲まれたすべてを引数の値としてとります。この場合のコンマはエスケープする必要はなく、カスタムインベントリ関数の引数の一部となります。

例えば、ユーザーが文字列「Hello ( World」をエコーする必要がある場合、CIは次のようになります。

パーサーは、関数の引数をトークン化する場合、開始かっこと終了かっこの数をカウントして、ペアとなっている最後の終了かっこがある場合に関数の末尾であることを識別します。ただし、引数値自体に（ペアとなる開始かっこがない）終了かっこが含まれる場合、パーサーはそのかっこが関数の末尾であると錯覚し、その引数値は完全に切り捨てられます。

リテラルの終了かっこが引数値の一部として必要な場合は、{{cp}}で表す必要があります。

例えば、ユーザーが文字列「Hello ) World」をエコーする必要がある場合、CIは次のようになります。

条件の確認（条件付きルール）

条件の確認（条件付きルール）

アプリケーションがインストールされているかどうか（true/false）を識別するカスタムインベントリルールを記述できます。

条件付きルールを使用すると、ルールによって true が返される場合、カスタムアプリケーションの表示名（タイトル）が インベントリセクションにある デバイスの詳細 ページの Software:Installed Programs（ソフトウェア:インストールされているプログラム） セクションに表示されます。

次のセクションでは、条件をテストするルールについて説明します。

ルールによってfalseが返されると、アプリケーションはデバイスのインベントリ詳細の インストールされているプログラム セクションに表示されません。

ヒント: アイテムがインストールされているデバイスのリストは、インベントリ > ソフトウェア > Custom_item: 詳細 ページに表示されます。

条件付きルールのリファレンス

次の表に、比較で使用できるデータ型を示します。

次の表は、比較が行われる方法を示します。

使用可能な条件付きルール、および引数の指定方法の詳細へのリンクを、次の表で説明します。

FilenamesMatchingRegex の Equals、GreaterThan、およびLessThan については、正規表現ルールのリファレンスを参照してください。

条件が存在するかどうかの確認（Existsルール）

名前が「Exists」で終わるルールは、ファイル、ディレクトリ、レジストリキー、またはその他のアイテムの存在を確認するために使用されます。KACE エージェントがデバイス上でアイテムを見つけた場合、そのルールによって true が返され、アイテムのインベントリ詳細は インストールされているプログラム として表示されます。

次のいずれかのExistsルールを使用します。

例：ディレクトリ（フォルダ）を確認する

次の例では、Windowsディレクトリがデバイス上に存在するかどうかを確認するテストを行います。

例：ファイルを確認する

注: 次の例では、メモ帳実行可能ファイルがデバイス上に存在することを確認します。

デバイス設定の評価（Equalsルール）

名前がEqualsで終わるルールは、デバイス上で設定した値を、ルールで指定した値に比較するために使用します。値が正確に一致する場合は、ルールによってtrueが返されます。

データ型を設定した引数を使用するルールでは、同じ型の値のみを比較できます。

次のいずれかのEqualsルールを使用します。

例：JAVA_HOME設定をテストする

JAVA_HOME 設定が C:\Program Files\Java\jdk1.6.0_02 であることを確認するには：

例：McAfee®レジストリエントリ設定をテストする

設定で使用されている形式がエントリ内の日付の形式と同じであることを確認します。

例：Windows 7 Service Pack 1 を検出する

Windows 7 Service Pack 1 は、もともとは Windows 7 がインストールされていて SP1 にアップグレードされたデバイスでのみ、プログラムの追加と削除 に表示されます。このアイテムのデフォルトアプリケーションインベントリには、SP1上で既に動作しているデバイスは反映されません。それらのデバイスは、もともとSP1のレベルでイメージを作成されているためです。

Windows 7 Service Pack 1 の展開にアプライアンスを使用するときは、カスタムアプリケーションについて次のカスタムインベントリルールを作成します。

このアイテムがインストールされているデバイスを除外して、SP2 レベルに既にあるデバイス（つまり、アップグレードされた Windows 7 デバイスと、SP1 レベルでもともとイメージを作成されたデバイス）にアプライアンスが SP2 を展開しないようにします。

デバイス値の比較（Greater ThanルールとLess Thanルール）

名前が GreaterThan と LessThan で終わる関数は、Table 24でリストされている値を比較します。

次のいずれかのGreater ThanルールとLess Thanルールを使用します。

例：製品のバージョンが次以降であるかをテストする

製品バージョンが特定の番号以降であることを確認します。

製品バージョンが特定の番号以降であることを確認するには、次のように入力します。

例：製品バージョンの範囲をテストする

製品バージョンが範囲内であるかをテストするには、less thanルールとgreater thanルールを組み合わせます。

重要: ルールを個別の行に入力しないでください。ルールの区切りにはスペースのみを使用します。ルールを個別の行に配置すると、複合ルールが無効になります。

複数の条件のテスト

「および」演算子や「または」演算子を使用してルールを連結して複数の条件をテストできます。

注: 同じカスタムインベントリルールでの「および」と「または」の両方の演算子の使用はサポートされていません。個別のアプリケーションをセットアップします。

条件付きルールの連結により次の結果が得られます。

重要: ルールを個別の行に入力しないでください。ルールの区切りにはスペースのみを使用します。ルールを個別の行に配置すると、複合ルールが無効になります。

複数のtrue条件の確認（「および」）

すべてのルールがtrueである場合のみ、インストールされているプログラムとしてアイテムがレポートされるようにするには、「カスタムインベントリフィールド」で「および」演算子を使用して条件付きルールを連結します。

カスタムインベントリフィールド で、次の構文を使用してルールを連結します。

条件文と演算子の区切りにはスペースを使用します。

例：レジストリキーを確認して値を比較する

Windowsデバイス上のレジストリキーとレジストリエントリ値を確認するには、次に示しているように、「および」を使用してルールを連結します。

1つのtrue条件の確認（「または」）

または演算子を使用してルールを連結すると、Custom Inventory Field（カスタムインベントリフィールド） でのいずれかのルールが true である場合、アプリケーションがデバイスの Installed Program（インストールされているプログラム） リストに表示されます。

カスタムインベントリフィールド で、次の構文を使用してルールを連結します。

関数ステートメントと演算子の区切りにはスペースを使用します。

例：レジストリ値を確認する

レジストリエントリがある値か別の値であることを確認します。

ヒント: 範囲を指定するには、RegistryValueGreaterThanルールとRegistryValueLessThanルールを「および」演算子で連結して使用します。

デバイス（カスタムインベントリフィールド）からの値の取得

デバイス（カスタムインベントリフィールド）からの値の取得

ValueReturn で終わるルールを使用すると、デバイスから情報を収集できます。これらのルールを使用して、KACE エージェントでは通常収集されない情報を収集できます。

返された値は、カスタムアプリケーション表示名（タイトル）に設定されます。これは、デバイスの詳細 ページの Installed Programs（インストールされているプログラム） と Custom Inventory Fields（カスタムインベントリフィールド） にある ソフトウェア に表示されます。

カスタムインベントリフィールド の値は、インストールの管理およびソフトウェアの配布に使用します。さらに、各種レポート、特定基準で表示 のフィルタ、Smart Labelの検索条件に加えて、自動的に検出された設定を使用して実行できるその他のプロセスにも使用できます。

このセクションでは、次のトピックを取り上げます。

値戻しルールのリファレンス

次の表には、カスタムインベントリフィールド の設定に使用できるすべての値戻しルールを示しています。

ファイル情報値の取得

FileInfoReturnルールを使用して、カスタムインベントリフィールド に任意のWindowsファイル情報属性を設定できます。

例：Mozilla Firefox のバージョンを取得

次の例では、Mozilla Firefox の製品バージョンを取得するために、カスタムインベントリフィールド を NUMBER として設定します。

カスタムインベントリフィールド で、次のように入力します。

レジストリキー値の取得

RegistryValueReturn ルールを使用して、Custom Inventory Field（カスタムインベントリフィールド） にレジストリキーを設定できます。ここで、registryPath（左側）はエントリへのパスです。valueName（右側上）は返されるキーです。

例：Mozilla Firefox CurrentVersion キーを取得

カスタムインベントリフィールド を CurrentVersion レジストリキーとして設定するには：

コマンド出力の取得

コマンドルールを使用すると、カスタムインベントリフィールド にコマンドの出力を設定できます。コマンドは、デバイス上のコマンドインタプリタと実行可能パスによって異なります。

例えば、Windowsデバイスでは、MS-DOSコマンドを記述できます。しかし、Cygwinがインストールされておらず、一部のユーザーしかデフォルトパスを使用できない場合、CygwinスタイルのUNIXコマンドは記述できません。

次のいずれかのルールを使用して、カスタムインベントリフィールド にコマンドの出力を設定します。

例：Mac OS Xで稼働時間を取得する

カスタムインベントリフィールド を稼働時間として設定します。

PLIST値の取得

PlistValueReturnルールを使用すると、カスタムインベントリフィールド をプロパティリスト（PList）キーとして設定できます。

例：システムロケールを取得する

システム指定言語に基づいた管理対象インストールを使用してアプリケーションを配布するには、まず、次のルールを入力してデバイスロケールを取得してから、対応する Smart Label を作成します。この Smart Label は、KACE エージェントによって カスタムインベントリフィールド にレポートされた言語コードに基づいてデバイスに適用されます。

複数の値の取得

「および」または「または」のいずれかの演算子を使用して、ValueReturnルールを連結します。いずれの値も空でない場合は、ルールにより、インストールされているプログラムとしてアプリケーションが表示されます。

連結された値はすべて、演算子によって区切られた同じ カスタムインベントリフィールド に設定されます。したがって、検索条件、フィルタ、レポート、およびその他のアプライアンスのプロセスに使用される場合、手法的にはTEXTと見なされます。

演算子を使用した ValueReturn ルールの連結：

カスタムインベントリフィールドで、次の構文を使用してルールを連結します。

条件文と演算子の区切りにはスペースを使用します。同じルールで「および」演算子と「または」演算子を連結しないでください。

正規表現を使用したファイル名のマッチ

正規表現を使用したファイル名のマッチ

正規表現を使用して、指定したディレクトリ内のファイルに対して、指定した文字または文字列とファイル名とのマッチを行います。

このセクションでは、条件付きルールと値戻しルールで正規表現を使用してファイル名のマッチを行う正規表現について説明します。

注: KACE エージェントには、正規表現を使用してファイル名を比較する関数のみが用意されています。