Vorheriges Thema: CreateDetectedSoftwareReleaseInstanceNächstes Thema: LogDetectedSoftwareError


CreateDetectedSoftwarePatchInstance

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

Funktionssyntax:

CreateDetectedSoftwarePatchInstance (ProductName als String, ProductVersionLabel, als String, ReleaseName als String, ReleaseVersionLabel als String, PatchName als String, PatchVersionLabel als String, OptionalProperties als String) als Integer

Beispiel: CreateDetectedSoftwarePatchInstance

CreateDetectedSoftwarePatchInstance ("Microsoft Windows 7 Ultimate", "6.1", "Microsoft Windows 7 Ultimate x64 64 en-us", "6.1.7600", "KB971033 x64 64 en-us", "", "Origin=Forward Inc |TrustLevel=5 |")

Hinweis: Diese Funktion muss aufgerufen werden, nachdem man die CreateDetectedSoftwarePatch-Funktion innerhalb jedes Skripts aufgerufen hat. Die CreateDetectedSoftwarePatchInstance-Funktion kann so oft wie die Anzahl der Instanzen aufgerufen werden. Jede Instanz erhält einen separat erkannten Software-Datensatz.

Hinweis: Wenn zwei verschiedene Intellisigs die gleiche Softwareinstanz finden, werden zwei erkannte Softwaredatensätze erstellt, einer für jedes Intellisig.

Eingabeparameter

Diese Funktion hat die folgenden Eingabeparameter:

ProductName

Gibt den Namen des Produkts an, zu dem der Patch 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 des Release an, zu dem der Patch gehört. Sie müssen die CreateDetectedSoftwareRelease-Funktion für diesen Release innerhalb des Skripts aufgerufen haben.

ReleaseVersionLabel

Gibt die Versionsbezeichnung des Release an.

PatchName

Gibt den Namen des gefundenen Softwarepatches an. Sie müssen die CreateDetectedSoftwarePatch-Funktion für diesen Release innerhalb des Skripts aufgerufen haben.

PatchVersionLabel

Gibt die Versionsbezeichnung des Patches 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.

Bezeichnung

Gibt eine eindeutige Bezeichnung für die Instanz an.

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 mehr obligatorische Parameter, die an die Funktion übergeben wurden, leer sind.

CASWDETECT_FILE_ERROR

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