Asset Management の設定 › カスタム ソフトウェア シグネチャの作成方法 › DMScript の拡張

DMScript の拡張

ソフトウェア定義および検出レコードの作成

カスタム Intellisig を作成するときには、エージェント コンピュータ上で検出されるソフトウェア レコードをレポートするために Intellisig スクリプト内で DMScript 関数を呼び出します。 DMScript は、検出されたソフトウェア レコードを出力ファイルに書き込む組み込み関数を提供します。

注： DMScript は、エージェントでコマンドを実行するための共通手段を提供するスクリプト言語です。 DMScript の詳細については、CA Client Automation マニュアル選択メニューから「Desktop Management スクリプト言語」ガイドを参照してください。

Intellisig スクリプトは、以下の順序で関数を呼び出す必要があります。

1. OpenDetectedSoftwareOutputFiles
2. CreateDetectedSoftwareProduct
3. CreateDetectedSoftwareRelease
4. CreateDetectedSoftwarePatch
5. CreateDetectedSoftwareReleaseInstance
6. CloseDetectedSoftwareOutputFiles

Intellisig 関数の詳細については、「Desktop Management スクリプト言語」ガイドを参照してください。

Intellisig オブジェクトの階層

カスタム Intellisig を作成する場合、Intellisig オブジェクトの階層の理解することが重要です。 オブジェクトは、特定の階層で存在する必要があります。 各オブジェクトには親があり、前もって作成されている必要があります。 階層は、以下のようになります。

• Intellisig には、多くの製品を検出するための情報が含まれます。
• たとえば Microsoft Office の製品には、Office 2003、Office 2010 などの多数のリリースがあります。
• リリースには、修正が含まれるパッチが複数あります。
• コンピュータには、リリースの複数のインスタンス、またはパッチがインストールされています。
• 製品、リリース、およびパッチはソフトウェア定義として作成され、インスタンスは検出されるソフトウェアとして作成されます。
• オブジェクトの作成時に、DMscript は、親オブジェクトの可用性をチェックします。 たとえば、リリースを作成する場合、DMScript は、親製品が存在するかどうかを確認します。 この確認により、関連する製品、リリース、パッチ、およびインスタンスの間で適切な関係が作成されることが保証されます。

固定パラメータと可変パラメータ

検出されたソフトウェア出力ファイルを作成する関数を使用して、固定パラメータおよび可変パラメータを受け入れることにより、将来の拡張用に対する方法が提供されます。 修正されたパラメータは必須ですが、可変パラメータはオプションです。 可変パラメータには、通常 Intellisig と関連付けられ、追加のプロパティを追加するための手段となるプロパティが含まれます。 関数は、将来、既存のスクリプトに影響を与えることなく、可変パラメータを追加して拡張できます。

固定パラメータと可変パラメータの指定および使用には、以下のガイドラインが適用されます。

• 固定パラメータは必須であり、値が明示的に要求されます。
• 可変パラメータはオプションであり、OptionalProperties パラメータで指定されます。 OptionalProperties パラメータは文字列であり、以下の形式を使用して、任意の数のプロパティ名と値のペアを含むことができます。

  property=value | property=value |…
  

• | 文字を使用して、プロパティ名と値のペアを分離します。 | 文字の前後のスペースは、重要な意味を持ちません。
• OptionalProperties 内に不明のプロパティが存在する場合、警告が生成されますが、スクリプトは停止しません。 この動作により、各種リリースのエージェントは、ドメイン マネージャから送られた Intellisig スクリプトを処理できます。 スクリプトで、特定のバージョンの DMScript では認識できないプロパティが使用された場合、そのプロパティは無視されますが、DMScript トレース ログに警告が書き込まれます。
• オプション パラメータ内の不明な値により、警告が生成されます。ただし、値はエンジンに渡され、解釈または無視されます。 たとえば、bitness パラメータの値には、32 または 64 のみ使用できますが、16 を渡してもスクリプトは失敗しません。

サポートされるアーキテクチャ

以下に、ソフトウェア検出出力ファイルに検出されたレコードを書き込む DMscript 関数へ渡すことができるアーキテクチャ名のリストを示します。

• AMD64
• ARM
• Alpha
• Big Endian MIPS
• HP Precision
• IA64
• IBM S/390
• Little Endian MIPS
• Motorola 680x0
• PA_RISC
• PowerPC
• SPARC
• s390x
• x64
• x86

エラー コードおよびオプション プロパティ

LogDetectedSoftwareError メソッドは、特定の形式でエラー メッセージを受け入れます。 エラー メッセージは、エージェントに Intellisig 実行エラーがあるとき生成されるローカライズ可能な文字列です。 次に、エラー メッセージは、ドメイン マネージャに送信され、DSM エクスプローラ内のソフトウェア インベントリ収集タスクに対するステータス コメントとして表示されます。

例： LogDetectedSoftwareError

LogDetectedSoftwareError("ISE:00400","PARAM5=Microsoft Windows 7 Ultimate x64 64 en-us|PARAM6=VersionNumber=6.1.7600 |VersionLabel=6.1.7600 |Language=en-us |Bitness=64 |Architecture=x64 |Manufacturer=Microsoft Corporation|Category=Operating Systems |Description=The Microsoft Windows 7 Product|PARAM7=SWDETECT_BADARGS");

Intellisig スキャナは、自動的に以下のエラー メッセージを生成して、Intellisig の起動に関連する問題を報告します。

以下のエラー メッセージを生成して、Intellisig の作成に関連する問題を処理できます。