Classe Win32_WMISetting

  • Articolo

La classe WMI singleton Win32_WMISetting contiene i parametri operativi per il servizio WMI. Questa classe può avere una sola istanza, che esiste sempre per ogni sistema Windows e non può essere eliminata. Non è possibile creare istanze aggiuntive.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà e i metodi sono in ordine alfabetico, non in ordine MOF.

Sintassi

[Singleton, Dynamic, Provider("WBEMCORE"), UUID("{A83EF166-CA8D-11d2-B33D-00104BCC4B4A}"), AMENDMENT]
class Win32_WMISetting : CIM_Setting
{
  string   Caption;
  string   Description;
  string   SettingID;
  string   ASPScriptDefaultNamespace = "\\\\root\\cimv2";
  boolean  ASPScriptEnabled;
  string   AutorecoverMofs[];
  uint32   AutoStartWin9X;
  uint32   BackupInterval;
  datetime BackupLastTime;
  string   BuildVersion;
  string   DatabaseDirectory;
  uint32   DatabaseMaxSize;
  boolean  EnableAnonWin9xConnections;
  boolean  EnableEvents;
  boolean  EnableStartupHeapPreallocation;
  uint32   HighThresholdOnClientObjects;
  uint32   HighThresholdOnEvents;
  string   InstallationDirectory;
  uint32   LastStartupHeapPreallocation;
  string   LoggingDirectory;
  uint32   LoggingLevel;
  uint32   LowThresholdOnClientObjects;
  uint32   LowThresholdOnEvents;
  uint32   MaxLogFileSize;
  uint32   MaxWaitOnClientObjects;
  uint32   MaxWaitOnEvents;
  string   MofSelfInstallDirectory;
};

Membri

La classe Win32_WMISetting include questi tipi di membri:

Proprietà

La classe Win32_WMISetting ha queste proprietà.

ASPScriptDefaultNamespace

Tipo di dati: string

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\scripting|Spazio dei nomi predefinito")

Spazio dei nomi dello script predefinito. Questa proprietà contiene lo spazio dei nomi usato dalle chiamate dall'API di scripting per WMI se nessuna è specificata dal chiamante.

Questa proprietà riflette il valore nella chiave del Registro di sistema.

scripting di Microsoft\WBEM\    software\HKEY_LOCAL_MACHINE|\Spazio dei nomi predefinito

Esempio: root\cimv2

Per uno script di esempio che usa questa proprietà, vedere la sezione Osservazioni.

ASPScriptEnabled

Tipo di dati: booleano

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\scripting|Abilitare per ASP")

Se True, gli script WMI possono essere usati nelle pagine asp (Active Server Pages). Questa proprietà è valida nei sistemi che eseguono solo versioni non supportate di Windows. Per i sistemi Windows supportati, gli script WMI sono sempre consentiti in ASP.

AutorecoverMofs

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|File MOF di salvataggio automatico")

Elenco dei nomi di file MOF completi usati per inizializzare o ripristinare il repository WMI. L'elenco determina l'ordine di compilazione dei file MOF.

Questa proprietà riflette il valore nella chiave del Registro di sistema.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM\    CIMOM|File MOF di salvataggio automatico

AutoStartWin9X

Tipo di dati: uint32

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|AutostartWin9X")

Non supportato.

Non iniziare (0)

Avvio automatico (1)

Avvio al riavvio (2)

BackupInterval

Tipo di dati: uint32

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Soglia intervallo di backup"), unità ("minuti")

Non supportato. Eseguire invece il backup manuale del repository WMI.

BackupLastTime

Tipo di dati: datetime

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32API|Funzioni temporali |GetTimeZoneInformation")

Data e ora dell'ultima esecuzione del backup.

BuildVersion

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM|Build")

Informazioni sulla versione per il servizio WMI attualmente installato.

Intervallo di tempo trascorso tra i backup del database WMI.

Questa proprietà riflette il valore nella chiave del Registro di sistema.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM |Costruire

