DMScript-Erweiterungen

Konfigurieren von Asset Management › So erstellen Sie benutzerdefinierte Software-Signaturen › DMScript-Erweiterungen

DMScript-Erweiterungen

Erstellen von Softwaredefinitionen und Erkennungsdatensätzen

Wenn Sie benutzerdefinierte Intellisigs erstellen, rufen Sie die DMScript-Funktionen innerhalb Ihres Intellisig-Skript auf, um über Softwaredatensätze zu berichten, die auf dem Agent-Computer gefunden wurden. DMScript stellt integrierte Funktionen bereit, die Datensätze zu gefundener Software in einer Ausgabedatei aufzeichnen.

Hinweis: DMScript ist eine Skripterstellungssprache, die der Ausführung von Befehlen auf Agenten dient. Weitere Informationen zu DMScript finden Sie im Handbuch Desktop Management Scripting-Sprache im Bookshelf zu CA Client Automation.

Das Intellisig-Skript muss die Funktionen in der folgenden Reihenfolge aufrufen:

OpenDetectedSoftwareOutputFiles
CreateDetectedSoftwareProduct
CreateDetectedSoftwareRelease
CreateDetectedSoftwarePatch
CreateDetectedSoftwareReleaseInstance
CloseDetectedSoftwareOutputFiles

Weitere Informationen über Intellisigs-Funktionen finden Sie im Handbuch "Desktop Management Scripting-Sprache".

Hierarchie von Intellisig-Objekten

Das Verstehen der Hierarchie von Intellisig-Objekten ist es wichtig, wenn Sie benutzerdefinierte Intellisigs erstellen. Die Objekte müssen in einer bestimmten Hierarchie vorhanden sein. Jedes Objekt hat ein übergeordnetes Objekt, das im Voraus erstellt werden muss. Die Hierarchie ist folgendermaßen aufgebaut:

Diagramm mit Intellisig-Hierarchie

Ein Intellisig enthält Informationen, um eine Anzahl von Produkten zu erkennen.
Ein Produkt, zum Beispiel Microsoft Office, hat verschiedene Releases wie Office 2003, Office 2010 usw.
Zu einem Release gehört eine Anzahl von Patches, die Fehlerbehebungen enthalten.
Ein Computer enthält eine Anzahl von Instanzen von einem installierten Release oder Patch.
Produkte, Releases und Patches werden als Softwaredefinitionen erstellt und Instanzen als erkannte Software.
Wenn ein Objekt erstellt wird, überprüft DMscript die Verfügbarkeit des übergeordneten Objekts. Wenn zum Beispiel ein Release erstellt wird, überprüft DMScript, ob das übergeordnete Produkt vorhanden ist. Diese Überprüfung hilft sicherzustellen, dass richtige Beziehungen zwischen dem betreffenden Produkt, Release, Patch und Instanzen erstellt werden.

Feste und veränderliche Parameter

Die Funktionen für das Erstellen von Ausgabedateien für gefundene Software bieten eine Möglichkeit für künftige Erweiterungen durch das Annehmen fester Parameter und veränderlicher Parameter. Während feste Parameter obligatorisch sind, sind veränderliche Parameter optional. Veränderliche Parameter schließen normalerweise die Eigenschaften ein, die dem Intellisig zugeordnet werden, und bieten eine Möglichkeit für das Hinzufügen zusätzlicher Eigenschaften. Die Funktionen können künftig erweitert werden, um veränderliche Parameter hinzuzufügen, ohne vorhandene Skripte zu beeinträchtigen.

Die folgenden Richtlinien gelten für die Angabe und Verwendugn von festen und veränderlichen Parametern:

Feste Parameter sind obligatorisch und erfordern ausdrücklich Werte.
Veränderliche Parameter sind optional und werden im OptionalProperties-Parameter angegeben. Der OptionalProperties-Parameter ist eine Zeichenfolge und kann eine beliebige Anzahl von Eigenschaftsnamen und Wertpaaren im folgenden Format enthalten:
```
property=value | property=value |…
```
Verwenden Sie das |-Zeichen, um den Eigenschaftsnamen-/Wertpaare voneinander zu trennen. Leerzeichen vor und nach dem Zeichen | sind unwichtig.
Unbekannte Eigenschaften in OptionalProperties generieren Warnungen, aber halten das Skript nicht an. Dieses Verhalten lässt die Agenten verschiedener Releases Intellisig-Skripte verarbeiten, die vom Domänen-Manager gesendet wurden. Wenn ein Skript eine Eigenschaft verwendet, die einer bestimmten DMScript-Version unbekannt ist, wird die Eigenschaft ignoriert, aber eine Warnung wird in das DMScript-Verfolgungsprotokoll geschrieben.
Unbekannte Werte in den optionalen Parametern verursachen eine Warnung, aber der Wert wird an die Engine zum Interpretieren oder Ignorieren weitergegeben. Zum Beispiel kann der Wert des Bitness-Parameters nur 32 oder 64 sein, aber wenn Sie 16 übergeben, schlägt das Skript nicht fehl.

