ActiveScriptEventConsumer, classe

La classe ActiveScriptEventConsumer exécute un script prédéfini dans un langage de script arbitraire lorsqu’un événement lui est remis. Cette classe est l’un des consommateurs d’événements standard fournis par WMI. Pour plus d’informations, consultez surveillance et réponse aux événements avec des consommateurs standard.

Mofcomp -n:root\<namespace> scrcons.mof

Vous pouvez configurer les performances de toutes les instances de ActiveScriptEventConsumer sur un système en définissant les valeurs de la propriété timeout ou MaximumScripts dans l’instance unique de ScriptingStandardConsumerSetting.

Syntaxe

[AMENDMENT]
class ActiveScriptEventConsumer : __EventConsumer
{
  uint8  CreatorSID[] = {1,1,0,0,0,0,0,5,18,0,0,0};
  uint32 KillTimeout = 0;
  string MachineName;
  uint32 MaximumQueueSize;
  string Name;
  string ScriptingEngine;
  string ScriptFileName;
  string ScriptText;
};

Membres

La classe ActiveScriptEventConsumer possède les types de membres suivants :

Propriétés

La classe ActiveScriptEventConsumer possède les propriétés suivantes.

CreatorSID

Type de données : tableau UInt8

Type d'accès : Lecture seule

Tableau qui représente l’identificateur de sécurité (SID), qui identifie de façon unique le créateur du consommateur d’événements active script. Cette propriété est héritée de _ _ EventConsumer.

KillTimeout

Type de données : UInt32

Type d'accès : Lecture seule

Nombre, en secondes, pendant lequel le script est autorisé à s’exécuter. Si 0 (zéro), qui est la valeur par défaut, le script n’est pas arrêté.

MachineName

Type de données : chaîne

Type d'accès : Lecture seule

Nom de l’ordinateur auquel WMI envoie des événements. Par Convention des consommateurs Microsoft standard, le consommateur de script ne peut pas être exécuté à distance. Les consommateurs tiers peuvent également utiliser cette propriété. Cette propriété est héritée de _ _ EventConsumer.

MaximumQueueSize

Type de données : UInt32

Type d'accès : Lecture seule

File d’attente maximale, en octets, pour le consommateur d’événements active script. Cette propriété est héritée de _ _ EventConsumer.

Nom

Type de données : chaîne

Type d’accès : lecture/écriture

Qualificateurs : clé

Identificateur unique pour le consommateur d’événements. Si vous renommez le consommateur, le résultat est égal à deux consommateurs qui ont des noms différents.

ScriptFileName

Type de données : chaîne

Type d'accès : Lecture seule

Nom du fichier à partir duquel le texte du script est lu, ce qui constitue une alternative à la spécification du texte du script dans la propriété ScriptText . Cette propriété doit avoir la valeur null si la propriété ScriptText n’a pas la valeur null.

Notes

Lorsque vous spécifiez le ScriptFileName, il est important de sécuriser l’exécutable que vous lancez. Si l’exécutable ne se trouve pas dans un emplacement sécurisé ou sécurisé à l’aide d’une liste de contrôle d’accès (ACL) forte, n’importe qui peut remplacer l’exécutable par un autre. Pour plus d’informations sur les listes de contrôle d’accès, consultez création d’un descripteur de sécurité (SD) pour un nouvel objet en C++.

ScriptingEngine

Type de données : chaîne

Type d'accès : Lecture seule

Nom du moteur de script à utiliser, par exemple, « VBScript ». Cette propriété ne peut pas être null.

ScriptText

Type de données : chaîne

Type d'accès : Lecture seule

Texte du script exprimé dans un langage connu du moteur de script. Cette propriété doit avoir la valeur null si la propriété ScriptFileName n’a pas la valeur null.

Notes

Cette classe est dérivée de la classe abstraite _ _ EventConsumer . Il se trouve dans l’espace de noms de l' \ abonnement racine.

Lorsque le texte d’un script est spécifié dans l’instance de consommateur d’événements, le script a accès à l’instance d’événement dans la variable d’environnement de script TargetEvent.

Les scripts s’exécutent dans le contexte de sécurité LocalSystem. Par mesure de sécurité, seul un administrateur système local ou un administrateur de domaine peut configurer le consommateur de script. Les droits d’accès ne sont pas vérifiés jusqu’au moment de l’exécution. Une fois le consommateur configuré, n’importe quel utilisateur peut déclencher l’événement qui provoque l’exécution du script.

L’échec du chargement du moteur de script ou de l’analyse et de la validation du script est considéré comme un échec. Les codes de retour d’erreur du script et l’arrêt du script à l’aide d’un délai d’attente sont également considérés comme des échecs.

ScriptText ou ScriptFileName ne doit pas avoir la valeur null. Si les deux propriétés ont la valeur null ou not null, une erreur est générée.

Lorsque WMI est exécuté en tant que service, les scripts exécutés par ActiveScriptEventConsumer ne génèrent pas de sortie écran. Les scripts qui utilisent MsgBox s’exécutent, mais ils n’affichent pas d’informations à l’écran. L’exécution du service WMI en tant que fichier exécutable n’est pas prise en charge, mais WMI autorise les scripts qui utilisent la fonction MsgBox à afficher la sortie ou à accepter les entrées utilisateur. aucune des méthodes fournies par l’objet WScript ne peut être utilisée, car ActiveScriptEventConsumer n’utilise pas Windows Script Host (WSH).

Exemples

L’exemple de création d’un événement WMI permanent pour surveiller les fichiers PowerShell sur la Galerie TechNet utilise ActiveScriptEventConsumer dans le cadre d’un script complexe pour configurer une inscription d’événement WMI permanente.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
\Abonnement racine
MOF
Scrcons. mof
DLL
Scrcons.exe

Voir aussi

Classes de consommateur standard

Exécution d’un script basé sur un événement

Réception d’événements à tout moment

Création d’un consommateur logique

__EventConsumer

ScriptingStandardConsumerSetting