classe Win32_WMISetting

  • Article

La classe WMIsingleton Win32_WMISetting contient les paramètres opérationnels du service WMI. Cette classe ne peut avoir qu’une seule instance, qui existe toujours pour chaque système Windows et ne peut pas être supprimée. Impossible de créer des instances supplémentaires.

La syntaxe suivante est simplifiée à partir de code au format MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés et les méthodes sont dans l’ordre alphabétique, et non dans l’ordre MOF.

Syntaxe

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

Membres

La classe Win32_WMISetting a les types de membres suivants :

Propriétés

La classe Win32_WMISetting possède ces propriétés.

ASPScriptDefaultNamespace

Type de données : chaîne

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\scripting| Espace de noms par défaut »)

Espace de noms de script par défaut. Cette propriété contient l’espace de noms utilisé par les appels de l’API Scripting pour WMI si aucun n’est spécifié par l’appelant.

Cette propriété reflète la valeur dans la clé de Registre.

HKEY_LOCAL_MACHINE\Logiciel\Microsoft\WBEM\    scripting| Espace de noms par défaut

Exemple : root\cimv2

Pour obtenir un exemple de script qui utilise cette propriété, consultez la section Remarques.

ASPScriptEnabled

Type de données : booléen

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\scripting| Activer pour ASP »)

Si la valeur est True, les scripts WMI peuvent être utilisés sur les pages ASP (Active Server Pages). Cette propriété est valide sur les systèmes exécutant des versions non prises en charge de Windows uniquement. Pour les systèmes Windows pris en charge, les scripts WMI sont toujours autorisés sur ASP.

Récupération automatiqueMofs

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Récupération automatique des moFs »)

Liste des noms de fichiers MOF complets utilisés pour initialiser ou récupérer le dépôt WMI. La liste détermine l’ordre dans lequel les fichiers MOF sont compilés.

Cette propriété reflète la valeur dans la clé de Registre.

HKEY_LOCAL_MACHINE\Logiciel\Microsoft\WBEM\    CIMOM| Récupération automatique des moFs

Démarrage automatiqueWin9X

Type de données : uint32

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Démarrage automatiqueWin9X »)

Non pris en charge.

Ne pas démarrer (0)

Démarrage automatique (1)

Démarrer au redémarrage (2)

BackupInterval

Type de données : uint32

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Seuil de l’intervalle de sauvegarde »), unités (« minutes »)

Non pris en charge. Au lieu de cela, sauvegardez le référentiel WMI manuellement.

BackupLastTime

Type de données : datetime

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32API| Fonctions de temps| GetTimeZoneInformation »)

Date et heure de la dernière sauvegarde effectuée.

BuildVersion

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM| Build »)

Informations sur la version du service WMI actuellement installé.

Durée qui s’écoule entre les sauvegardes de la base de données WMI.

Cette propriété reflète la valeur dans la clé de Registre.

HKEY_LOCAL_MACHINE\Logiciel\Microsoft\WBEM| Construire

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64)

Brève description textuelle de l’objet actif.

Cette propriété est héritée de CIM_Setting.

DatabaseDirectory

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Répertoire du référentiel »)

Chemin du répertoire qui contient le dépôt WMI.

DatabaseMaxSize

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Taille maximale de base de données »), Unités (« kilo-octets »)

Taille maximale du dépôt WMI.

Description

Type de données : chaîne

Type d'accès : Lecture seule

Description textuelle de l’objet actif.

Cette propriété est héritée de CIM_Setting.

EnableAnonWin9xConnections

Type de données : booléen

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| EnableAnonConnections »)

Non pris en charge.

EnableEvents

Type de données : booléen

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| EnableEvents »)

Si la valeur est True, le sous-système d’événement WMI doit être activé.

Cette propriété reflète la valeur dans la clé de Registre.

HKEY_LOCAL_MACHINE\Logiciel\Microsoft\WBEM| CIMOM| EnableEvents

EnableStartupHeapPreallocation

Type de données : booléen

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| EnableStartupHeapPreallocation »)

Si la valeur est True, WMI crée un tas pré-alloué avec la taille de la valeur LastStartupHeapPreallocation lorsque WMI est initialisé.

