classe Win32_WMISetting
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 |
|
| DLL |
|
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour