Compartir a través de

Win32_WMISetting clase

  • Artículo

La Win32_WMISettingclase WMI singleton contiene los parámetros operativos para el servicio WMI. Esta clase solo puede tener una instancia, que siempre existe para cada sistema Windows y no se puede eliminar. No se pueden crear instancias adicionales.

La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades y los métodos están en orden alfabético, no en orden MOF.

Sintaxis

[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;
};

Miembros

La clase Win32_WMISetting tiene estos tipos de miembros:

Propiedades

La clase Win32_WMISetting tiene estas propiedades.

ASPScriptDefaultNamespace

Tipo de datos: cadena

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\scripting| Espacio de nombres predeterminado")

Espacio de nombres de script predeterminado. Esta propiedad contiene el espacio de nombres que usan las llamadas de la API de scripting para WMI si el autor de la llamada no especifica ninguno.

Esta propiedad refleja el valor en la clave del Registro.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM\    scripting| Espacio de nombres predeterminado

Ejemplo: root\cimv2

Para obtener un script de ejemplo que use esta propiedad, vea la sección Comentarios.

ASPScriptEnabled

Tipo de datos: booleano

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\scripting| Habilitar para ASP")

Si es True, el scripting WMI se puede usar en páginas de servidor activo (ASP). Esta propiedad es válida en sistemas que solo ejecutan versiones no admitidas de Windows. En el caso de los sistemas Windows compatibles, el scripting WMI siempre se permite en ASP.

AutorecoverMofs

Tipo de datos: matriz de cadenas

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| MOFs de conmutación automática")

Lista de nombres de archivo MOF completos usados para inicializar o recuperar el repositorio WMI. La lista determina el orden en que se compilan los archivos MOF.

Esta propiedad refleja el valor en la clave del Registro.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM\    CIMOM| MOFs de conmutación automática

AutoStartWin9X

Tipo de datos: uint32

Tipo de acceso: lectura/escritura

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

No compatible.

No empiece (0)

Inicio automático (1)

Iniciar el reinicio (2)

BackupInterval

Tipo de datos: uint32

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Umbral de intervalo de copia de seguridad"), unidades ("minutos")

No compatible. En su lugar, realice una copia de seguridad del repositorio WMI manualmente.

BackupLastTime

Tipo de datos: datetime

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32API| Funciones de hora | GetTimeZoneInformation")

Fecha y hora en que se realizó la última copia de seguridad.

BuildVersion

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM| Compilación")

Información de versión del servicio WMI instalado actualmente.

Período de tiempo transcurrido entre las copias de seguridad de la base de datos WMI.

Esta propiedad refleja el valor en la clave del Registro.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| Construir

Caption

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (64)

Descripción textual breve del objeto actual.

Esta propiedad se hereda de CIM_Setting.

DatabaseDirectory

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Directorio del repositorio")

Ruta de acceso del directorio que contiene el repositorio WMI.

DatabaseMaxSize

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Tamaño máximo de la base de datos"), unidades ("kilobytes")

Tamaño máximo del repositorio WMI.

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Descripción textual del objeto actual.

Esta propiedad se hereda de CIM_Setting.

EnableAnonWin9xConnections

Tipo de datos: booleano

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| EnableAnonConnections")

No compatible.

EnableEvents

Tipo de datos: booleano

Tipo de acceso: lectura/escritura

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

Si es True, se debe habilitar el subsistema de eventos WMI.

Esta propiedad refleja el valor en la clave del Registro.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| EnableEvents

EnableStartupHeapPreallocation

Tipo de datos: booleano

Tipo de acceso: lectura/escritura

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

Si es True, WMI crea un montón asignado previamente con el tamaño del valor LastStartupHeapPreallocation cuando se inicializa WMI.

HighThresholdOnClientObjects

Tipo de datos: uint32

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Umbral alto en objetos de cliente"), unidades ("objetos por segundo")

Velocidad máxima a la que se pueden entregar objetos creados por el proveedor a los clientes. Para dar cabida a los diferenciales de velocidad entre proveedores y clientes, WMI contiene objetos en colas antes de entregarlos a los consumidores. Para mejorar la eficacia, los consumidores deben recopilar los objetos a un ritmo que coincida con el proveedor. Si la memoria mantenida por objetos no agrupados alcanza LowThresholdOnObjects, WMI ralentiza la adición de nuevos objetos a la cola. Si los eventos no recopilados continúan acumulando y se alcanza la espera máxima para entregar eventos en MaxWaitOnClientObjects mientras la memoria usada se encuentra en el valor de HighThresholdOnClientObjects, WMI no acepta más objetos de proveedores y devuelve WBEM_E_OUT_OF_MEMORY a los clientes.

HighThresholdOnEvents

Tipo de datos: uint32

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Umbral alto en eventos"), unidades ("eventos por segundo")

