Freigeben über


Win32_WMISetting-Klasse

Die Win32_WMISettingSingleton-WMI-Klasse enthält die Betriebsparameter für den WMI-Dienst. Diese Klasse kann nur eine instance haben, die immer für jedes Windows-System vorhanden ist und nicht gelöscht werden kann. Zusätzliche Instanzen können nicht erstellt werden.

Die folgende Syntax wird durch MOF-Code (Managed Object Format) vereinfacht und schließt alle geerbten Eigenschaften ein. Eigenschaften und Methoden befinden sich in alphabetischer Reihenfolge, nicht in MOF-Reihenfolge.

Syntax

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

Member

Die Win32_WMISetting-Klasse verfügt über die folgenden Membertypen:

Eigenschaften

Die Win32_WMISetting-Klasse verfügt über diese Eigenschaften.

ASPScriptDefaultNamespace

Datentyp: Zeichenfolge

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\Scripting| Standardnamespace")

Standardskriptnamespace. Diese Eigenschaft enthält den Namespace, der von Aufrufen der Skript-API für WMI verwendet wird, wenn vom Aufrufer keiner angegeben wird.

Diese Eigenschaft spiegelt den Wert im Registrierungsschlüssel wider.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM\    Skripterstellung| Standardnamespace

Beispiel: root\cimv2

Ein Beispielskript, das diese Eigenschaft verwendet, finden Sie im Abschnitt Hinweise.

ASPScriptEnabled

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\Scripting| Aktivieren für ASP")

Wenn True, kann WMI-Skripterstellung auf Active Server Pages (ASP) verwendet werden. Diese Eigenschaft gilt nur für Systeme, auf denen nicht unterstützte Versionen von Windows ausgeführt werden. Für unterstützte Windows-Systeme ist WMI-Skripterstellung in ASP immer zulässig.

AutorecoverMofs

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Autorecover-MOFs")

Liste der vollqualifizierten MOF-Dateinamen, die zum Initialisieren oder Wiederherstellen des WMI-Repositorys verwendet werden. Die Liste bestimmt die Reihenfolge, in der MOF-Dateien kompiliert werden.

Diese Eigenschaft spiegelt den Wert im Registrierungsschlüssel wider.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM\    CIMOM| Autocover-MOFs

AutoStartWin9X

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

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

Wird nicht unterstützt.

Nicht starten (0)

Autostart (1)

Start beim Neustart (2)

BackupInterval

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Schwellenwert für Sicherungsintervalle), Einheiten ("Minuten")

Wird nicht unterstützt. Sichern Sie stattdessen das WMI-Repository manuell.

BackupLastTime

Datentyp: datetime

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: MappingStrings ("Win32API| Zeitfunktionen| GetTimeZoneInformation")

Datum und Uhrzeit der letzten Sicherung.

BuildVersion

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM| Build")

Versionsinformationen für den aktuell installierten WMI-Dienst.

Dauer, die zwischen sicherungen der WMI-Datenbank verstrichen ist.

Diese Eigenschaft spiegelt den Wert im Registrierungsschlüssel wider.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| Bauen

Caption

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64)

Kurze Textbeschreibung des aktuellen Objekts.

Diese Eigenschaft wird von CIM_Setting geerbt.

DatabaseDirectory

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Repositoryverzeichnis")

Verzeichnispfad, der das WMI-Repository enthält.

DatabaseMaxSize

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Maximale DB-Größe"), Einheiten ("Kilobyte")

Maximale Größe des WMI-Repositorys.

Beschreibung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Textbeschreibung des aktuellen Objekts.

Diese Eigenschaft wird von CIM_Setting geerbt.

EnableAnonWin9xConnections

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

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

Wird nicht unterstützt.

Enableevents

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

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

Bei True sollte das WMI-Ereignissubsystem aktiviert sein.

Diese Eigenschaft spiegelt den Wert im Registrierungsschlüssel wider.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| Enableevents

EnableStartupHeapPreallocation

Datentyp: Boolesch

Zugriffstyp: Lese-/Schreibzugriff

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

Wenn True, erstellt WMI einen vorab zugeordneten Heap mit der Größe des LastStartupHeapPreallocation-Werts , wenn WMI initialisiert wird.

HighThresholdOnClientObjects

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Hoher Schwellenwert für Clientobjekte), Einheiten ("Objekte pro Sekunde")

