Vorheriges Thema: CreateDetectedSoftwarePatchNächstes Thema: CreateDetectedSoftwarePatchInstance


CreateDetectedSoftwareReleaseInstance

Die Funktion CreateDetectedSoftwareReleaseInstance fügt einen Datensatz zur Softwareerkennungs-Ausgabedatei hinzu, wenn das Skript eine Instanz eines bestimmten Release findet.

Funktionssyntax:

CreateDetectedSoftwareReleaseInstance (ProductName als String, ProductVersionLabel als String, ReleaseName als String, ReleaseVersionLabel als String, OptionalProperties als String) als Integer.

Beispiel:

CreateDetectedSoftwareReleaseInstance ("Microsoft Windows 7 Ultimate", "6.1", "Microsoft Windows 7 Ultimate x64 64 en-us", "6.1.7600", "Origin=Forward Inc | TrustLevel=5 | InstallPath=C:\Windows | SerialNumber=1234-567-890414-86668 | LastAccessed=2011-11-29:-12:30 |")

Hinweis: Diese Funktion muss aufgerufen werden, nachdem man die CreateDetectedSoftwareRelease-Funktion innerhalb jedes Skripts aufgerufen hat. Die CreateDetectedSoftwareReleaseInstance-Funktion kann so oft aufgerufen werden, wie Instanzen gefunden werden, und jede Instanz erhält einen separaten erkannten Softwaredatensatz.

Hinweis: Wenn zwei verschiedene Intellisigs die gleiche Softwareinstanz finden, werden zwei Datensätze für erkannte Software erstellt.

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.

ReleaseName

Gibt den Namen der erkannten Software an.

ReleaseVersionLabel

Gibt die Versionsbezeichnung des Release an.

OptionalProperties

Gibt die der erkannten Softwareinstanz zugeordneten optionalen Eigenschaften an. Die folgenden optionalen Eigenschaften sind für Instanzen verfügbar:

ProductGUID

Gibt die Produkt-GUID an, die durch das Skript erkannt wurde. Zum Beispiel die Produkt-GUID eines MSI-Pakets.

Bezeichnung

Gibt eine eindeutige Bezeichnung für diese Instanz an. Zum Beispiel: Der Microsoft SQL Server-Instanzenname.

Ursprung

Gibt den Namen des Intellisig-Erstellers an.

TrustLevel

Gibt die Vertrauensstufe des Erstellers des Intellisigs, des Skripts oder beiden an.

InstallPath

Gibt den Pfad zum Produktinstallationsverzeichnis oder die ausführbare Datei auf dem Agent-Computer an.

SerialNumber

Gibt die Seriennummer der Instanz an.

LastAccessed

Gibt Datum und Uhrzeit des letzten Zugriffs auf die Instanz an. Geben Sie den Wert im folgenden Format an: jjjj-mm-tt-hr:mm. Es wird angenommen, dass dieser Wert in Ortszeit ist.
Hinweis: Alle anderen Funktionen in dmscript, die sich mit Zeit befassen, funktionieren ebenfalls in Ortszeit. Dmscript konvertiert den Zeitwert vor der Ausgabe in UNIX-Format (Sekunden seit 1-1-1970 UTC). DSM-Explorer zeigt dies mithilfe der lokalen Zeitzone auf dem Rechner, auf dem er ausgeführt wird, an.

CustomData

Gibt andere benutzerdefinierte Daten an, die Sie für die Instanz speichern möchten.

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.