classe Win32_WMISetting
A classe WMI singleton Win32_WMISetting contém os parâmetros operacionais para o serviço WMI. Essa classe só pode ter uma instância, que sempre existe para cada sistema Windows e não pode ser excluída. Não é possível criar instâncias adicionais.
A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. Propriedades e métodos estão em ordem alfabética, não em ordem MOF.
Sintaxe
[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;
};
Membros
A classe Win32_WMISetting tem esses tipos de membros:
Propriedades
A classe Win32_WMISetting tem essas propriedades.
-
ASPScriptDefaultNamespace
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\scripting| Namespace padrão")
Namespace de script padrão. Essa propriedade contém o namespace usado por chamadas da API de Script para WMI se nenhuma for especificada pelo chamador.
Essa propriedade reflete o valor na chave do Registro.
HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM\ script| Namespace padrão
Exemplo: root\cimv2
Para obter um exemplo de script que usa essa propriedade, consulte a seção Comentários.
-
-
ASPScriptEnabled
-
-
Tipo de dados: booliano
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\scripting| Habilitar para ASP")
Se True, o script WMI pode ser usado em ASP (Active Server Pages). Essa propriedade é válida em sistemas que executam somente versões sem suporte do Windows. Para sistemas Windows com suporte, o script WMI sempre é permitido no ASP.
-
-
AutorecoverMofs
-
-
Tipo de dados: matriz de cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| MOFs de autorecover")
Lista de nomes de arquivo MOF totalmente qualificados usados para inicializar ou recuperar o repositório WMI. A lista determina a ordem na qual os arquivos MOF são compilados.
Essa propriedade reflete o valor na chave do Registro.
HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM\ CIMOM| MOFs autorecover
-
-
AutoStartWin9X
-
-
Tipo de dados: uint32
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| AutostartWin9X")
Sem suporte.
-
-
Não iniciar (0)
-
Início Automático (1)
-
Iniciar na reinicialização (2)
BackupInterval
-
Tipo de dados: uint32
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Limite de Intervalo de Backup"), Unidades ("minutos")
Sem suporte. Em vez disso, faça backup manualmente do repositório WMI.
BackupLastTime
-
Tipo de dados: datetime
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32API| Funções de tempo| GetTimeZoneInformation")
Data e hora em que o último backup foi executado.
BuildVersion
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM| Build")
Informações de versão para o serviço WMI instalado no momento.
Período de tempo decorrido entre backups do banco de dados WMI.
Essa propriedade reflete o valor na chave do Registro.
HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| Construir
Legenda
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MaxLen (64)
Descrição textual curta do objeto atual.
Essa propriedade é herdada de CIM_Setting.
DatabaseDirectory
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Diretório do repositório")
Caminho do diretório que contém o repositório WMI.
DatabaseMaxSize
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Tamanho máximo do BD"), unidades ("kilobytes")
Tamanho máximo do repositório WMI.
Descrição
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
Descrição textual do objeto atual.
Essa propriedade é herdada de CIM_Setting.
EnableAnonWin9xConnections
-
Tipo de dados: booliano
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| EnableAnonConnections")
Sem suporte.
EnableEvents
-
Tipo de dados: booliano
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| EnableEvents")
Se True, o subsistema de eventos WMI deverá ser habilitado.
Essa propriedade reflete o valor na chave do Registro.
HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| EnableEvents
EnableStartupHeapPreallocation
-
Tipo de dados: booliano
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| EnableStartupHeapPreallocation")
Se True, o WMI criará um heap pré-alocado com o tamanho do valor LastStartupHeapPreallocation quando o WMI for inicializado.
HighThresholdOnClientObjects
-
Tipo de dados: uint32
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Limite alto em objetos cliente"), unidades ("objetos por segundo")
Taxa máxima na qual os objetos criados pelo provedor podem ser entregues aos clientes. Para acomodar diferenciais de velocidade entre provedores e clientes, o WMI mantém objetos em filas antes de entregá-los aos consumidores. Para obter mais eficiência, os consumidores devem coletar os objetos em um ritmo que corresponda ao provedor. Se a memória mantida por objetos não coletados atingir LowThresholdOnObjects, o WMI diminuirá a adição de novos objetos na fila. Se os eventos não coletados continuarem a se acumular e a espera máxima para entregar eventos em MaxWaitOnClientObjects for atingida enquanto a memória usada estiver no valor em HighThresholdOnClientObjects, o WMI não aceitará mais objetos de provedores e retornará WBEM_E_OUT_OF_MEMORY aos clientes.
HighThresholdOnEvents
-
Tipo de dados: uint32
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Limite alto em eventos"), unidades ("eventos por segundo")
Taxa máxima na qual os eventos devem ser entregues aos clientes. Para acomodar diferenciais de velocidade entre provedores e clientes, o WMI enfileira eventos antes de entregá-los aos consumidores. Para obter mais eficiência, os consumidores devem coletar os eventos em um ritmo que corresponda ao provedor. Se a memória mantida por eventos não coletados atingir LowThresholdOnObjects, o WMI diminuirá a adição de novos eventos na fila. Se os eventos não coletados continuarem a se acumular e a espera máxima para entregar eventos em MaxWaitOnEvents for atingida enquanto a memória usada estiver no valor em HighThresholdOnEvents, o WMI não aceitará mais eventos de provedores e retornará WBEM_E_OUT_OF_MEMORY aos clientes.
Observação
A limitação só é feita para consumidores de Eventos Permanentes, portanto, os consumidores temporários não devem esperar limitação quando os eventos são submetidos a backup na fila de eventos interna do WMI.
Essa propriedade reflete o valor na chave do Registro.
HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM\ CIMOM| Limite alto em objetos cliente (B)
InstallationDirectory
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM| Diretório de Instalação")
Caminho do diretório em que o software WMI foi instalado. O local padrão é \System32\Wbem.
Essa propriedade reflete o valor na chave do Registro.
HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| Diretório de Instalação
LastStartupHeapPreallocation
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| LastStartupHeapPreallocation"), Unidades ("bytes")
Tamanho do heap pré-alocado criado pelo WMI durante a inicialização.
Essa propriedade reflete o valor na chave do Registro.
HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| LastStartupHeapPreallocation
LoggingDirectory
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Diretório de registro em log")
Caminho do diretório que contém o local dos arquivos de log do sistema WMI.
Essa propriedade reflete o valor na chave do Registro.
HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| Diretório de registro em log
LoggingLevel
-
Tipo de dados: uint32
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Registro em log")
Habilitação do log de eventos e do nível de detalhamento do registro em log usado.
Essa propriedade reflete o valor na chave do Registro.
HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| Log
Desativado (0)
Log de erros (1)
Log detalhado de erros (2)
LowThresholdOnClientObjects
-
Tipo de dados: uint32
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Limite baixo em objetos cliente"), unidades ("objetos por segundo")
Taxa na qual o WMI começa a retardar a criação de novos objetos criados para clientes. Para acomodar diferenciais de velocidade entre provedores e clientes, o WMI mantém objetos em filas antes de entregá-los aos consumidores. Para obter mais eficiência, os consumidores devem coletar os objetos em um ritmo que corresponda ao provedor. Se a taxa de solicitações de objetos atingir LowThresholdOnClientObjects, o WMI diminuirá gradualmente a criação de novos objetos para corresponder à taxa de uso do cliente. Essa lentidão começa quando a taxa na qual os objetos estão sendo criados excede o valor dessa propriedade. Consulte HighThresholdOnClientObjects.
Essa propriedade reflete o valor do Registro.
\ KEY_LOCAL_MACHINE Software\Microsoft\WBEM\ CIMOM| Limite alto em objetos cliente (B)
LowThresholdOnEvents
-
Tipo de dados: uint32
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Limite baixo em eventos"), unidades ("eventos por segundo")
Taxa na qual o WMI começa a diminuir a entrega de novos eventos. Para acomodar diferenciais de velocidade entre provedores e clientes, o WMI enfileira eventos antes de entregá-los aos consumidores. Para obter mais eficiência, os consumidores devem coletar os objetos em um ritmo que corresponda ao provedor. Se a fila ficar fora de controle, o WMI reduzirá a velocidade da entrega de eventos gradualmente para se alinhar à taxa de cliente. Essa lentidão começa quando a taxa na qual os eventos são gerados excede o valor dessa propriedade. Consulte HighThresholdOnEvents.
Observação
A limitação só é feita para consumidores de eventos permanentes, portanto, os consumidores temporários não devem esperar limitação quando os eventos são submetidos a backup na fila de eventos interna do WMI.
Essa propriedade reflete o valor do Registro.
HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM\ CIMOM| Limite alto em objetos de cliente {B}
MaxLogFileSize
-
Tipo de dados: uint32
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Tamanho Máximo do Arquivo de Log"), Unidades ("bytes")
Tamanho máximo dos arquivos de log produzidos pelo serviço WMI.
Essa propriedade reflete o valor na chave do Registro.
HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| Tamanho Máximo do Arquivo de Log
MaxWaitOnClientObjects
-
Tipo de dados: uint32
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Espera máxima em eventos"), unidades ("milissegundos")
Quantidade de tempo que um objeto recém-criado aguarda para ser usado pelo cliente antes de ser descartado e um valor de erro é retornado. Essa propriedade interage com as propriedades LowThresholdOnClientObjects e HighThresholdOnClientObjects para limitar— reduzir a velocidade — a entrega de objetos aos consumidores quando o consumidor está recebendo os objetos muito lentamente.
MaxWaitOnEvents
-
Tipo de dados: uint32
-
Tipo de acesso: leitura/gravação
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Máximo de espera em eventos"), unidades ("milissegundos")
Quantidade de tempo para o qual um evento enviado a um cliente é enfileirado antes de ser descartado. Essa propriedade interage0 com LowThresholdOnEvents e HighThresholdOnEvents para limitar— reduzir a velocidade — a entrega de objetos aos consumidores quando o consumidor estiver recebendo os objetos muito lentamente.
Essa propriedade reflete o valor do Registro.
HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM\ CIMOM| Máximo de Eventos de Espera (ms)
MofSelfInstallDirectory
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM| Diretório de Self-Install MOF")
Caminho de diretório para aplicativos que instalam arquivos MOF no repositório WMI. O WMI compila automaticamente todos os arquivos MOF colocados neste diretório e, dependendo de seu sucesso, move o MOF para um subdiretório rotulado como bom ou ruim. Se o comando # pragma autorecover estiver incluído, o nome de arquivo totalmente qualificado será adicionado à lista AutorecoverMofs usada quando o WMI estiver inicializando ou recuperando o repositório. A lista determina a ordem na qual os MOFs são compilados.
Essa propriedade reflete o valor na chave do Registro.
HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| Diretório MOF Self=Install
Settingid
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MaxLen (256)
Identificador pelo qual o objeto atual é conhecido.
Essa propriedade é herdada de CIM_Setting.
Comentários
A classe Win32_WMISetting é derivada de CIM_Setting. Somente uma instância dessa classe pode existir em um computador.
Saber como o WMI é configurado em um computador pode ser muito útil quando você está depurando scripts ou solucionando problemas com o próprio serviço WMI. Por exemplo, muitos scripts WMI são gravados sob a suposição de que root\cimv2 é o namespace padrão no computador de destino. Como resultado, os gravadores de script que precisam acessar uma classe em "Root\CIMv2" geralmente não incluem o namespace no moniker GetObject, conforme mostrado no seguinte exemplo de código:
Set colServices = GetObject("winmgmts:").ExecQuery ("SELECT * FROM Win32_Service")
Se root\cimv2 não for o namespace padrão no computador de destino, esse script falhará. Para evitar que isso aconteça, a raiz do namespace\cimv2 deve ser incluída no moniker, conforme mostrado no seguinte exemplo de código:
Set colServices = GetObject("winmgmts:root\cimv2").ExecQuery("SELECT * FROM Win32_Service")
Se o namespace padrão no computador de destino for diferente do namespace assumido por um script, o script falhará. Além disso, o usuário receberá a mensagem de erro um tanto enganosa "Classe inválida". Na verdade, a falha não é porque a classe é inválida, mas porque a classe não pode ser encontrada no namespace padrão. Esse é um problema difícil de solucionar, pois é provável que você investigue possíveis problemas com a classe em vez de problemas com o namespace que foi (ou, neste caso, não foi) especificado.
Você pode usar a classe Win32_WMISetting para determinar como o WMI foi configurado em um computador. Detalhes de configuração, como o namespace padrão ou o número de build WMI, podem ser úteis na solução de problemas de script. Essas configurações também fornecem informações administrativas importantes, como, ou mesmo se, erros WMI são registrados em um computador e quais provedores WMI serão recarregados automaticamente se você precisar recriar o repositório WMI.
Exemplos
O exemplo de código Modifi WMI Settings VBScript na Galeria do TechNet usa a classe Win32_WMISetting para configurar o intervalo de backup do WMI e o nível de registro em log.
O exemplo de código List the Default Namespace VBScript na Galeria do TechNet usa a classe Win32_WMISetting para recuperar e exibir a configuração atual do WMI "Namespace padrão para scripts".
O exemplo de código Modifi the Default WMI Namespace VBScript na Galeria technet usa a propriedade ASPScriptDefaultNamespace para definir a configuração WMI "Namespace padrão para script" como "root\cimv2".
O exemplo de código List All the WMI Settings VBSCript usa várias propriedades em Win32_WMISetting para retornar uma lista de configurações de WMI definidas em um computador.
O exemplo de código JavaScript de Informações de Configuração do WMI de Lista usa várias propriedades em Win32_WMISetting para retornar uma lista de configurações de WMI definidas em um computador.
O exemplo de código Python de Configuração de WMI de Lista usa várias propriedades em Win32_WMISetting para retornar uma lista de configurações de WMI definidas em um computador.
O exemplo de código REXX do Objeto de Informações de Configuração do WMI de Lista usa várias propriedades no Win32_WMISetting para retornar uma lista de configurações de WMI definidas em um computador.
O exemplo de código VBScript a seguir mostra como obter a versão do WMI em execução no computador local. O "Win32_WMISetting=@" indica a instância única da classe . Para obter mais informações, consulte Versões do WMI.
set objWMIService = GetObject("winmgmts:{impersonationLevel=Impersonate}!/Root/CIMv2")
set objWMISetting = objWMIService.Get("Win32_WMISetting=@")
WScript.Echo objWMISetting.BuildVersion
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de