Maximale Rate, mit der vom Anbieter erstellte Objekte an Clients übermittelt werden können. Um Geschwindigkeitsunterschiede zwischen Anbietern und Clients zu berücksichtigen, hält WMI Objekte in Warteschlangen ab, bevor sie sie an Consumer übermitteln. Um mehr Effizienz zu erzielen, müssen Verbraucher die Objekte in einem Tempo sammeln, das dem Anbieter entspricht. Wenn der Von nicht erfassten Objekten gehaltene Arbeitsspeicher LowThresholdOnObjects erreicht, verlangsamt WMI das Hinzufügen neuer Objekte in die Warteschlange. Wenn sich nicht erfasste Ereignisse weiterhin akkumulieren und die maximale Wartezeit für die Übermittlung von Ereignissen in MaxWaitOnClientObjects erreicht wird, während der verwendete Arbeitsspeicher auf dem Wert in HighThresholdOnClientObjects liegt, akzeptiert WMI keine weiteren Objekte von Anbietern und gibt WBEM_E_OUT_OF_MEMORY an die Clients zurück.

HighThresholdOnEvents

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Hoher Schwellenwert für Ereignisse"), Einheiten ("Ereignisse pro Sekunde")

Maximale Rate, mit der Ereignisse an Clients übermittelt werden sollen. Um Geschwindigkeitsunterschiede zwischen Anbietern und Clients zu berücksichtigen, stellt WMI Ereignisse vor der Übermittlung an Verbraucher in die Warteschlange. Um mehr Effizienz zu erzielen, müssen Verbraucher die Ereignisse in einem Tempo erfassen, das dem Anbieter entspricht. Wenn der Speicher, der von nicht erfassten Ereignissen gehalten wird , LowThresholdOnObjects erreicht, verlangsamt WMI das Hinzufügen neuer Ereignisse in die Warteschlange. Wenn nicht erfasste Ereignisse weiterhin akkumuliert werden und die maximale Wartezeit auf die Übermittlung von Ereignissen in MaxWaitOnEvents erreicht wird, während der verwendete Arbeitsspeicher auf dem Wert in HighThresholdOnEvents liegt, akzeptiert WMI keine weiteren Ereignisse von Anbietern und gibt WBEM_E_OUT_OF_MEMORY an die Clients zurück.

Hinweis

Die Einschränkung wird nur für Permanent Event-Consumer durchgeführt, sodass temporäre Consumer keine Drosselung erwarten sollten, wenn Ereignisse in der internen WMI-Ereigniswarteschlange gesichert werden.

 

Diese Eigenschaft spiegelt den Wert im Registrierungsschlüssel wider.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM\    CIMOM| Hoher Schwellenwert für Clientobjekte (B)

InstallationDirectory

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM| Installationsverzeichnis")

Verzeichnispfad, in dem die WMI-Software installiert wurde. Der Standardspeicherort ist \System32\Wbem.

Diese Eigenschaft spiegelt den Wert im Registrierungsschlüssel wider.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| Installationsverzeichnis

LastStartupHeapPreallocation

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| LastStartupHeapPreallocation"), Einheiten ("Bytes")

Größe des vorab zugewiesenen Heaps, der während der Initialisierung von WMI erstellt wurde.

Diese Eigenschaft spiegelt den Wert im Registrierungsschlüssel wider.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| LastStartupHeapPreallocation

LoggingDirectory

Datentyp: Zeichenfolge

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Protokollierungsverzeichnis")

Verzeichnispfad, der den Speicherort der WMI-Systemprotokolldateien enthält.

Diese Eigenschaft spiegelt den Wert im Registrierungsschlüssel wider.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| Protokollierungsverzeichnis

LoggingLevel

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Protokollierung)

Aktivieren der Ereignisprotokollierung und der ausführlichen Protokollierungsebene.

Diese Eigenschaft spiegelt den Wert im Registrierungsschlüssel wider.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| Protokollierung

Aus (0)

Fehlerprotokollierung (1)

Ausführliche Fehlerprotokollierung (2)

LowThresholdOnClientObjects

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Niedriger Schwellenwert für Clientobjekte"), Einheiten ("Objekte pro Sekunde")

Rate, mit der WMI beginnt, die Erstellung neuer Objekte zu verlangsamen, die für Clients erstellt wurden. Um Geschwindigkeitsunterschiede zwischen Anbietern und Clients zu berücksichtigen, hält WMI Objekte in Warteschlangen ab, bevor sie sie an Consumer übermitteln. Um mehr Effizienz zu erzielen, müssen Verbraucher die Objekte in einem Tempo sammeln, das dem Anbieter entspricht. Wenn die Rate der Anforderungen für Objekte LowThresholdOnClientObjects erreicht, verlangsamt WMI schrittweise die Erstellung neuer Objekte, um der Nutzungsrate des Clients zu entsprechen. Diese Verlangsamung beginnt, wenn die Rate, mit der Objekte erstellt werden, den Wert dieser Eigenschaft überschreitet. Siehe HighThresholdOnClientObjects.

