KACE Asset Management Appliance 7.1 - Administrator Guide (Japanese)

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

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

K1000管理者コンソール（http://K1000_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)

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

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

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

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

保存をクリックします。

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

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

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

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

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

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

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

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

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

functionName(argument,argument,...)

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

•

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

•

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

•

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

関数の構文

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

引数の構文

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

•

引数をコンマで区切る。

•

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

•

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

•

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

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

RegistryValueEquals(HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\
Version Vector, IE, 10.000)
RegistryValueEquals(HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\
Version Vector,IE,10.000)

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

コンマ、開始かっこ、または終了かっこをルール内の値として使用する場合、{{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)

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

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

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

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

•

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

•

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

•

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

•

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

•

複数の条件のテスト

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

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

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

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

比較関数でサポートされるデータ型
条件付きルール	比較関数でサポートされるデータ型「Equals」、「GreaterThan」、「LessThan」
EnvironmentVariable	DATE、NUMBER、TEXT
FileInfo	DATE、NUMBER、TEXT
FilenamesMatchingRegex	NUMBER
FileVersion	TEXT
PlistValue	NUMBER、TEXT
ProductVersion	TEXT
RegistryValue	TEXT

•

評価の前に、PHP DateTimeクラスと同じルールを使用してターゲット値が日付として解析され、次の書式を使用するように標準化されます:

MM/DD/YYYY HH:MM:SS

•

K1000データベースにリストされるタイムスタンプは、24時間表記（0～24時）を使用します。

•

K1000データベースにリストされるタイムスタンプはUTC（協定世界時）時刻を反映するので、タイムゾーンに関係なく、すべてのデバイスに対して標準化されます。

•

ターゲット値に日付のみが含まれている場合、UTCの深夜零時に基づくタイムスタンプが追加されます。

NUMBER

•

整数のみが評価されます。

•

ターゲット値に他の文字（アルファベット、句読点など）が含まれている場合、最初の非数値までの数値が評価されます。

例えば、ターゲット値が52a1の場合、52のみが評価されます。

•

32ビットで表される正の最大整数値（2,147,483,647）までの数がサポートされます。

TEXT

•

値は文字通りに評価され、DATEおよびNUMBERのデータ型で発生するような書式変換は何も行われません。

•

テキスト文字列は、辞書式順序で評価されます。

•

コンマを評価対象の文字列に含めることができます。エスケープ処理は必要ありません。

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

条件付きルールのリファレンス
構文	Win	RHEL	OS X	説明
DirectoryExists (path)	X	X	X	デバイス上の指定したパスにあるディレクトリを確認します。
FileExists (path)	X	X	X	デバイス上の指定したパスにあるファイルを確認します。パスにはファイルの名前と拡張子を含めます。
FileVersionEquals (path, version)	X			パスにある指定したファイルのバージョン > ファイルのバージョンプロパティが、入力した TEXT 値に一致することを確認します。
FileVersionLessThan (path, version)	X			パスにある指定したファイルのバージョン > ファイルのバージョンプロパティが、入力した TEXT 値より小さいことを確認します。
FileVersionGreaterThan (path, version)	X			指定したファイルのバージョン > ファイルのバージョンプロパティが、入力した TEXT 値より大きいことを確認します。
ProductVersionEquals (path, version)	X			指定した実行可能ファイルまたはインストールファイルのバージョン > 製品のバージョンプロパティが、入力した TEXT 値に一致することを確認します。
ProductVersionLessThan (path, version)	X			指定した実行可能ファイルまたはインストールファイルのバージョン > 製品のバージョンプロパティが、入力した TEXT 値より小さいことを確認します。
ProductVersionGreaterThan (path, version)	X			指定した実行可能ファイルまたはインストールファイルのバージョン > 製品のバージョンプロパティが、入力した TEXT 値より大きいことを確認します。
FileInfoGreaterThan (fullpath, attribute, type, value)	X	X	X	指定した実行可能ファイルまたはインストールファイルの「ファイル情報」プロパティが、入力した値よりも大きいことを確認します。
FileInfoLessThan (fullpath, attribute, type, value)	X	X	X	指定した実行可能ファイルまたはインストールファイルの「ファイル情報」プロパティが、入力した値よりも小さいことを確認します。
FileInfoEquals (fullpath, attribute, type, value)	X	X	X	指定した実行可能ファイルまたはインストールファイルの属性が、入力した値に一致することを確認します。
RegistryKeyExists (registryPath)	X			レジストリキーが存在することを確認します。
RegistryValueEquals (registryPath, valueName, value)	X			レジストリエントリが、指定した値に完全に一致することを確認します。値はTEXTとして比較されます。
RegistryValueLessThan (registryPath, valueName, value)	X			レジストリエントリが、指定した値より小さいことを確認します。値はTEXTです。
RegistryValueGreaterThan (registryPath, valueName, value)	X			レジストリエントリが、指定した値より大きいことを確認します。値はTEXTです。
EnvironmentalVariableExists (var)	X	X	X	指定した名前の環境変数が存在することを確認します。
EnvironmentalVariableGreaterThan (var, type, value)	X	X	X	環境変数定義が、指定した値より大きいことを確認します。 TEXT、DATE（完全な形式はmm/dd/yyyy hh:mm:ss）、およびNUMBERの3つすべてが有効な型です。
EnvironmentalVariableLessThan (var, type, value)	X	X	X	環境変数定義が、指定した値より小さいことを確認します。 TEXT、DATE（完全な形式はmm/dd/yyyy hh:mm:ss）、およびNUMBERの3つすべてが有効な型です。
EnvironmentalVariableEquals (var, type, value)	X	X	X	環境変数定義が、指定した値に完全に一致することを確認します。 TEXT、DATE（完全な形式はmm/dd/yyyy hh:mm:ss）、およびNUMBERの3つすべてが有効な型です。
PlistValueExists (fullpath, entry)			X	名前付きの値がPLISTファイルに存在することを確認します。
PlistValueGreaterThan (fullpath, entry, type, value)			X	名前付きの値が、指定した値より大きいNUMBERまたはTEXTであることを確認します。
PlistValueLessThan (fullpath, entry, type, value)			X	名前付きの値が、指定した値より小さいNUMBERまたはTEXTであることを確認します。
PlistValueEquals (fullpath, entry, type, value)			X	名前付きの値が、指定した値に完全に一致するNUMBERまたはTEXTであることを確認します。

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

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

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

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

•

DirectoryExists (path)

•

FileExists (path)

•

RegistryKeyExists (registryPath)

•

EnvironmentalVariableExists (var)

•

PlistValueExists (fullpath, entry)

•

FilenameMatchingRegexExist (fullpath, regex)

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

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

DirectoryExists(C:\WINDOWS\)

例: ファイルを確認する

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

FileExists(C:\WINDOWS\notepad.exe)

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

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

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

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

•

FileVersionEquals (path, version)

•

ProductVersionEquals (path, version)

•

FileInfoEquals (fullpath, attribute, type, value)

•

RegistryValueEquals (registryPath, valueName, value)

•

EnvironmentalVariableEquals (var, type, value)

•

PlistValueEquals (fullpath, entry, type, value)

•

FilenameMatchingRegexEqual (fullpath, regex, value)

例: JAVA_HOME設定をテストする

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

EnvironmentVariableEquals(JAVA_HOME, TEXT, C:\Program Files\Java\jdk1.6.0_02)

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

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

RegistryValueEquals(HKEY_LOCAL_MACHINE\Software\McAfee\AVEngine, AVDatDate, 2014/03/01)

例: Internet Explorerのバージョンをテストする

Internet Explorerがバージョン10.0.9200.17148であることを確認します。

FileVersionEquals(C:\Program Files\Internet Explorer\iexplore.exe, 10.0.9200.17148)

10.0.9としてバージョンを指定すると、falseが返されます。Equals 関数のバージョン引数は、正確に指定する必要があります。完全なバージョン値より短い部分的な値を指定すると、失敗します。

例: Windows XP Service Pack 2を検出する

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

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

RegistryValueEquals(HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\

CurrentVersion,CSDVersion,Service Pack 2)

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