HighThresholdOnClientObjects

Type de données : uint32

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Seuil élevé sur les objets clients), unités (« objets par seconde »)

Vitesse maximale à laquelle les objets créés par le fournisseur peuvent être remis aux clients. Pour prendre en charge les différences de vitesse entre les fournisseurs et les clients, WMI conserve les objets dans les files d’attente avant de les remettre aux consommateurs. Pour plus d’efficacité, les consommateurs doivent collecter les objets à un rythme qui correspond au fournisseur. Si la mémoire détenue par des objets non collectés atteint LowThresholdOnObjects, WMI ralentit l’ajout de nouveaux objets dans la file d’attente. Si les événements non collectés continuent de s’accumuler et que l’attente maximale pour remettre des événements dans MaxWaitOnClientObjects est atteinte alors que la mémoire utilisée est à la valeur dans HighThresholdOnClientObjects, WMI n’accepte plus d’objets des fournisseurs et retourne WBEM_E_OUT_OF_MEMORY aux clients.

HighThresholdOnEvents

Type de données : uint32

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Seuil élevé sur les événements »), unités (« événements par seconde »)

Vitesse maximale à laquelle les événements doivent être remis aux clients. Pour prendre en charge les différences de vitesse entre les fournisseurs et les clients, WMI met en file d’attente les événements avant de les remettre aux consommateurs. Pour plus d’efficacité, les consommateurs doivent collecter les événements à un rythme qui correspond au fournisseur. Si la mémoire détenue par les événements non collectés atteint LowThresholdOnObjects, WMI ralentit l’ajout de nouveaux événements dans la file d’attente. Si les événements non collectés continuent de s’accumuler et que l’attente maximale pour remettre des événements dans MaxWaitOnEvents est atteinte alors que la mémoire utilisée est à la valeur dans HighThresholdOnEvents, WMI n’accepte plus d’événements des fournisseurs et retourne WBEM_E_OUT_OF_MEMORY aux clients.

Notes

La limitation est effectuée uniquement pour les consommateurs d’événements permanents. Les consommateurs temporaires ne doivent donc pas s’attendre à une limitation lorsque les événements sont sauvegardés dans la file d’attente d’événements interne WMI.

 

Cette propriété reflète la valeur dans la clé de Registre.

HKEY_LOCAL_MACHINE\Logiciel\Microsoft\WBEM\    CIMOM| Seuil élevé sur les objets clients (B)

InstallationDirectory

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM| Répertoire d’installation »)

Chemin d’accès au répertoire où le logiciel WMI a été installé. L’emplacement par défaut est \System32\Wbem.

Cette propriété reflète la valeur dans la clé de Registre.

HKEY_LOCAL_MACHINE\Logiciel\Microsoft\WBEM| Répertoire d’installation

LastStartupHeapPreallocation

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| LastStartupHeapPreallocation »), Unités (« octets »)

Taille du tas pré-alloué créé par WMI pendant l’initialisation.

Cette propriété reflète la valeur dans la clé de Registre.

HKEY_LOCAL_MACHINE\Logiciel\Microsoft\WBEM| CIMOM| LastStartupHeapPreallocation

LoggingDirectory

Type de données : chaîne

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Répertoire de journalisation « )

Chemin du répertoire qui contient l’emplacement des fichiers journaux système WMI.

Cette propriété reflète la valeur dans la clé de Registre.

HKEY_LOCAL_MACHINE\Logiciel\Microsoft\WBEM| CIMOM| Journalisation du répertoire

LoggingLevel

Type de données : uint32

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Journalisation »)

Activation de la journalisation des événements et du niveau de détail de la journalisation utilisée.

Cette propriété reflète la valeur dans la clé de Registre.

HKEY_LOCAL_MACHINE\Logiciel\Microsoft\WBEM| CIMOM| Enregistrement

Désactivé (0)

Journalisation des erreurs (1)

Journalisation des erreurs détaillées (2)

LowThresholdOnClientObjects

Type de données : uint32

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Seuil faible sur les objets clients »), unités (« objets par seconde »)