Diese Eigenschaft spiegelt den Registrierungswert wider.

\ KEY_LOCAL_MACHINE Software\Microsoft\WBEM\    CIMOM| Hoher Schwellenwert für Clientobjekte (B)

LowThresholdOnEvents

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Niedrigschwellige Ereignisse"), Einheiten ("Ereignisse pro Sekunde")

Rate, mit der WMI beginnt, die Übermittlung neuer Ereignisse zu verlangsamen. Um Geschwindigkeitsunterschiede zwischen Anbietern und Clients zu berücksichtigen, stellt WMI Ereignisse vor der Übermittlung an Verbraucher in die Warteschlange. Um mehr Effizienz zu erzielen, müssen Verbraucher die Objekte in einem Tempo sammeln, das dem Anbieter entspricht. Wenn die Warteschlange außer Kontrolle gerät, drosselt WMI die Übermittlung von Ereignissen nach und nach, um sich an der Clientrate zu orientieren. Diese Verlangsamung beginnt, wenn die Rate, mit der Ereignisse generiert werden, den Wert dieser Eigenschaft überschreitet. Siehe HighThresholdOnEvents.

Hinweis

Die Drosselung wird nur für permanente Ereignisverbraucher durchgeführt, sodass temporäre Consumer keine Drosselung erwarten sollten, wenn Ereignisse in der internen WMI-Ereigniswarteschlange gesichert werden.

 

Diese Eigenschaft spiegelt den Registrierungswert wider.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM\    CIMOM| Hoher Schwellenwert für Clientobjekte {B}

MaxLogFileSize

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Maximale Protokolldateigröße"), Einheiten ("Bytes")

Maximale Größe der vom WMI-Dienst erzeugten Protokolldateien.

Diese Eigenschaft spiegelt den Wert im Registrierungsschlüssel wider.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| Maximale Größe der Protokolldatei

MaxWaitOnClientObjects

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Maximale Wartezeit bei Ereignissen), Einheiten ("Millisekunden")

Die Zeitspanne, die ein neu erstelltes Objekt darauf wartet, vom Client verwendet zu werden, bevor es verworfen und ein Fehlerwert zurückgegeben wird. Diese Eigenschaft interagiert mit den Eigenschaften LowThresholdOnClientObjects und HighThresholdOnClientObjects , um die Übermittlung von Objekten an Consumer zu verlangsamen, wenn der Consumer die Objekte zu langsam empfängt.

MaxWaitOnEvents

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: MappingStrings ("Win32Registry| Software\\Microsoft\\WBEM\\CIMOM| Max Wait On Events"), Units ("Millisekunden")

Zeitraum, für den ein an einen Client gesendetes Ereignis in die Warteschlange gestellt wird, bevor er verworfen wird. Diese Eigenschaft interagiert0 mit LowThresholdOnEvents und HighThresholdOnEvents , um die Übermittlung von Objekten an Consumer zu verlangsamen, wenn der Consumer die Objekte zu langsam empfängt.

Diese Eigenschaft gibt den Registrierungswert wieder.

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

MofSelfInstallDirectory

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Verzeichnispfad für Anwendungen, die MOF-Dateien im WMI-Repository installieren. WMI kompiliert automatisch alle MOF-Dateien, die in diesem Verzeichnis abgelegt werden, und verschiebt die MOF je nach Erfolg in ein Unterverzeichnis mit der Bezeichnung "gut" oder "schlecht". Wenn der Befehl # pragma autorecover enthalten ist, wird der vollqualifizierte Dateiname der AutorecoverMofs-Liste hinzugefügt, die beim Initialisieren oder Wiederherstellen des Repositorys von WMI verwendet wird. Die Liste bestimmt die Reihenfolge, in der MOFs kompiliert werden.

Diese Eigenschaft gibt den Wert im Registrierungsschlüssel an.

HKEY_LOCAL_MACHINE\Software\Microsoft\WBEM| CIMOM| MOF Self=Installationsverzeichnis

SettingID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (256)

Bezeichner, unter dem das aktuelle Objekt bekannt ist.

Diese Eigenschaft wird von CIM_Setting geerbt.

Bemerkungen

Die Win32_WMISetting-Klasse wird von CIM_Setting abgeleitet. Nur eine instance dieser Klasse kann auf einem Computer vorhanden sein.

