Oggetto SWbemServices

È possibile utilizzare i metodi di un oggetto SWbemServices per eseguire operazioni su uno spazio dei nomi in un host locale o in un host remoto. Questo oggetto non può essere creato dalla chiamata CreateObject VBScript.

Membri

L'oggetto SWbemServices dispone di questi tipi di membri:

• Metodi
• Proprietà

Metodi

L'oggetto SWbemServices dispone di questi metodi.

Proprietà

L'oggetto SWbemServices dispone di queste proprietà.

Commenti

I metodi possono essere chiamati in modalità sincrona, in modalità asincrona o in modalità semisynchrono. Per altre informazioni, vedere Chiamata di un metodo.

Panoramica

SWbemServices svolge due ruoli primari. In primo luogo, l'oggetto SWbemServices rappresenta una connessione autenticata a uno spazio dei nomi WMI in un computer di destinazione. In secondo luogo, SWbemServices è l'oggetto automation usato per recuperare le risorse gestite da WMI. È possibile ottenere un riferimento a un oggetto SWbemServices in uno dei due modi seguenti:

• Come illustrato nella maggior parte degli script WMI presentati finora, è possibile usare la funzione GetObject VBScript in combinazione con il moniker WMI "winmgmts:". L'esempio seguente è la forma più semplice di una connessione WMI. L'esempio si connette allo spazio dei nomi predefinito (in genere "Root\CIMv2") nel computer locale:

  Set objSWbemServices = GetObject("winmgmts:")

• È anche possibile utilizzare il metodo ConnectServer dell'oggetto SWbemLocator per ottenere un riferimento a un oggetto SWbemServices.

Dopo aver ottenuto un riferimento a un oggetto SWbemServices , usare il riferimento all'oggetto per chiamare 1 di 18 metodi disponibili usando SWbemServices. SWbemServices può restituire uno dei tre diversi oggetti libreria di scripting WMI (SWbemObjectSet, SWbemObject o SWbemEventSource), a seconda del metodo chiamato. Conoscere il tipo di oggetto restituito da ogni metodo consente di determinare il passaggio successivo che lo script deve eseguire. Ad esempio, se si recupera un oggetto SWbemObjectSet, è necessario enumerare la raccolta per accedere a ogni oggetto SWbemObject nella raccolta. Se si torna a un oggetto SWbemObject, è possibile accedere immediatamente ai metodi e alle proprietà dell'oggetto senza enumerare prima la raccolta.

Modalità di funzionamento

SWbemServices supporta tre modalità di funzionamento: sincrona, asincrona e semisynchronous.

• Synchronous. In modalità sincrona, lo script si blocca (sospende) fino al completamento del metodo SWbemServices . Non solo lo script attende, ma nei casi in cui WMI recupera le istanze delle risorse gestite, WMI compila l'intero oggetto SWbemObjectSet in memoria prima che il primo byte di dati venga restituito allo script chiamante. Ciò può avere un effetto negativo sulle prestazioni dello script e sul computer che esegue lo script. Ad esempio, il recupero sincrono di migliaia di eventi dai registri eventi di Windows può richiedere molto tempo e usare molta memoria. Per questi motivi, le operazioni sincrone non sono consigliate, ad eccezione dei tre metodi (Delete, ExecMethod e Get) sincroni per impostazione predefinita. Questi metodi non restituiscono set di dati di grandi dimensioni, pertanto l'operazione semisynchronous non è necessaria.

• Asincrona. In modalità asincrona, lo script chiama uno dei nove metodi asincroni e restituisce immediatamente. Ovvero, non appena viene chiamato il metodo asincrono, lo script riprende l'esecuzione della riga di codice successiva. Per usare un metodo asincrono, lo script deve prima creare un oggetto SWbemSink e una subroutine speciale denominata gestore eventi. WMI esegue l'operazione asincrona e notifica lo script chiamando la subroutine del gestore eventi al termine dell'operazione.

• Semisynchronous. La modalità semisynchrono è una compromissione tra sincrona e asincrona. Le operazioni semisynchrono offrono prestazioni migliori rispetto alle operazioni sincrone, ma non richiedono la conoscenza aggiuntiva e i passaggi di scripting necessari per gestire le operazioni asincrone. Si tratta del tipo di operazione predefinito per la maggior parte delle query WMI.

  In modalità semisynchrono lo script chiama uno dei sei metodi di recupero dei dati e restituisce immediatamente. WMI recupera le risorse gestite in background man mano che lo script continua a essere eseguito. Quando vengono recuperate le risorse, vengono immediatamente restituite allo script tramite un oggetto SWbemObjectSet. È possibile iniziare ad accedere alle risorse gestite senza attendere l'assemblaggio dell'intera raccolta.

  Esiste un'attenzione alle operazioni semisynchrono quando si utilizzano risorse gestite con molte istanze (molti significano maggiore di 1.000), ad esempio CIM_DataFile e Win32_NTLogEvent. L'attenzione è un risultato del modo in cui WMI gestisce le istanze delle risorse gestite. Per ogni istanza di una risorsa gestita, WMI crea e memorizza nella cache un oggetto SWbemObject . Quando esiste un numero elevato di istanze per una risorsa gestita, il recupero di istanze può monopolizzare le risorse disponibili, riducendo le prestazioni dello script e del computer.

  Per risolvere il problema, è possibile ottimizzare le chiamate al metodo semisynchrono usando il flag wbemFlagForwardOnly . Il flag wbemFlagForwardOnly , combinato con il flag wbemFlagReturnImmediately (flag semisynchronous predefinito), indica a WMI di restituire un oggetto SWbemObjectSet di sola inoltro, che elimina il problema di prestazioni del set di dati di grandi dimensioni. Tuttavia, l'uso del flag wbemFlagForwardOnly include un costo. È possibile enumerare solo una sola volta SWbemObjectSet . Dopo che ogni SWbemObject in un oggetto SWbemObjectSet è accessibile, viene rilasciata la memoria allocata all'istanza.

Ad eccezione di Delete, ExecMethod, Get e nove metodi asincroni, semisynchronous è la modalità predefinita e consigliata dell'operazione.

Metodi comunemente usati

I metodi più spesso usati negli script di amministrazione del sistema sono IstanzeOf, ExecQuery, Get e ExecNotificationQuery. Anche se spesso usato, IstanzeOf non è necessariamente il modo consigliato per recuperare le informazioni (anche se è probabilmente il modo più semplice).

Requisiti

Vedi anche

Scripting di oggetti API

Chiamata di un metodo