前のトピック: CreateDetectedSoftwareProduct次のトピック: CreateDetectedSoftwarePatch


CreateDetectedSoftwareRelease

スクリプトがエージェント コンピュータ上で製品のリリースを検出すると、CreateDetectedSoftwareRelease 関数が、ソフトウェア検出出力ファイルにレコードを追加します。

注: DMScript は、MDB 内で関連する製品レコードを見つけた場合にのみレコードを追加します。

この関数の形式は、以下のとおりです。

CreateDetectedSoftwareRelease (ProductName as String, ProductVersionLabel, as String, ReleaseName as String, ReleaseVersionLabel as String, OptionalProperties as String) as an integer

例:

CreateDetectedSoftwareRelease ("Microsoft Windows 7 Ultimate", "6.1", "Microsoft Windows 7 Ultimate x64 64 en-us", "6.1.7600", "VersionNumber=6.1.7600 |Language=en-us |Bitness=64 |Architecture=x64 |Manufacturer=Microsoft Corporation|Category=Operating Systems |Description=The Microsoft Windows 7 Release")

入力パラメータ

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

ProductName

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

ProductVersionLabel

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

注: バージョン ラベルは、製品とその名前の識別に使用されます。 空の値が許可されており、空のバージョンを持つ製品として扱われます。

ReleaseName

検出されるソフトウェア リリースを指定します。

注: リリースは、製品と同じ名前を持つことができます。 ただし、Intellisig は、異なるリリース名をサポートしており、同じ製品に複数のリリースを関連付けることができます。 リリース名とバージョン ラベルは、各 Intellisig チェーン内で一意である必要があります。 Intellisig 内で同じ名前を持つ 2 つのリリースは、オプション パラメータにかかわらず、同じ親定義を共有する場合にのみ同じリリースとして扱われます。 2 つの別々の Intellisig を使用して同じリリースが検出される場合、2 つの個別の検出レコードが Intellisig ごとに作成されます。

ReleaseVersionLabel

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

注: バージョン ラベルは、リリースとその名前の識別に使用されます。 空の値が許可されており、空のバージョンを持つリリースとして扱われます。

OptionalProperties

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

VersionNumber

リリースのバージョン番号を指定します。

Language

リリースがインストールされている言語を指定します。

Bitness

リリースが 32 ビットまたは 64 ビット アーキテクチャを使用するかどうかを指定します。

Architecture

アーキテクチャ名を指定します。

メーカー

リリースの製造元の名前を指定します。

Category

リリース カテゴリを指定します。

ManufacturerUUID

リリースの製造元の UUID を指定します。

CategoryUUID

リリース カテゴリの UUID を指定します。

説明

リリースの説明を指定します。

戻り値

CA_SWDETECT_OK

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

CASWDETECT_BADARGS

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

CASWDETECT_FILE_ERROR

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