Wenn Sie wissen, wie WMI auf einem Computer konfiguriert ist, kann sehr nützlich sein, wenn Sie Skripts debuggen oder Probleme mit dem WMI-Dienst selbst beheben. Beispielsweise werden viele WMI-Skripts unter der Annahme geschrieben, dass root\cimv2 der Standardnamespace auf dem Zielcomputer ist. Daher können Skriptautoren, die auf eine Klasse in "Root\CIMv2" zugreifen müssen, häufig nicht den Namespace in den GetObject-Moniker einschließen, wie im folgenden Codebeispiel gezeigt:

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

Wenn root\cimv2 nicht der Standardnamespace auf dem Zielcomputer ist, schlägt dieses Skript fehl. Um dies zu verhindern, muss der Namespace root\cimv2 im Moniker enthalten sein, wie im folgenden Codebeispiel gezeigt:

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

Wenn sich der Standardnamespace auf dem Zielcomputer von dem von einem Skript angenommenen Namespace unterscheidet, schlägt das Skript fehl. Darüber hinaus wird dem Benutzer die etwas irreführende Fehlermeldung "Ungültige Klasse" angezeigt. Tatsächlich liegt der Fehler nicht daran, dass die Klasse ungültig ist, sondern weil die Klasse nicht im Standardnamespace gefunden werden kann. Dies ist ein schwieriges Problem, da Sie wahrscheinlich mögliche Probleme mit der -Klasse untersuchen und nicht probleme mit dem Namespace, der angegeben wurde (oder in diesem Fall nicht angegeben wurde).

Sie können die klasse Win32_WMISetting verwenden, um zu bestimmen, wie WMI auf einem Computer konfiguriert wurde. Konfigurationsdetails wie der Standardnamespace oder die WMI-Buildnummer können bei der Behandlung von Skriptproblemen hilfreich sein. Diese Einstellungen bieten auch wichtige administrative Informationen, z. B. wie oder sogar ob WMI-Fehler auf einem Computer protokolliert werden und welche WMI-Anbieter automatisch neu geladen werden, wenn Sie das WMI-Repository neu erstellen müssen.

Beispiele

Im VBScript-Codebeispiel WMI-Einstellungen ändern im TechNet-Katalog wird die klasse Win32_WMISetting verwendet, um das WMI-Sicherungsintervall und den Protokollierungsgrad zu konfigurieren.

Im Codebeispiel Auflisten des VBScript-Standardnamespaces im TechNet-Katalog wird die Win32_WMISetting-Klasse verwendet, um die aktuelle WMI-Einstellung "Standardnamespace für Skripterstellung" abzurufen und anzuzeigen.

Das VBScript-Codebeispiel Ändern des Standard-WMI-Namespaces im TechNet-Katalog verwendet die ASPScriptDefaultNamespace-Eigenschaft , um die WMI-Einstellung "Standardnamespace für Skripterstellung" auf "root\cimv2" festzulegen.

Im Codebeispiel Auflisten aller WMI-Einstellungen VBSCript wird eine Reihe von Eigenschaften für Win32_WMISetting verwendet, um eine Liste der auf einem Computer konfigurierten WMI-Einstellungen zurückzugeben.

Im JavaScript-Codebeispiel WMI-Einstellungsinformationen auflisten wird eine Reihe von Eigenschaften für Win32_WMISetting verwendet, um eine Liste der auf einem Computer konfigurierten WMI-Einstellungen zurückzugeben.

Im Python-Codebeispiel WMI-Einstellungsinformationen auflisten wird eine Reihe von Eigenschaften für Win32_WMISetting verwendet, um eine Liste der auf einem Computer konfigurierten WMI-Einstellungen zurückzugeben.

Im CODEbeispiel List WMI Setting Information Object REXX wird eine Reihe von Eigenschaften für Win32_WMISetting verwendet, um eine Liste der auf einem Computer konfigurierten WMI-Einstellungen zurückzugeben.

Das folgende VBScript-Codebeispiel zeigt, wie Sie die Version von WMI abrufen, die auf dem lokalen Computer ausgeführt wird. "Win32_WMISetting=@" gibt den einzelnen instance der Klasse an. Weitere Informationen finden Sie unter WMI-Versionen.

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

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

WScript.Echo  objWMISetting.BuildVersion

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
WindowsServer 2008
Namespace
Root\CIMV2
MOF
CIMWin32.mof
DLL
Wbemcore.dll

Siehe auch

CIM_Setting

WMI-Dienstverwaltungsklassen