Caption

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MaxLen (64)

Breve descrizione testuale dell'oggetto corrente.

Questa proprietà viene ereditata da CIM_Setting.

DatabaseDirectory

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Directory repository")

Percorso della directory contenente il repository WMI.

DatabaseMaxSize

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Dimensioni massime database"), unità ("kilobyte")

Dimensioni massime del repository WMI.

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

Descrizione testuale dell'oggetto corrente.

Questa proprietà viene ereditata da CIM_Setting.

EnableAnonWin9x Connessione ions

Tipo di dati: booleano

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|EnableAnon Connessione ions")

Non supportato.

EnableEvents

Tipo di dati: booleano

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|EnableEvents")

Se True, è necessario abilitare il sottosistema eventi WMI.

Questa proprietà riflette il valore nella chiave del Registro di sistema.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM |CIMOM |EnableEvents

EnableStartupHeapPreallocation

Tipo di dati: booleano

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|EnableStartupHeapPreallocation")

Se True, WMI crea un heap preallocato con le dimensioni del valore LastStartupHeapPreallocation quando WMI viene inizializzato.

HighThresholdOnClientObjects

Tipo di dati: uint32

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Soglia elevata per gli oggetti client"), unità ("oggetti al secondo")

Velocità massima in cui è possibile recapitare oggetti creati dal provider ai client. Per supportare i differenziali di velocità tra provider e client, WMI contiene oggetti nelle code prima di distribuirli ai consumer. Per una maggiore efficienza, i consumer devono raccogliere gli oggetti a un ritmo corrispondente al provider. Se la memoria mantenuta da oggetti non registrati raggiunge LowThresholdOnObjects, WMI rallenta l'aggiunta di nuovi oggetti nella coda. Se gli eventi non registrati continuano ad accumularsi e la massima attesa per recapitare eventi in MaxWaitOnClientObjects viene raggiunta mentre la memoria usata è al valore in HighThresholdOnClientObjects, WMI non accetta altri oggetti dai provider e restituisce WBEM_E_OUT_OF_MEMORY ai client.

HighThresholdOnEvents

Tipo di dati: uint32

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|High Threshold On Events"), Unità ("eventi al secondo")

Frequenza massima in cui gli eventi devono essere recapitati ai client. Per supportare i differenziali di velocità tra provider e client, gli eventi di WMI vengono accodato prima di recapitarli ai consumer. Per una maggiore efficienza, i consumer devono raccogliere gli eventi a un ritmo corrispondente al provider. Se la memoria mantenuta da eventi non registrati raggiunge LowThresholdOnObjects, WMI rallenta l'aggiunta di nuovi eventi nella coda. Se gli eventi non registrati continuano ad accumularsi e l'attesa massima di recapito degli eventi in MaxWaitOnEvents viene raggiunta mentre la memoria usata è al valore in HighThresholdOnEvents, WMI non accetta altri eventi dai provider e restituisce WBEM_E_OUT_OF_MEMORY ai client.

Nota

La limitazione viene eseguita solo per i consumer di eventi permanenti, quindi i consumer temporanei non devono aspettarsi limitazioni quando gli eventi vengono sottoposti a backup nella coda di eventi interni WMI.

 

Questa proprietà riflette il valore nella chiave del Registro di sistema.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM\    CIMOM|Soglia elevata per gli oggetti client (B)

InstallationDirectory

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM|Directory di installazione")

Percorso della directory in cui è stato installato il software WMI. Il percorso predefinito è \System32\Wbem.

Questa proprietà riflette il valore nella chiave del Registro di sistema.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM |Directory di installazione

LastStartupHeapPreallocation

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|LastStartupHeapPreallocation"), unità ("byte")

Dimensioni dell'heap preallocato creato da WMI durante l'inizializzazione.

Questa proprietà riflette il valore nella chiave del Registro di sistema.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM |CIMOM |LastStartupHeapPreallocation

LoggingDirectory

Tipo di dati: string

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Directory di registrazione")

