classe Win32_WMISetting

Artigo
06/12/2023

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

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	CIMWin32.mof
DLL	Wbemcore.dll

Confira também

CIM_Setting
Classes de gerenciamento de serviço WMI

Compartilhar via

classe Win32_WMISetting

Sintaxe

Membros

Propriedades

Comentários

Exemplos

Requisitos

Confira também

Comentários

Recursos adicionais