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

文字	説明	式の例	ターゲットファイル	マッチするファイル
（任意の文字列）	特殊文字以外の文字を入力すると、その文字列が含まれるすべてのファイル名とマッチします。	abc	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	abcFile.xls Myabc.txt MyFile.abc
.	ドットは任意の1文字とマッチします。単独で入力すると、すべてのファイルとマッチします。	.	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc
\	バックスラッシュが特殊文字をエスケープ処理し、前方参照を作成するために使用されます。詳細については、http://rexegg.com/regex-capture.htmlを参照してください。	.*\.txt$	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	Myabc.txt
^	キャレットは、指定した文字をファイル名の先頭でマッチさせます。	^k	install.exe kinstaller.exe runkbot.bat	kinstaller.exe
\|	パイプは、マッチさせる一連のオプションを区切ります。	run\|install	install.exe kinstaller.exe runkbot.bat	install.exe kinstaller.exe runkbot.bat
$	ドルは、指定した文字をファイル名の末尾でマッチさせます。	bat$	install.exe kinstaller.exe runkbot.bat	runkbot.bat
?	疑問符は、直前の文字と0回または1回マッチします。	\.log10?$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 mylog.log10
*	アスタリスクは、直前の文字と0回以上マッチします。	\.log1*$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 app.log appconf.log11
+	正符号は、直前の文字と1回以上マッチします。	ap+.*\.log	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log appconf.log11
[ ]	角かっこは、文字クラスを囲み、角かっこ内の任意の1文字とマッチします。文字クラスの特殊文字のルールが通常の正規表現と異なります。	[123]	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 afile.txt3 appconf.log11 mylog.log10
()	文字を丸かっこで囲むと、後方参照が作成され、前の文字または囲んだ文字、あるいはその両方とマッチします。詳細については、http://rexegg.com/regex-capture.htmlを参照してください。	(p)\1	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log appconf.log11
{n}	中かっこは、指定した回数だけ直前の文字を繰り返します。ここで、nは1以上です。	{p}\.log$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log

正規表現ルールのリファレンス

正規表現ルールの構文は、他のファイルルールとはわずかに異なります。fullpath引数はファイルの場所への絶対パスにマッチする文字列ですが、ファイル名を含みません。ファイル名は、正規表現を使用して個別の引数として指定します。

次の表に、正規表現を使用できる一連のルールを示します。

構文	Win	RHEL	OS X	説明
FilenamesMatchingRegexExist (fullpath,regex)	X	X	X	指定したディレクトリ内のいずれかのファイルが正規表現を使用して入力したファイル名にマッチする場合は、trueが返されます。
FilenamesMatchingRegexGreaterThan (fullpath,regex,value)	X	X	X	マッチするファイルの数が指定した値より大きい場合は、trueが返されます。
FilenamesMatchingRegexLessThan (fullpath,regex,value)	X	X	X	マッチするファイルの数が指定した値より小さい場合は、trueが返されます。
FilenamesMatchingRegexEqual (fullpath,regex,value)	X	X	X	マッチするファイルの数が指定した値と同じ場合は、trueが返されます。
FilenamesMatchingRegexReturn (fullpath,regex,type)	X	X	X	カスタムインベントリフィールドにマッチしたファイル名（パスを含む）を設定します。

ルールでの引数の定義

カスタムインベントリルールで引数を定義して、パス、ファイル、レジストリキー、レジストリエントリ、バージョン情報、環境変数、およびその他の属性を検索できます。

ルールの構文については、条件の確認（条件付きルール）、デバイス（カスタムインベントリフィールド）からの値の取得、および正規表現を使用したファイル名のマッチの表を参照してください。

パスまたはファイルの検索

pathとfullpathは、デバイス上のディレクトリまたはファイルへの絶対パスを指定する文字列です。例：

C:\Program Files\Mozilla Firefox\firefox.exe

KACE エージェントはディレクトリまたはファイルを見つけて、特定のテストを行います。