Percorso della directory contenente il percorso dei file di log di sistema WMI.

Questa proprietà riflette il valore nella chiave del Registro di sistema.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM |CIMOM |Directory di registrazione

LoggingLevel

Tipo di dati: uint32

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Registrazione")

Abilitazione della registrazione degli eventi e del livello di dettaglio della registrazione usata.

Questa proprietà riflette il valore nella chiave del Registro di sistema.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM |CIMOM |Registrazione

Disattivato (0)

Registrazione degli errori (1)

Registrazione dettagliata degli errori (2)

LowThresholdOnClientObjects

Tipo di dati: uint32

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Soglia bassa per gli oggetti client"), unità ("oggetti al secondo")

Frequenza con cui WMI inizia a rallentare la creazione di nuovi oggetti creati per i client. Per supportare i differenziali di velocità tra provider e client, WMI contiene oggetti nelle code prima di distribuirli ai consumer. Per una maggiore efficienza, i consumer devono raccogliere gli oggetti a un ritmo corrispondente al provider. Se la frequenza delle richieste per gli oggetti raggiunge LowThresholdOnClientObjects, WMI rallenta gradualmente la creazione di nuovi oggetti in modo che corrisponda alla frequenza di utilizzo del client. Questo rallentamento inizia quando la frequenza con cui vengono creati gli oggetti supera il valore di questa proprietà. Vedere HighThresholdOnClientObjects.

Questa proprietà riflette il valore del Registro di sistema.

\KEY_LOCAL_MACHINE Software\Microsoft\WBEM\    CIMOM|Soglia elevata per gli oggetti client (B)

LowThresholdOnEvents

Tipo di dati: uint32

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Soglia bassa per gli eventi"), unità ("eventi al secondo")

Frequenza con cui WMI inizia a rallentare il recapito di nuovi eventi. Per supportare i differenziali di velocità tra provider e client, gli eventi di WMI vengono accodato prima di recapitarli ai consumer. Per una maggiore efficienza, i consumer devono raccogliere gli oggetti a un ritmo corrispondente al provider. Se la coda aumenta di controllo, la limitazione WMI rallenta gradualmente il recapito degli eventi per allinearsi alla frequenza client. Questo rallentamento inizia quando la frequenza con cui vengono generati eventi supera il valore di questa proprietà. Vedere HighThresholdOnEvents.

Nota

La limitazione viene eseguita solo per i consumer di eventi permanenti, quindi i consumer temporanei non devono aspettarsi limitazioni quando gli eventi vengono sottoposti a backup nella coda di eventi interni WMI.

 

Questa proprietà riflette il valore del Registro di sistema.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM\    CIMOM|Soglia elevata per gli oggetti client {B}

MaxLogFileSize

Tipo di dati: uint32

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Dimensioni massime file di log"), unità ("byte")

Dimensioni massime dei file di log prodotti dal servizio WMI.

Questa proprietà riflette il valore nella chiave del Registro di sistema.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM |CIMOM |Dimensioni massime file di log

MaxWaitOnClientObjects

Tipo di dati: uint32

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Max Wait On Events"), Unità ("millisecondi")

Quantità di tempo in cui un oggetto appena creato attende di essere usato dal client prima che venga rimosso e venga restituito un valore di errore. Questa proprietà interagisce con le proprietà LowThresholdOnClientObjects e HighThresholdOnClientObjects per limitare la limitazione, rallentando il recapito di oggetti ai consumer quando il consumer riceve gli oggetti troppo lentamente.

MaxWaitOnEvents

Tipo di dati: uint32

Tipo di accesso: lettura/scrittura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM\\CIMOM|Max Wait On Events"), Unità ("millisecondi")

Periodo di tempo per il quale un evento inviato a un client viene accodato prima di essere rimosso. Questa proprietà interagisce con LowThresholdOnEvents e HighThresholdOnEvents per limitare la limitazione, rallentando il recapito di oggetti ai consumer quando il consumer riceve gli oggetti troppo lentamente.

