Utilisation de l'objet contextuel avec des analyseurs de performances

L'objet contexte fournit une interface pour que votre script interagisse avec WhatsUp Gold.

Toutes les méthodes et propriétés sont récupérées en utilisant l'espace de nom Contexte.

Note: Vous devrez peut-être supprimer les informations de copyright de la fonction couper-coller si elles apparaissent lorsque vous copiez depuis ce fichier d'aide.

Méthodes

Description de la méthode

LogMessage(sText);

Cette méthode autorise l'écriture d'un message dans le journal de débogage WhatsUp Gold.

Exemple

JScript

Context.LogMessage( "Checking Monitor name using Context.GetProperty()");

VBScript

Context.LogMessage "Checking Address using Context.GetProperty()"

PutProperty(sPropertyName);

Cette méthode vous permet de stocker une valeur dans l'objet INMSerialize. Cette valeur est conservée entre les interrogations. (Cette méthode concerne uniquement les scripts actifs.)

Exemple

JScript

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

SetProperty(sPropertyName);

Cette méthode vous permet de stocker une valeur dans l'objet INMSerialize. Cette valeur est conservée entre les interrogations. (Cette méthode concerne uniquement le PowerShell.)

SetResult(nCode, sText);

Cette méthode autorise la définition d'un code de résultat et d'un message de résultat. Voici comment vous pouvez indiquer au système WhatsUp Gold que l'analyseur a réussi ou échoué.

Chaque script doit indiquer SetResult. Si SetResult n'est pas indiqué, le script est toujours considéré comme réussi.

Exemple

JScript

Context.SetResult(0, "Script completed successfully."); //Success
Context.SetResult(1, "An error occurred."); //Failure

VBScript

Context.SetResult 1, "An error occurred."

GetReferenceVariable(sRefVarName );

Cette méthode autorise l'utilisation d'une variable de référence par le code dans l'analyseur.

Exemple

JScript

Context.GetReferenceVariable("A")

Une variable de référence « A » doit être créée.

SetValue(nValue);

Cette méthode vous permet de représenter une valeur dans une graphique.

Exemple

JScript

Context.SetValue(245)

GetProperty(sPropertyName);

Cette méthode permet l'accès aux propriétés de périphérique répertoriées ci-dessous. Ces noms sont sensibles à la casse.

Propriété	Description
`"ActiveMonitorTypeName"`	Le nom complet de l'analyseur actif
`"Address"`	L'adresse IP du périphérique
`"DeviceID"`	L'ID du périphérique
`"Mode"`	1 = doing discovery (découverte en cours d'exécution) 2 = polling (interrogation) 3 = test
`"ActiveMonitorTypeID"`	L'ID du type de l'analyseur actif
`"CredSnmpV1:ReadCommunity"`	Communauté SNMP V1 en lecture
`"CredSnmpV1:WriteCommunity"`	Communauté SNMP V1 en écriture
`"CredSnmpV2:ReadCommunity"`	Communauté SNMP V2 en lecture
`"CredSnmpV2:WriteCommunity"`	Communauté SNMP V2 en écriture
`"CredSnmpV3:Username"`	Nom d'utilisateur SNMP V3
`"CredSnmpV3:Context"`	Contexte SNMP V3
`"CredSnmpV3:AuthPassword"`	Mot de passe d'authentification SNMP V3
`"CredSnmpV3:AuthProtocol"`	Protocole d'authentification SNMP V3
`"CredSnmpV3:EncryptPassword"`	Mot de passe de cryptage SNMP V3
`"CredSnmpV3:EncryptProtocol"`	Protocole de cryptage SNMP V3
`"CredWindows:DomainAndUserid"`	Domaine et ID utilisateur Windows NT
`"CredWindows:Password"`	Mot de passe Windows NT

Exemple

JScript

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