レジストリキーとエントリの検索

registryPathは、レジストリ内のレジストリキーへの絶対パスを指定する文字列です。例：

HKEY_LOCAL_MACHINE/application/kace

バージョンの指定

version は、KACE エージェントがデバイスでテストするアイテムのバージョンと比較する整数（型は TEXT）です。

例えば、FileVersionGreaterThanテストでは、指定した値がファイルまたはフォルダのバージョン番号より大きい場合は「true」が返され、それ以外の場合は「false」が返されます。

範囲をテストするには、Less ThanとGreater Thanのルールを次のように連結します。

FileVersionGreaterThan(C:\Program Files\Adobe\Acrobat\7.0\Acrobat\Acrobat.exe, 6.99)

「および」FileVersionLessThan(C:\Program Files\Adobe\Acrobat\7.0\

Acrobat\Acrobat.exe, 8.00)

環境またはユーザー変数の指定

varは、デバイス上の環境変数の実際の名前にマッチする文字列です。

例えば、Program Filesディレクトリ変数が正しく設定されていることをテストするには、次のように入力します。

EnvironmentVariableEquals(ProgramFiles, TEXT,

C:\Program Files)

ファイル属性の指定

attribute は、システムプロパティ、ファイル / フォルダのプロパティ、またはデバイス上で KACE エージェントに割り当てられたプロパティです。アプライアンスには、オペレーティングシステムに依存した引数の型が用意されています。

Windowsファイル属性の使用

FileInfoGreaterThan、FileInfoLessThan、FileInfoEquals の各関数を使用して、Windows 上のファイルプロパティを次の構文でテストできます。

FunctionName (fullpath, attribute, type, value)

次の表に、Windowsでサポートされる属性を示します。

属性	タイプ	説明
AccessedDate	日付	ファイルがアクセスされた前回の日時。
Comments	テキスト	診断目的に提供する追加の情報。
CompanyName	テキスト	ファイルを生成した会社の名前。
CreatedDate	日付	ファイルが作成された日付。
FileBuildPart	番号	ファイルのバージョンの3番目の数字。例：バージョン1.2.3の場合、3=ビルド。
FileDescription	テキスト	Windowsファイルプロパティの詳細ページのファイルの説明。
FileMajorPart	番号	ファイルのバージョンの1番目の数字。例：バージョン1.2.3の場合、1=メジャー。
FileMinorPart	番号	ファイルのバージョンの2番目の数字。例：バージョン1.2.3の場合、2=マイナー。
FileName	テキスト	ファイルの現在の名前。FileExistsも参照してください。
FilePrivatePart	番号	ファイルのバージョンの4番目の数字。例：バージョン1.2.3.4の場合、4=プライベート。
FileVersion	テキスト	ファイルプロパティの詳細ページに表示された完全なファイルのバージョン。 FileVersionEquals、FileVersionGreaterThan、およびFileVersionLessThanも参照してください。
InternalName	テキスト	コンポーネント名などの、ファイルの内部名（存在する場合）。ファイルに内部名がない場合、拡張子を省いた元のファイル名と同じです。
言語	テキスト	言語コード。ファイルプロパティの詳細ページに表示されている対応する名前です。
LegalCopyright	テキスト	ファイルに適用される著作権情報。
LegalTrademarks	テキスト	ファイルに適用される商標と登録商標。
ModifiedDate	日付	ファイルが修正された前回の日時。
OriginalFilename	テキスト	デバイスに配置またはインストールされたときのファイルのフルネームを指定します。
PrivateBuild	テキスト	ファイルのバージョンに関する情報。
ProductBuildPart	番号	製品のバージョンの3番目の数字。例：バージョン1.2.3の場合、3=ビルド。
ProductMajorPart	番号	製品のバージョンの1番目の数字。例：バージョン1.2.3の場合、1=メジャー。
ProductMinorPart	番号	製品のバージョンの2番目の数字。例：バージョン1.2.3の場合、2=マイナー。
ProductName	テキスト	Windowsのプロパティの製品名にマッチする文字列。
ProductPrivatePart	番号	製品のバージョンの4番目の数字。例：バージョン1.2.3.4の場合、4=プライベート。
ProductVersion	テキスト	製品版。 ProductVersionEquals、ProductVersionGreaterThan、およびProductVersionLessThanも参照してください。
SpecialBuild	テキスト	ビルドに関する追加の情報。

