Verwenden des Kontextobjekts bei Leistungsmonitoren

Das Kontextobjekt stellt eine Schnittstelle für Ihr Skript zur Verfügung, um die Interaktion mit WhatsUp Gold zu ermöglichen.

Alle Methoden und Eigenschaften werden mit Hilfe des Namespace Kontext abgerufen.

Note: Möglicherweise müssen Sie beim Ausschneiden/Einfügen die Urheberrechtsinformationen entfernen, wenn diese beim Kopieren aus dieser Hilfedatei angezeigt werden.

Methode

Methodenbeschreibung

LogMessage(sText);

Mit dieser Methode lässt sich eine Meldung in das Debugprotokoll WhatsUp Gold schreiben.

Beispiel:

JScript

Context.LogMessage(„Prüfen des Monitornamens mit Hilfe von Context.GetProperty()“);

VBScript

Context.LogMessage „Prüfen der Adresse mit Hilfe von Context.GetProperty()“

PutProperty(sPropertyName);

Mit dieser Methode können Sie einen Wert im Objekt „INMSerialize“ speichern. Dieser Wert wird über alle Abfragen beibehalten. (Diese Methode steht nur für Active-Script zur Verfügung.)

Beispiel:

JScript

var nCount = parselnt(nNum) +1;
Context.PutProperty(„MyNumeric“,nCount);

SetProperty(sPropertyName);

Mit dieser Methode können Sie einen Wert im Objekt „INMSerialize“ speichern. Dieser Wert wird über alle Abfragen beibehalten. (Diese Methode steht nur für PowerShell zur Verfügung.)

SetResult(nCode, sText);

Mit dieser Methode lassen sich ein Ergebniscode und eine Ergebnismeldung festlegen. So können Sie dem System WhatsUp Gold mitteilen, ob der Monitor erfolgreich war oder fehlgeschlagen ist.

Mit jedem Skript sollte SetResult aufgerufen werden. Wird SetResult nicht aufgerufen, wird automatisch angenommen, dass das Skript erfolgreich war.

Beispiel:

JScript

Context.SetResult(0, „Das Skript wurde erfolgreich abgeschlossen.“); //Success
Context.SetResult(1, „Es ist ein Fehler aufgetreten.“); //Failure

VBScript

Context.SetResult 1, „Es ist ein Fehler aufgetreten.“

GetReferenceVariable(sRefVarName );

Mit dieser Methode steht dem Code eine Referenzvariable zur Verfügung, die er im Monitor verwenden kann.

Beispiel:

JScript

Context.GetReferenceVariable(„A“)

Eine Referenzvariable „A“ hätte erzeugt werden müssen.

SetValue(nValue);

Mit dieser Methode können Sie einen Wert grafisch darstellen.

Beispiel:

JScript

Context.SetValue(245)

GetProperty(sPropertyName);

Mit dieser Methode können Sie auf jede der nachstehend aufgelisteten Geräteeigenschaften zugreifen. Bei diesen Namen wird zwischen Groß- und Kleinschreibung unterschieden.

Eigenschaft	Beschreibung
`„ActiveMonitorTypeName“`	Der Anzeigename des aktiven Monitors
`„Address“`	Die IP-Adresse des Geräts
`„DeviceID“`	Die Gerätekennung
`„Mode“`	1 = Ermitteln 2 = Abfragen 3 = Testen
`„ActiveMonitorTypeID“`	Die Typenkennung des aktiven Monitors
`„CredSnmpV1:ReadCommunity“`	SNMP-V1-Lese-Community
`„CredSnmpV1:WriteCommunity“`	SNMP-V1-Schreib-Community
`"CredSnmpV2:ReadCommunity"`	SNMP-V2-Lese-Community
`"CredSnmpV2:WriteCommunity"`	SNMP-V2-Schreib-Community
`„CredSnmpV3:Username“`	Benutzername SNMP V3
`„CredSnmpV3:Context“`	Kontext SNMP V3
`„CredSnmpV3:AuthPassword“`	Kennwort für die SNMP-V3-Authentifizierung
`„CredSnmpV3:AuthProtocol“`	Protokoll für die SNMP-V3-Authentifizierung
`„CredSnmpV3:EncryptPassword“`	Verschlüsselung des Kennworts für SNMP V3
`„CredSnmpV3:EncryptProtocol“`	Verschlüsselung des Protokolls für SNMP V3
`„CredWindows:DomainAndUserid“`	Windows-NT-Domäne und Benutzer-ID
`„CredWindows:Password“`	Kennwort für Windows NT

Beispiel:

JScript

var sAddress = Context.GetProperty(„Address“);
var sReadCommunity = Context.GetProperty(„CredSnmpV1:ReadCommunity“);
var nDeviceID = Context.GetProperty(„DeviceID“);