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 |
|
| DLL |
|