Vitesse à laquelle WMI commence à ralentir la création de nouveaux objets créés pour les clients. Pour prendre en charge les différences de vitesse entre les fournisseurs et les clients, WMI conserve les objets dans les files d’attente avant de les remettre aux consommateurs. Pour plus d’efficacité, les consommateurs doivent collecter les objets à un rythme qui correspond au fournisseur. Si le taux de demandes d’objets atteint LowThresholdOnClientObjects, WMI ralentit progressivement la création de nouveaux objets pour correspondre au taux d’utilisation du client. Ce ralentissement commence lorsque la vitesse à laquelle les objets sont créés dépasse la valeur de cette propriété. Consultez HighThresholdOnClientObjects.

Cette propriété reflète la valeur du Registre.

\ KEY_LOCAL_MACHINE Logiciel\Microsoft\WBEM\    CIMOM| Seuil élevé sur les objets clients (B)

LowThresholdOnEvents

Type de données : uint32

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Seuil faible sur les événements »), unités (« événements par seconde »)

Vitesse à laquelle WMI commence à ralentir la livraison de nouveaux événements. Pour prendre en charge les différences de vitesse entre les fournisseurs et les clients, WMI met en file d’attente les événements avant de les remettre aux consommateurs. Pour plus d’efficacité, les consommateurs doivent collecter les objets à un rythme qui correspond au fournisseur. Si la file d’attente devient hors de contrôle, WMI limite (ralentit) la remise des événements progressivement pour s’aligner sur le taux client. Ce ralentissement commence lorsque la vitesse à laquelle les événements sont générés dépasse la valeur de cette propriété. Consultez HighThresholdOnEvents.

Notes

La limitation est effectuée uniquement pour les consommateurs d’événements permanents. Les consommateurs temporaires ne doivent donc pas s’attendre à une limitation lorsque les événements sont sauvegardés dans la file d’attente d’événements interne WMI.

 

Cette propriété reflète la valeur du Registre.

HKEY_LOCAL_MACHINE\Logiciel\Microsoft\WBEM\    CIMOM| Seuil élevé sur les objets clients {B}

MaxLogFileSize

Type de données : uint32

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Taille maximale du fichier journal « ), unités (« octets »)

Taille maximale des fichiers journaux produits par le service WMI.

Cette propriété reflète la valeur dans la clé de Registre.

HKEY_LOCAL_MACHINE\Logiciel\Microsoft\WBEM| CIMOM| Taille maximale du fichier journal

MaxWaitOnClientObjects

Type de données : uint32

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Nombre maximal d’événements d’attente »), unités (« millisecondes »)

Durée pendant laquelle un objet nouvellement créé attend d’être utilisé par le client avant d’être ignoré et qu’une valeur d’erreur soit retournée. Cette propriété interagit avec les propriétés LowThresholdOnClientObjects et HighThresholdOnClientObjects pour limiter et ralentir la remise d’objets aux consommateurs lorsque le consommateur reçoit les objets trop lentement.

MaxWaitOnEvents

Type de données : uint32

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Nombre maximal d’événements d’attente »), unités (« millisecondes »)

Durée pendant laquelle un événement envoyé à un client est mis en file d’attente avant d’être ignoré. Cette propriété interagit avec LowThresholdOnEvents et HighThresholdOnEvents pour limiter(ralentir) la remise d’objets aux consommateurs lorsque le consommateur reçoit les objets trop lentement.

Cette propriété reflète la valeur du Registre.

HKEY_LOCAL_MACHINE\Logiciel\Microsoft\WBEM\    CIMOM| Nombre maximal d’événements d’attente (ms)

MofSelfInstallDirectory

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry| Software\\Microsoft\\WBEM| MOF Self-Install Directory »)

Chemin du répertoire pour les applications qui installent des fichiers MOF dans le référentiel WMI. WMI compile automatiquement tous les fichiers MOF placés dans ce répertoire et, en fonction de sa réussite, déplace le MOF vers un sous-répertoire étiqueté bon ou mauvais. Si la commande # pragma autorecover est incluse, le nom de fichier complet est ajouté à la liste AutorecoverMofs utilisée lorsque WMI initialise ou récupère le référentiel. La liste détermine l’ordre dans lequel les MOF sont compilés.

Cette propriété reflète la valeur dans la clé de Registre.

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

SettingID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (256)