LinuxとMacのファイル属性のテスト

LinuxデバイスとMacデバイス上で、次の引数を使用してファイル属性をテストできます。

データ型の指定

typeは、テストされるか返されるデータの型を識別します。

KACE エージェントは次の型をサポートしています。

•

TEXT - 文字列です。Equalsのような条件付きルールで完全に一致する場合にのみ有効です。ValueReturnルールでは、「カスタムインベントリフィールド」のタイプが文字列に設定されるため、検索条件とフィルタはマッチ演算子に制限されます。

•

NUMBER - 整数です。すべての条件付きルールで有効なため、比較対象として整数を指定できます。

•

DATE - 必ず MM/dd/yyyy HH:mm:ss の形式にしてください。例：09/28/2006 05:03:51。時刻は必須です。例えばgreater thanのような比較で、少なくとも00:00:00として時刻を指定する必要があります。

•

PackageGroupsというアレイ内のキーItem 0は、引数にPackageGroups:0を使用して参照されます。

•

Item 102という辞書内のキーcontentTypeは、引数に102:contentTypeを使用して参照されます。

正規表現の使用

regexは、条件付きルールまたは値戻しルールでファイル名にマッチさせる正規表現です。詳細については、正規表現を使用したファイル名のマッチを参照してください。

コマンドの定義

シェルコマンド関数を使用すると、デバイスで実行するコマンドを指定できます。ルールの引数を記述するためのガイドラインはコマンドに適用されません。ただし、開始かっこの直後と終了かっこの直前のスペースはコマンドから削除されます。

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

カスタムインベントリルールをテストするために、KACE エージェント管理対象デバイスでカスタムインベントリコマンドを実行することができます。この機能により、インベントリプロセス全体を実行せずにカスタムインベントリルールをデバッグできます。

KACE エージェントがインストールされているデバイスで、コマンドプロンプトを開きます。

次のコマンドを入力します。kdeploy -custominventory

エージェントがアプライアンスに接続し、カスタムインベントリを実行します。クエリと戻り値が表示されます。

属性	タイプ	説明
access_time	日付	ユーザーまたはシステムがファイルに前回アクセスした時刻
block_size	番号	ファイルのブロックサイズ
blocks	番号	ファイルによって使用されているブロックの数
creation_time	日付	ファイルが作成された時刻
device_number	番号	ファイルが格納されているデバイス（ディスク）の識別番号
group	テキスト	ファイル所有者のグループ名
inode	番号	ファイルのinode番号
modification_time	日付	変更が前回加えられたか保存された時刻
number_links	番号	ファイルへのハードリンクの数
owner	テキスト	ファイルを所有するユーザーの名前
size	番号	ファイルのサイズ

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

正規表現の理解

正規表現の理解

正規表現ルールのリファレンス

正規表現ルールのリファレンス

ルールでの引数の定義

ルールでの引数の定義

パスまたはファイルの検索

レジストリキーとエントリの検索

バージョンの指定

環境またはユーザー変数の指定

ファイル属性の指定

Windowsファイル属性の使用

LinuxとMacのファイル属性のテスト

データ型の指定

テストする値の指定

レジストリエントリの名前の指定（Windowsのみ）

PLISTキーの指定（Macのみ）

正規表現の使用

コマンドの定義

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

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

製品を選択してください:

サービス向上のために、「Purpose of your Chat（チャットの目的）」を記入してください。

お客様の不具合に推奨されるソリューション

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

正規表現の理解

正規表現ルールのリファレンス

ルールでの引数の定義

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