Velocidad máxima a la que se entregarán los eventos a los clientes. Para dar cabida a las diferenciales de velocidad entre proveedores y clientes, WMI pone en cola eventos antes de entregarlos a los consumidores. Para mejorar la eficacia, los consumidores deben recopilar los eventos a un ritmo que coincida con el proveedor. Si la memoria mantenida por eventos no agrupados alcanza LowThresholdOnObjects, WMI ralentiza la adición de nuevos eventos en la cola. Si los eventos no recopilados continúan acumulando y se alcanza la espera máxima para entregar eventos en MaxWaitOnEvents mientras la memoria usada se encuentra en el valor de HighThresholdOnEvents, WMI no acepta más eventos de proveedores y devuelve WBEM_E_OUT_OF_MEMORY a los clientes.

Nota

La limitación solo se realiza para los consumidores de eventos permanentes, por lo que los consumidores temporales no deben esperar limitación cuando se realiza una copia de seguridad de los eventos en la cola de eventos internos de WMI.

 

Esta propiedad refleja el valor de la clave del Registro.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM\    CIMOM| Umbral alto en objetos de cliente (B)

InstallationDirectory

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM| Directorio de instalación")

Ruta de acceso del directorio donde se ha instalado el software WMI. La ubicación predeterminada es \System32\Wbem.

Esta propiedad refleja el valor de la clave del Registro.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| Directorio de instalación

LastStartupHeapPreallocation

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| LastStartupHeapPreallocation"), Unidades ("bytes")

Tamaño del montón asignado previamente creado por WMI durante la inicialización.

Esta propiedad refleja el valor de la clave del Registro.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| LastStartupHeapPreallocation

LoggingDirectory

Tipo de datos: cadena

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Directorio de registro")

Ruta de acceso del directorio que contiene la ubicación de los archivos de registro del sistema WMI.

Esta propiedad refleja el valor de la clave del Registro.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| Directorio de registro

LoggingLevel

Tipo de datos: uint32

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Registro")

Habilitación del registro de eventos y el nivel de detalle del registro usado.

Esta propiedad refleja el valor de la clave del Registro.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| Registro

Desactivado (0)

Registro de errores (1)

Registro detallado de errores (2)

LowThresholdOnClientObjects

Tipo de datos: uint32

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Umbral bajo en objetos de cliente"), unidades ("objetos por segundo")

Velocidad a la que WMI comienza a ralentizar la creación de nuevos objetos creados para los clientes. Para dar cabida a los diferenciales de velocidad entre proveedores y clientes, WMI contiene objetos en colas antes de entregarlos a los consumidores. Para mejorar la eficacia, los consumidores deben recopilar los objetos a un ritmo que coincida con el proveedor. Si la tasa de solicitudes de objetos alcanza LowThresholdOnClientObjects, WMI ralentiza gradualmente la creación de nuevos objetos para que coincidan con la tasa de uso del cliente. Esta ralentización comienza cuando la velocidad a la que se crean los objetos supera el valor de esta propiedad. Consulte HighThresholdOnClientObjects.

Esta propiedad refleja el valor del Registro.

\ KEY_LOCAL_MACHINE Software\Microsoft\WBEM\    CIMOM| Umbral alto en objetos de cliente (B)

LowThresholdOnEvents

Tipo de datos: uint32

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Umbral bajo en eventos"), unidades ("eventos por segundo")

Velocidad a la que WMI comienza a ralentizar la entrega de nuevos eventos. Para dar cabida a las diferenciales de velocidad entre proveedores y clientes, WMI pone en cola eventos antes de entregarlos a los consumidores. Para mejorar la eficacia, los consumidores deben recopilar los objetos a un ritmo que coincida con el proveedor. Si la cola crece fuera de control, las limitaciones de WMI (ralentizan) la entrega de eventos gradualmente para alinearse con la tasa de cliente. Esta ralentización se inicia cuando la velocidad a la que se generan eventos supera el valor de esta propiedad. Consulte HighThresholdOnEvents.

Nota

La limitación solo se realiza para los consumidores de eventos permanentes, por lo que los consumidores temporales no deben esperar una limitación cuando se realiza una copia de seguridad de los eventos en la cola de eventos internos de WMI.

 

Esta propiedad refleja el valor del Registro.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM\    CIMOM| Umbral alto en objetos de cliente {B}

MaxLogFileSize

Tipo de datos: uint32

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Tamaño máximo del archivo de registro"), unidades ("bytes")

Tamaño máximo de los archivos de registro generados por el servicio WMI.

Esta propiedad refleja el valor de la clave del Registro.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| Tamaño máximo del archivo de registro

MaxWaitOnClientObjects

Tipo de datos: uint32

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Número máximo de eventos de espera"), unidades ("milisegundos")

Cantidad de tiempo que el cliente espera a usar un objeto recién creado antes de descartarlo y se devuelve un valor de error. Esta propiedad interactúa con las propiedades LowThresholdOnClientObjects y HighThresholdOnClientObjects para limitar, ralentizar, la entrega de objetos a los consumidores cuando el consumidor recibe los objetos demasiado lentamente.

MaxWaitOnEvents

