Win32_WMISetting clase
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 |
|
| Archivo DLL |
|
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de