Classe Win32_WMISetting
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 |
|
| DLL |
|
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per