Classe ActiveScriptEventConsumer
La classe ActiveScriptEventConsumer esegue uno script predefinito in un linguaggio di scripting arbitrario quando viene recapitato un evento. Questa classe è uno dei consumer di eventi standard forniti da WMI. Per altre informazioni, vedere Monitoraggio e risposta agli eventi con consumer standard.
Mofcomp -n:root\<namespace> scrcons.mof
È possibile configurare le prestazioni di tutte le istanze di ActiveScriptEventConsumer in un sistema impostando i valori della proprietà Timeout o MaximumScripts nella singola istanza di ScriptingStandardConsumerSetting.
Sintassi
[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;
};
Membri
La classe ActiveScriptEventConsumer include questi tipi di membri:
Proprietà
La classe ActiveScriptEventConsumer ha queste proprietà.
-
CreatorSID
-
-
Tipo di dati: matrice uint8
-
Tipo di accesso: sola lettura
Matrice che rappresenta l'identificatore di sicurezza (SID), che identifica in modo univoco l'autore del consumer di eventi script attivi. Questa proprietà viene ereditata da __EventConsumer.
-
-
KillTimeout
-
-
Tipo di dati: uint32
-
Tipo di accesso: sola lettura
Numero, in secondi, consentito per l'esecuzione dello script. Se 0 (zero), ovvero l'impostazione predefinita, lo script non viene terminato.
-
-
MachineName
-
-
Tipo di dati: string
-
Tipo di accesso: sola lettura
Nome del computer a cui WMI invia eventi. Per convenzione dei consumer standard Microsoft, il consumer di script non può essere eseguito in modalità remota. Anche i consumer di terze parti possono utilizzare questa proprietà. Questa proprietà viene ereditata da __EventConsumer.
-
-
MaximumQueueSize
-
-
Tipo di dati: uint32
-
Tipo di accesso: sola lettura
Coda massima, in byte, per il consumer di eventi script attivi. Questa proprietà viene ereditata da __EventConsumer.
-
-
Nome
-
-
Tipo di dati: string
-
Tipo di accesso: lettura/scrittura
-
Qualificatori: Chiave
Identificatore univoco per il consumer di eventi. Se si rinomina il consumer, il risultato è costituito da due consumer uguali con nomi diversi.
-
-
ScriptFileName
-
-
Tipo di dati: string
-
Tipo di accesso: sola lettura
Nome del file da cui viene letto il testo dello script, destinato come alternativa a specificare il testo dello script nella proprietà ScriptText . Questa proprietà deve essere NULL se la proprietà ScriptText non è NULL.
Nota
Quando si specifica ScriptFileName, è importante proteggere il file eseguibile che si sta avviando. Se l'eseguibile non si trova in un percorso sicuro o protetto con un elenco di controllo di accesso sicuro (ACL), chiunque può sostituire il file eseguibile con uno diverso. Per altre informazioni sugli elenchi di controllo di accesso, vedere Creazione di un descrittore di sicurezza (SD) per un nuovo oggetto in C++.
-
-
ScriptingEngine
-
-
Tipo di dati: string
-
Tipo di accesso: sola lettura
Nome del motore di scripting da usare, ad esempio , "VBScript". Questa proprietà non può essere NULL.
-
-
ScriptText
-
-
Tipo di dati: string
-
Tipo di accesso: sola lettura
Testo dello script espresso in un linguaggio noto al motore di scripting. Questa proprietà deve essere NULL se la proprietà ScriptFileName non è NULL.
-
Osservazioni:
Questa classe è derivata dalla classe astratta __EventConsumer . Si trova nello spazio dei nomi root\subscription.
Quando il testo di uno script viene specificato nell'istanza del consumer di eventi, lo script ha accesso all'istanza dell'evento nella variabile di ambiente script TargetEvent.
Gli script vengono eseguiti nel contesto di sicurezza LocalSystem. Come misura di sicurezza, solo un amministratore di sistema locale o un amministratore di dominio può configurare il consumer di scripting. I diritti di accesso non vengono controllati fino al runtime. Dopo aver configurato il consumer, qualsiasi utente può attivare l'evento che fa sì che lo script sia .
Non è possibile caricare il motore di scripting o analizzare e verificare che lo script sia considerato un errore. I codici restituiti dagli script e terminando lo script usando un timeout vengono considerati anche errori.
ScriptText o ScriptFileName non deve essere NULL. Se entrambe le proprietà sono NULL o non NULL, viene generato un errore.
Quando WMI viene eseguito come servizio, gli script eseguiti da ActiveScriptEventConsumer non generano l'output dello schermo. Gli script che usano MsgBox vengono eseguiti, ma non visualizzano informazioni sullo schermo. L'esecuzione del servizio WMI come file eseguibile non è supportata, ma WMI consente agli script che usano la funzione MsgBox di visualizzare l'output o accettare l'input dell'utente. Nessuno dei metodi forniti dall'oggetto WScript può essere usato perché ActiveScriptEventConsumer non usa Windows Script Host (WSH).
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Root\subscription |
| MOF |
|
| DLL |
|