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à

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

Vedi anche

Classi consumer standard

Esecuzione di uno script basato su un evento

Ricezione di eventi in qualsiasi momento

Creazione di un consumer logico

__EventConsumer

ScriptingStandardConsumerSetting