Vorheriges Thema: CreateDetectedSoftwareProductNächstes Thema: CreateDetectedSoftwarePatch


CreateDetectedSoftwareRelease

Die CreateDetectedSoftwareRelease-Funktion fügt einen Datensatz zur Softwareerkennungs-Ausgabedatei hinzu, wenn das Skript einen Release eines Produkt auf dem Agent-Computer findet.

Hinweis: DMScript fügt den Datensatz nur hinzu, wenn es den zugehörigen Produktdatensatz in der MDB findet.

Diese Funktion hat das folgende Format:

CreateDetectedSoftwareRelease (ProductName als String, ProductVersionLabel, als String, ReleaseName als String, ReleaseVersionLabel als String, OptionalProperties als String) als Integer

Beispiel:

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")

Eingabeparameter

Diese Funktion hat die folgenden Eingabeparameter:

ProductName

Gibt den Produktnamen an, zu dem der Release gehört. Sie müssen die CreateDetectedSoftwareProduct-Funktion für dieses Produkt innerhalb des Skripts aufgerufen haben.

ProductVersionLabel

Gibt die Versionsbezeichnung des Produkts an.

Hinweis: Die Versionsbezeichnung wird verwendet, um das Produkt zusammen mit seinem Namen zu identifizieren. Ein leerer Wert ist erlaubt und wird als ein Produkt mit einer leeren Version betrachtet.

ReleaseName

Gibt den Namen der erkannten Software an.

Hinweis: Ein Release kann denselben Namen wie das Produkt haben. Allerdings unterstützen Intellisigs unterschiedliche Releasenamen, um dabei zu helfen, mehrere Releases zum gleichen Produkt zuzuordnen. Der Releasename und die Versionsbezeichnung müssen innerhalb jeder Intellisig-Kette eindeutig sein. Zwei Releases mit demselben Namen innerhalb eines Intellisigs werden nur dann als der gleiche Release betrachtet, wenn sie die gleichen übergeordneten Definitionen nutzen, ungeachtet der optionalen Parameter. Wenn der gleiche Release mithilfe zwei verschiedener Intellisigs gefunden wird, werden zwei getrennte gefundene Datensätze erstellt, einer für jedes Intellisig.

ReleaseVersionLabel

Gibt die Versionsbezeichnung des Release an.

Hinweis: Die Versionsbezeichnung wird verwendet, um den Release zusammen mit seinem Namen zu identifizieren. Ein leerer Wert ist erlaubt und wird als ein Release mit einer leeren Version betrachtet.

OptionalProperties

Gibt die dem erkannten Softwarerelease zugeordneten optionalen Eigenschaften an. Folgende optionale Eigenschaften sind für Releases verfügbar:

VersionNumber

Gibt die Versionsnummer des Release an.

Sprache

Gibt die Sprache an, in der der Release installiert ist.

Bitanzahl

Gibt an, ob der Release 32-Bit- oder 64-Bit-Architektur verwendet.

Architektur

Gibt den Namen der Architektur an.

Hersteller

Gibt den Namen des Releaseherstellers an.

Kategorie

Gibt die Releasekategorie an.

ManufacturerUUID

Gibt die UUID des Releaseherstellers an.

CategoryUUID

Gibt die UUID der Releasekategorie an.

Beschreibung

Gibt die Beschreibung des Release an.

Rückgabewerte

CA_SWDETECT_OK

Zeigt an, dass die Funktion den Vorgang erfolgreich abgeschlossen hat.

CASWDETECT_BADARGS

Zeigt an, dass ein oder mehrere obligatorische Parameter leer sind, die an die Funktion übergeben wurden.

CASWDETECT_FILE_ERROR

Zeigt an, dass die Funktion nicht in die Datei schreiben konnte. Weitere Informationen finden Sie in der Protokolldatei.