KACE Systems Management Appliance 14.0 Common Documents

条件付きルール: これらのルールは、条件がデバイスに存在するかどうかをテストします。ルールによって true が返されると、KACE エージェントはインストールされているプログラムとしてアイテムをレポートします。ルールによってfalseが返されると、アイテムは「インストールされているプログラム」として表示されません。

•

値戻しルール: これらのルールは、デバイスからデータを取得します。値が存在する場合、KACE エージェントはインストールされているプログラムとしてアイテムをレポートし、対応するカスタムインベントリフィールドを設定します。

カスタムインベントリルールの作成

カスタムインベントリルールの実装方法

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

カスタムアプリケーション、およびそれらのアプリケーションのカスタムインベントリルールを作成し、アプリケーションに関する情報が管理対象デバイスから収集されるようにすることができます。

ソフトウェアの詳細ページに移動します。

アプライアンス管理者コンソール（https://appliance_hostname/admin）にログインします。または、管理ヘッダーに組織メニューを表示オプションがアプライアンスの一般設定で有効になっている場合は、ページの右上隅で、ログイン情報の横にあるドロップダウンリストから組織を選択します。

左側のナビゲーションバーで、インベントリをクリックして、カスタムインベントリをクリックします。

アクションの選択 > 新規作成を選択します。

次の一般情報を入力します。「名前」、「バージョン」、および「発行元」。

ダウンストリームへのレポート処理が適切に実行されるように、この情報がソフトウェアインベントリ全体で整合するようにします。

次の情報を入力します。

オプション	説明
ラベルに制限	（オプション）アイテムに関連付けられるラベル。
メモ	任意の追加情報を入力します。
サポートされているオペレーティングシステム	アプリケーションが実行されるオペレーティングシステム。アプリケーションは、選択したオペレーティングシステムがインストールされているデバイスにのみ導入されます。
カスタムインベントリルール	（オプション）アプリケーションに適用されるカスタムインベントリルール。カスタムインベントリルールを使用すると、デバイス上のアプリケーションおよび他のアイテムを検出したり、レポート目的で詳細を取得したりできます。例えば、アプライアンスでは、デバイス上にアプリケーションが存在するかどうかを確認してから、アプリケーションが展開されます。にもかかわらず、インストールされているプログラムがプログラムの追加と削除またはレジストリの標準領域に登録されていない場合があります。そのような場合、アプライアンスは、管理者からの追加の情報なしでは、アプリケーションの存在を検出できないことがあります。そのため、デバイスが接続されるたび、アプライアンスでインストールが繰り返される場合があります。カスタムインベントリルールを使用すると、この繰り返しを回避できます。次のルールを使用して、デバイスにインストールされているNetwork Associates VirusScanのバージョンが展開前の所定のバージョンよりも新しいことを確認します。 RegistryValueGreaterThan(HKEY_LOCAL_MACHINE\ Software\Network Associates\TVD\ Network Associates\TVD\Shared Components\ VirusScanEngine\4.0.xx,szDatVersion,4.0.44)

ファイルのアップロードと関連付けの隣にあるファイルの選択をクリックしてファイルを参照し、開くまたは選択をクリックします。

管理対象インストールまたはファイル同期によってアプリケーションを配布するには、そのアプリケーションに実際のアプリケーションファイルを関連付ける必要があります。

ファイルがレプリケーション共有にコピーされないようにするには、関連付けられたファイルを複製しないを選択します。この設定は、ソフトウェアスイートなど、ユーザーにレプリケーション共有にインストールしてほしくない大きいファイルに役立ちます。

オプション：ソフトウェアのカテゴリと脅威レベルを設定します。

保存をクリックします。

カスタムインベントリルールの実装方法

KACE エージェントは、新規カスタムインベントリルールの作成後の最初のデバイスインベントリ中に、そのルールを受け取ります。その最初のインベントリ中、エージェントは新しいルールを実行し、検出内容をアプライアンスにレポートします。

エージェントは、すべてのルールを実行すると同時に、そのセッションについてスケジュールされた他のあらゆるプロセスも実行します。したがって、デバイスがインベントリ設定されてからエージェントが結果をレポートするまでに、すべてのルールとその他のプロセスの実行に数分かかる場合があります。

エージェントが結果をレポートした後、デバイスの詳細ページでは、ソフトウェアの下の Installed Program（インストールされているプログラム）と Custom Inventory Fields（カスタムインベントリフィールド）にその結果が表示されます。

NOTE: カスタムインベントリフィールドを設定する値戻しルールが適用されたアプリケーションは、「インストールされているプログラム」としても表示されます。

期待通りの結果が得られない場合は、デバイスが最近インベントリ設定されたことを確認します。インベントリ時間は、デバイスの詳細ページの前回のインベントリフィールドに表示されます。

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

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

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

functionName(argument,argument,...)

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

•

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

•

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

•

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

関数の構文

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

引数の構文

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

•

引数をコンマで区切る。

•

コンマは、ルールでの値としてのコンマとかっこで説明している場合を除き、文字列内のその他のどこにも許可されない。

•

一重引用符や二重引用符を含めない。

•

各引数の前後のスペースは無視される。

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

RegistryValueEquals(HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\Mozilla Firefox, CurrentVersion, 78.0.2)
RegistryValueEquals(HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\Mozilla Firefox,CurrentVersion,78.0.2)

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

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

•

パラメータ値の一部としてコンマが必要な引数では、関数内の最後の引数の場合を除き、{{comma}}としてエスケープする必要があります。

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

RegistryValueEquals(HKEY_LOCAL_MACHINE\SOFTWARE\TestSoft, test{{comma}}value, HelloWorld)

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

RegistryValueEquals(HKEY_LOCAL_MACHINE\SOFTWARE\TestSoft,test1,2,4)

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

ShellCommandTextReturn(wmic MEMORYCHIP get BankLabel,Capacity,description,manufacturer)

•

リテラルの開始かっこにはペアとなる終了かっこがないため、{{op}}としてエスケープする必要があります。パーサーは、関数の引数をトークン化する場合、開始かっこと終了かっこの数をカウントして、関数と引数の末尾を識別します。このため、ペアとなっていないリテラルの開始かっこは、カウントを誤らせ、引数値が正常に解析されない原因となります。リテラルの開始かっこが引数値の一部として必要な場合は、{{op}}で表す必要があります。

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

ShellCommandTextReturn(echo Hello {{op}} World)

•

リテラルの終了かっこにはペアとなる開始かっこがないため、{{cp}}としてエスケープする必要があります。

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

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

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

ShellCommandTextReturn(echo Hello {{cp}} World)