Identificateur par lequel l’objet actuel est connu.

Cette propriété est héritée de CIM_Setting.

Notes

La classe Win32_WMISetting est dérivée de CIM_Setting. Une seule instance de cette classe peut exister sur un ordinateur.

Savoir comment WMI est configuré sur un ordinateur peut être très utile lorsque vous déboguez des scripts ou résolvez des problèmes avec le service WMI lui-même. Par exemple, de nombreux scripts WMI sont écrits en partant du principe que root\cimv2 est l’espace de noms par défaut sur l’ordinateur cible. Par conséquent, les rédacteurs de scripts qui doivent accéder à une classe dans « Root\CIMv2 » ne parviennent souvent pas à inclure l’espace de noms dans le moniker GetObject, comme illustré dans l’exemple de code suivant :

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

Si root\cimv2 n’est pas l’espace de noms par défaut sur l’ordinateur cible, ce script échoue. Pour éviter cela, l’espace de noms root\cimv2 doit être inclus dans le moniker, comme indiqué dans l’exemple de code suivant :

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

Si l’espace de noms par défaut sur l’ordinateur cible est différent de l’espace de noms pris en charge par un script, le script échoue. En plus de cela, l’utilisateur reçoit le message d’erreur quelque peu trompeur « Classe non valide ». En vérité, l’échec n’est pas dû au fait que la classe n’est pas valide, mais parce que la classe est introuvable dans l’espace de noms par défaut. Il s’agit d’un problème difficile à résoudre, car vous êtes susceptible d’examiner les problèmes possibles avec la classe plutôt que les problèmes liés à l’espace de noms qui a été (ou, dans ce cas, n’a pas été spécifié).

Vous pouvez utiliser la classe Win32_WMISetting pour déterminer comment WMI a été configuré sur un ordinateur. Les détails de configuration tels que l’espace de noms par défaut ou le numéro de build WMI peuvent être utiles pour résoudre les problèmes de script. Ces paramètres fournissent également des informations administratives importantes telles que la façon dont, ou même si les erreurs WMI sont enregistrées sur un ordinateur et quels fournisseurs WMI seront automatiquement rechargés si vous devez reconstruire le référentiel WMI.

Exemples

L’exemple de code VBScript Modifier les paramètres WMI sur la galerie TechNet utilise la classe Win32_WMISetting pour configurer l’intervalle de sauvegarde WMI et le niveau de journalisation.

L’exemple de code List the Default Namespace VBScript sur TechNet Gallery utilise la classe Win32_WMISetting pour récupérer et afficher le paramètre WMI « Default namespace for scripting » actuel.

L’exemple de code VBScript Modify the Default WMI Namespace Namespace sur TechNet Gallery utilise la propriété ASPScriptDefaultNamespace pour définir le paramètre WMI « Default namespace for scripting » sur « root\cimv2 ».

L’exemple de code VBSCript Répertorier tous les paramètres WMI utilise un certain nombre de propriétés sur Win32_WMISetting pour renvoyer une liste de paramètres WMI configurés sur un ordinateur.

L’exemple de code JavaScript List WMI Setting Information utilise un certain nombre de propriétés sur Win32_WMISetting pour renvoyer une liste de paramètres WMI configurés sur un ordinateur.

L’exemple de code Python Répertorier les informations sur les paramètres WMI utilise un certain nombre de propriétés sur Win32_WMISetting pour renvoyer une liste de paramètres WMI configurés sur un ordinateur.

L’exemple de code LIST WMI Setting Information Object REXX utilise un certain nombre de propriétés sur Win32_WMISetting pour renvoyer une liste de paramètres WMI configurés sur un ordinateur.

L’exemple de code VBScript suivant montre comment obtenir la version de WMI exécutée sur l’ordinateur local. « Win32_WMISetting=@ » indique le instance unique de la classe . Pour plus d’informations, consultez Versions de WMI.

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

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

WScript.Echo  objWMISetting.BuildVersion

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows Vista
Serveur minimal pris en charge
 Windows Server 2008
Espace de noms
 Racine\CIMV2
MOF
CIMWin32.mof
DLL
Wbemcore.dll

Voir aussi

CIM_Setting

Classes de gestion des services WMI