Unterstützte Architekturen

Nachfolgend finden Sie die Liste von Architekturnamen, die Sie den DMscript-Funktionen übergeben können, die die gefundenen Datensätze in die Softwareerkennungs-Ausgabedatei schreiben:

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

Fehlercodes und optionale Eigenschaften

Die LogDetectedSoftwareError-Methode nimmt die Fehlermeldungen in einem bestimmten Format an. Die Fehlermeldungen sind lokalisierbare Zeichenfolgen, die generiert werden, wenn es einen Intellisig-Ausführungsfehler auf dem Agenten gibt. Die Fehlermeldungen werden dann an den Domänen-Manager gesendet und als ein Statuskommentar für den Softwareinventar-Erfassungstask im DSM-Explorer angezeigt.

Beispiel: 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");

Der Intellisig-Scanner gibt automatisch die folgenden Fehlermeldungen aus, um zu melden, dass es Probleme beim Starten eines Intellisigs gibt:

Fehlercode	Fehlertext
ISE:00302	The intellisig named %1$t, version %2$t, UUID %3$t, is missing the mandatory parameter %4$t.
ISE:00303	Intellisig named %1$t, version %2$t, UUID %3$t, script file %4$t did not produce an output file.
ISE:00304	The execution of Intellisig named %1$t, version %2$t, UUID %3$t, script file %4$t has exceeded the allowable timeout (%5$t seconds).
ISE:00305	Intellisig named %1$t, version %2$t, UUID %3$t, script file %4$t could not be found.
ISE:00306	Intellisig named %1$t, version %2$t, uuid %3$t, script file %4$t, caused an internal error while attempting to start an intellisig
ISE:00307	The dmscript intepreter reported an error parsing the Intellisig named %1$t, version %2$t, uuid %3$t, script file %4$t
ISE:00405	Intellisig %1$t version %2$t, UUID %3$t, script %4$t, %5$t was called to create "%6$t" with an unknown parent "%7$t".
ISE:00406	Intellisig %1$t version %2$t, UUID %3$t, script %4$t, %5$t was called to create "%6$t" with a parent "%7$t" of the wrong type.
ISE:00407	Intellisig %1$t version %2$t, UUID %3$t, script %4$t, %5$t was called to create an instance with a parent "%6$t"of the wrong type.
ISE:00411	Intellisig %1$t version %2$t, UUID %3$t, script %4$t, %5$t was called with mandatory property "%6$t" set to blank.
ISE:00412	Intellisig %1$t version %2$t, UUID %3$t, script %4$t, the lastaccessed property was specified with an invalid value: %5$t: should be in the format: yyyy-mm-dd:hh:mm.

Sie können die folgenden Fehlermeldungen ausgeben, um Probleme beim Erstellen eines Intellisigs zu beheben:

Fehlercode	Fehlertext	Funktionssyntax
ISE:00400	Intellisig %1$t version %2$t, UUID %3$t, script %4$t, Failed to create software product. The parameters were ProductName:%5$t OptionalProperties : %6$t. Return Code : %7$t	LogDetectedSoftwareError ("ISE:00400", "PARAM5=ProductName\|PARAM6=OptionalProperties\|PARAM7=ReturnCode")
ISE:00401	Intellisig %1$t version %2$t, UUID %1$t, script %4$t, Failed to create Software Release. The parameters were ProductName:%5$t ReleaseNameProductRelease:%6$t OptionalProperties %7$t. Return Code : %8$t	LogDetectedSoftwareError ("ISE:00401", "PARAM5=ProductName\|PARAM6=ReleaseName\|PARAM7=OptionalProperties\|PARAM8=ReturnCode")
ISE:00402	Intellisig %1$t version %2$t, UUID %3$t, script %4$t, Failed to create Software Patch. The parameters were ReleaseName:%5$t PatchName:%6$t OptionalProperties %7$t. Return Code: %8$t	LogDetectedSoftwareError ("ISE:00402", "PARAM5= ReleaseName\|PARAM6=PatchName\|PARAM7=OptionalProperties\|PARAM8=ReturnCode")
ISE:00403	Intellisig %1$t version %2$t, UUID %3$t, script %4$t, Failed to create Software Instance. The parameters were PatchName:%5$t OptionalProperties: %6$t. Return Code : %7$t	LogDetectedSoftwareError ("ISE:00403", "PARAM5= PatchName\|PARAM6=OptionalProperties\|PARAM7=ReturnCode")
ISE:00404	Intellisig %1$t version %2$t, UUID %3$t, script %4$t, produced the following error : %5$t Hinweis: Sie können einen benutzerdefinierten Fehlertext in PARAM5 angeben.	LogDetectedSoftwareError ("ISE:00404", "PARAM5="Ein unerwarteter Fehler ist aufgetreten")