Tipo de datos: uint32

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Número máximo de eventos de espera"), unidades ("milisegundos")

Cantidad de tiempo durante el que se pone en cola un evento enviado a un cliente antes de descartarse. Esta propiedad interactúa0 con LowThresholdOnEvents y HighThresholdOnEvents para limitar, ralentizar, la entrega de objetos a los consumidores cuando el consumidor recibe los objetos demasiado lentamente.

Esta propiedad refleja el valor del Registro.

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

MofSelfInstallDirectory

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM| MOF Self-Install Directory")

Ruta de acceso de directorio para las aplicaciones que instalan archivos MOF en el repositorio WMI. WMI compila automáticamente los archivos MOF colocados en este directorio y, en función de su éxito, mueve el MOF a un subdirectorio etiquetado como correcto o incorrecto. Si se incluye el comando # pragma autorecover , el nombre de archivo completo se agrega a la lista AutorecoverMofs que se usa cuando WMI inicializa o recupera el repositorio. La lista determina el orden en que se compilan los MOF.

Esta propiedad refleja el valor de la clave del Registro.

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

SettingID

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (256)

Identificador por el que se conoce el objeto actual.

Esta propiedad se hereda de CIM_Setting.

Comentarios

La clase Win32_WMISetting se deriva de CIM_Setting. Solo puede existir una instancia de esta clase en un equipo.

Saber cómo se configura WMI en un equipo puede ser muy útil al depurar scripts o solucionar problemas con el propio servicio WMI. Por ejemplo, muchos scripts WMI se escriben bajo la suposición de que root\cimv2 es el espacio de nombres predeterminado en el equipo de destino. Como resultado, los escritores de scripts que necesitan acceder a una clase en "Root\CIMv2" a menudo no pueden incluir el espacio de nombres en el moniker GetObject, como se muestra en el ejemplo de código siguiente:

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

Si root\cimv2 no es el espacio de nombres predeterminado en el equipo de destino, se producirá un error en este script. Para evitar que esto suceda, el espacio de nombres root\cimv2 debe incluirse en el moniker, como se muestra en el ejemplo de código siguiente:

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

Si el espacio de nombres predeterminado en el equipo de destino es diferente del espacio de nombres asumido por un script, se producirá un error en el script. Además, al usuario se le presentará el mensaje de error algo engañoso "Clase no válida". En realidad, el error no se debe a que la clase no es válida, pero porque la clase no se encuentra en el espacio de nombres predeterminado. Este es un problema difícil de solucionar, ya que es probable que investigue posibles problemas con la clase en lugar de problemas con el espacio de nombres que era (o, en este caso, no se especificó).

Puede usar la clase Win32_WMISetting para determinar cómo se ha configurado WMI en un equipo. Los detalles de configuración, como el espacio de nombres predeterminado o el número de compilación de WMI, pueden ser útiles para solucionar problemas de script. Esta configuración también proporciona información administrativa importante, como cómo, o incluso si, los errores de WMI se registran en un equipo y qué proveedores WMI se volverán a cargar automáticamente si necesita volver a generar el repositorio WMI.

Ejemplos

El ejemplo de código Modify WMI Settings VBScript (Modificar configuración de WMI ) en la Galería de TechNet usa la clase Win32_WMISetting para configurar el intervalo de copia de seguridad de WMI y el nivel de registro.

El ejemplo de código List the Default Namespace VBScript en la Galería de TechNet usa la clase Win32_WMISetting para recuperar y mostrar la configuración actual de WMI "Default namespace for scripting".

El ejemplo de código Modify the Default WMI Namespace VBScript on the TechNet Gallery usa la propiedad ASPScriptDefaultNamespace para establecer el valor "Default namespace for scripting" de WMI en "root\cimv2".

El ejemplo de código List All the WMI Settings VBSCript usa varias propiedades en Win32_WMISetting para devolver una lista de opciones de WMI configuradas en un equipo.

El ejemplo de código JavaScript List WMI Setting Information usa una serie de propiedades en Win32_WMISetting para devolver una lista de opciones de WMI configuradas en un equipo.

En el ejemplo de código enumerar información de configuración de WMI de Python se usa una serie de propiedades en Win32_WMISetting para devolver una lista de opciones de WMI configuradas en un equipo.

En el ejemplo de código rexx del objeto de información de configuración WMI de lista se usa una serie de propiedades en Win32_WMISetting para devolver una lista de opciones de WMI configuradas en un equipo.

En el siguiente ejemplo de código de VBScript se muestra cómo obtener la versión de WMI que se ejecuta en el equipo local. "Win32_WMISetting=@" indica la única instancia de la clase . Para obtener más información, vea Versiones de WMI.

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

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

WScript.Echo  objWMISetting.BuildVersion

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows Vista
Servidor mínimo compatible
 Windows Server 2008
Espacio de nombres
 Root\CIMV2
MOF
CIMWin32.mof
Archivo DLL
Wbemcore.dll

Consulte también

CIM_Setting

Clases de administración de servicios WMI