Questa proprietà riflette il valore del Registro di sistema.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM\    CIMOM|Max Wait On Events (ms)

MofSelfInstallDirectory

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\WBEM|Directory mof self-install")

Percorso della directory per le applicazioni che installano file MOF nel repository WMI. WMI compila automaticamente tutti i file MOF inseriti in questa directory e, a seconda dell'esito positivo, sposta mof in una sottodirectory con etichetta buona o negativa. Se il comando # pragma autorecover è incluso, il nome completo del file viene aggiunto all'elenco AutorecoverMofs usato quando WMI inizializza o ripristina il repository. L'elenco determina l'ordine in cui vengono compilati i file MOF.

Questa proprietà riflette il valore nella chiave del Registro di sistema.

\HKEY_LOCAL_MACHINE Software\Microsoft\WBEM |CIMOM |MOF Self=Install Directory

SettingID

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MaxLen (256)

Identificatore in base al quale è noto l'oggetto corrente.

Questa proprietà viene ereditata da CIM_Setting.

Osservazioni:

La classe Win32_WMISetting deriva da CIM_Setting. In un computer può esistere una sola istanza di questa classe.

Sapere come viene configurato WMI in un computer può essere molto utile quando si esegue il debug di script o si risopono problemi con il servizio WMI stesso. Ad esempio, molti script WMI vengono scritti presupponendo che root\cimv2 sia lo spazio dei nomi predefinito nel computer di destinazione. Di conseguenza, gli script writer che devono accedere a una classe in "Root\CIMv2" spesso non possono includere lo spazio dei nomi nel moniker GetObject, come illustrato nell'esempio di codice seguente:

Set colServices = GetObject("winmgmts:").ExecQuery ("SELECT * FROM Win32_Service")

Se root\cimv2 non è lo spazio dei nomi predefinito nel computer di destinazione, questo script avrà esito negativo. Per evitare questo problema, è necessario includere lo spazio dei nomi root\cimv2 nel moniker, come illustrato nell'esempio di codice seguente:

Set colServices = GetObject("winmgmts:root\cimv2").ExecQuery("SELECT * FROM Win32_Service")

Se lo spazio dei nomi predefinito nel computer di destinazione è diverso dallo spazio dei nomi assunto da uno script, lo script avrà esito negativo. Oltre a questo, l'utente verrà presentato con il messaggio di errore in qualche modo fuorviante "Classe non valida". In verità, l'errore non è dovuto al fatto che la classe non è valida, ma perché non è possibile trovare la classe nello spazio dei nomi predefinito. Si tratta di un problema difficile da risolvere, perché è probabile che si esaminino i possibili problemi con la classe anziché problemi con lo spazio dei nomi (o, in questo caso, non è stato specificato).

È possibile usare la classe Win32_WMISetting per determinare la modalità di configurazione di WMI in un computer. I dettagli di configurazione, ad esempio lo spazio dei nomi predefinito o il numero di build WMI, possono essere utili per la risoluzione dei problemi di script. Queste impostazioni forniscono anche informazioni amministrative importanti, ad esempio come o anche se gli errori WMI vengono registrati in un computer e quali provider WMI verranno ricaricati automaticamente se è necessario ricompilare il repository WMI.

Esempi

Nell'esempio di codice VBScript seguente viene illustrato come ottenere la versione di WMI in esecuzione nel computer locale. "Win32_WMISetting=@" indica la singola istanza della classe . Per altre informazioni, vedere Versioni WMI.

set objWMIService = GetObject("winmgmts:{impersonationLevel=Impersonate}!/Root/CIMv2")

set objWMISetting = objWMIService.Get("Win32_WMISetting=@")

WScript.Echo  objWMISetting.BuildVersion

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista
Server minimo supportato
 Windows Server 2008
Spazio dei nomi
 Root\CIMV2
MOF
CIMWin32.mof
DLL
Wbemcore.dll

Vedi anche

CIM_Setting

Classi di gestione dei servizi WMI