前のトピック: CreateDetectedSoftwareReleaseInstance次のトピック: LogDetectedSoftwareError


CreateDetectedSoftwarePatchInstance

スクリプトが特定パッチのインスタンスを検出すると、CreateDetectedSoftwarePatchInstance 関数が、ソフトウェア検出出力ファイルにレコードを追加します。

関数の形式

CreateDetectedSoftwarePatchInstance (ProductName as String, ProductVersionLabel, as String, ReleaseName as String, ReleaseVersionLabel as String, PatchName as String, PatchVersionLabel as String, OptionalProperties as String) as an integer

例: CreateDetectedSoftwarePatchInstance

CreateDetectedSoftwarePatchInstance ("Microsoft Windows 7 Ultimate", "6.1", "Microsoft Windows 7 Ultimate x64 64 en-us", "6.1.7600", "KB971033 x64 64 en-us", "", "Origin=Forward Inc |TrustLevel=5 |")

注: この関数は、各スクリプト内で CreateDetectedSoftwarePatch 関数を呼び出した後で呼び出す必要があります。 CreateDetectedSoftwarePatchInstance 関数は、インスタンス数と同じ回数だけ呼び出すことができます。 各インスタンスは、検出された個別のソフトウェア レコードを取得します。

: 2 つの別々の Intellisig で同じソフトウェア インスタンスが検出される場合、2 つの個別の検出レコードが Intellisig ごとに作成されます。

入力パラメータ

この関数には、以下の入力パラメータがあります。

ProductName

パッチが所属する製品の名前を指定します。 スクリプト内で、この製品に対して CreateDetectedSoftwareProduct 関数を呼び出している必要があります。

ProductVersionLabel

製品のバージョン ラベルを指定します。

ReleaseName

パッチが所属するリリースの名前を指定します。 スクリプト内で、このリリースに対して CreateDetectedSoftwareRelease 関数を呼び出している必要があります。

ReleaseVersionLabel

リリースのバージョン ラベルを指定します。

PatchName

検出されるソフトウェア パッチの名前を指定します。 スクリプト内で、このリリースに対して CreateDetectedSoftwarePatch 関数を呼び出している必要があります。

PatchVersionLabel

パッチのバージョン ラベルを指定します。

OptionalProperties

検出されたソフトウェア インスタンスに関連付けられるオプションのプロパティを指定します。 インスタンスに対して、以下のオプションのプロパティを使用できます。

ProductGUID

スクリプトによって検出される製品 UUID を指定します。

Label

このインスタンス用の一意のラベルを指定します。

Origin

Intellisig 作成者の名前を指定します。

TrustLevel

Intellisig、スクリプト、またはその両方の作成者の信頼レベルを指定します。

InstallPath

エージェント コンピュータ上の製品インストール ディレクトリまたは実行可能ファイルへのパスを指定します。

SerialNumber

インスタンスのシリアル番号を指定します。

LastAccessed

インスタンスが最後にアクセスされた日時を指定します。 yyyy-mm-dd-hr:mm 形式で値を指定します。 この値は、ローカル時間であると仮定されます。

注: 時間を処理する dmscript 内のその他のすべての関数は、ローカル時間で動作します。 dmscript は、出力の前に時間値を UNIX 形式(1-1-1970 UTC からの秒数)に変換します。 DSM エクスプローラは、実行されているマシン上でローカル タイム ゾーンを使用して、これを表示します。

CustomData

インスタンスに関して格納する別の任意のカスタム データを指定します。

戻り値

CA_SWDETECT_OK

関数が操作を正常に完了したことを示します。

CASWDETECT_BADARGS

関数に渡された 1 つ以上の必須パラメータが空白あることを示します。

CASWDETECT_FILE_ERROR

関数が、ファイルへの書き込みに失敗したことを示します。 詳細については、ログ ファイルを参照してください。