SWbemObject-Objekt

Sie können die Methoden und Eigenschaften des SWbemObject-Objekts verwenden, um eine WMI-Klassendefinition (Windows Management Instrumentation, Windows-Verwaltungsinstrumentation) oder -Objektinstanz zu repräsentieren. Dieses Objekt kann nicht durch den VBScript-Aufruf CreateObject erstellt werden.

Dieses Objekt unterstützt zwei Typen von Eigenschaften und Methoden. Die in diesem Abschnitt definierten Typen sind generische Eigenschaften und Methoden, die für alle WMI-Objekte gelten. Darüber hinaus macht dieses Objekt die Eigenschaften und Methoden des zugrunde liegenden Objekts als dynamische Automatisierungseigenschaften und -methoden von SWbemObject verfügbar. Die Namen und Typen dieser Eigenschaften und Methoden richten sich nach dem zugrunde liegenden WMI-Objekt. Weitere Informationen dazu, wie diese dynamischen Eigenschaften und Methoden verfügbar gemacht werden, finden Sie unter Bearbeiten von Klassen- und Instanzinformationen.

Aus Sicht des WMI-Clients ist dieses Objekt immer prozessintern. Schreibvorgänge wirken sich nur auf die lokale Kopie des Objekts aus, und Lesevorgänge rufen immer Werte aus der lokalen Kopie ab. Aktualisierungen von WMI werden nur ausgeführt, wenn vollständige Objekte mit einem Aufruf der SWbemObject.Put_-Methode geschrieben werden. Wenn Sie die Eigenschaften oder Methoden in einem SWbemObject-Objekt ändern, werden diese Änderungen erst in WMI geschrieben, wenn Sie SWbemObject.Put_ aufrufen.

Die in diesem Abschnitt definierten generischen Methoden- und Eigenschaftsnamen enden immer mit einem nachfolgenden Unterstrich („_“), um sie von den dynamischen WMI-Methoden und -Eigenschaften des zugrunde liegenden Objekts zu unterscheiden.

Beachten Sie, dass das SWbemObject-Objekt nicht mit der VBScript-Methode GetObject erstellt werden kann. Wenn Sie eine neue, leere Klasse erstellen möchten, verwenden Sie SWbemServices.Get mit einem leeren Parameter für den Pfad. Dieser Aufruf gibt ein leeres SWbemObject-Objekt zurück, das eine Klasse werden kann. Dann können Sie einen Klassennamen für die Class-Eigenschaft des SWbemObjectPath-Objekts angeben, das vom Path_-Aufruf zurückgegeben wird. Fügen Sie der neuen Klasse mit der Properties_-Methode Eigenschaften hinzu. Um eine Instanz zu erstellen, rufen Sie GetObject in der neuen Klasse auf.

Das folgende Codebeispiel zeigt, wie eine neue Klasse abgerufen und ihr eine Eigenschaft hinzugefügt wird. Das SWbemObject-Objekt, das die Klasse repräsentiert, muss mit einem Aufruf von Put_ wieder in das WMI-Repository geschrieben werden.

wbemCimtypeString = 8
Set objSWbemService = GetObject("Winmgmts:root\default")
Set objClass = objSWbemService.Get()
objClass.Path_.Class = "NewClass"

' Add a property
' String property
objClass.Properties_.add "PropertyName", wbemCimtypeString  
' Make the property a key property 
objClass.Properties_("PropertyName").Qualifiers_.add "key", true

' Write the new class to the root\default namespace in the repository
Set objClassPath = objClass.Put_
WScript.Echo objClassPath.Path

'Create an instance of the new class using SWbemObject.SpawnInstance
Set objNewInst = GetObject( _
    "Winmgmts:root\default:NewClass").Spawninstance_

objNewInst.PropertyName = "My Instance"

' Write the instance into the repository
Set objInstancePath = objNewInst.Put_
WScript.Echo objInstancePath.Path

Sie können das Repository mit einem Anzeigetool wie CIM Studio überprüfen, um sich zu vergewissern, dass die neue Klasse und Instanz angezeigt werden. Ein Beispiel zum Entfernen einer Klasse und Instanz aus dem Repository finden Sie unter SWbemServices.Delete oder SWbemObject.Delete_.

Member

Das SWbemObject-Objekt verfügt über die folgenden Membertypen:

• Methoden
• Eigenschaften

Methoden

Das SWbemObject-Objekt verfügt über diese Methoden.

Methode	Beschreibung
Associators_	Ruft die Associator-Elemente des Objekts ab.
AssociatorsAsync_	Ruft die Associator-Elemente des Objekts asynchron ab.
Clone_	Erstellt eine Kopie des aktuellen Objekts.
CompareTo_	Überprüft zwei -Objekte auf Gleichheit.
Delete_	Löscht das Objekt aus WMI.
DeleteAsync_	Löscht das Objekt asynchron aus WMI.
ExecMethod_	Führt eine von einem Methodenanbieter exportierte Methode aus.
ExecMethodAsync_	Führt eine von einem Methodenanbieter exportierte Methode asynchron aus.
GetObjectText_	Ruft die Textdarstellung des Objekts ab (MOF-Syntax).
Instances_	Gibt eine Auflistung von Instanzen des Objekts zurück (bei dem es sich um eine WMI-Klasse handeln muss).
InstancesAsync_	Gibt asynchron eine Auflistung von Instanzen des Objekts zurück (bei dem es sich um eine WMI-Klasse handeln muss).
Put_	Erstellt oder aktualisiert das Objekt in WMI.
PutAsync_	Erstellt oder aktualisiert das Objekt in WMI asynchron.
References_	Gibt Verweise auf das Objekt zurück.
ReferencesAsync_	Gibt asynchron Verweise auf das Objekt zurück.
SpawnDerivedClass_	Erstellt eine neue abgeleitete Klasse aus dem aktuellen Objekt (bei dem es sich um eine WMI-Klasse handeln muss).
SpawnInstance_	Erstellt eine neue Instanz aus dem aktuellen Objekt.
Subclasses_	Gibt eine Auflistung von Unterklassen des Objekts zurück (bei dem es sich um eine WMI-Klasse handeln muss).
SubclassesAsync_	Gibt asynchron eine Auflistung von Unterklassen des Objekts zurück (bei dem es sich um eine WMI-Klasse handeln muss).

Eigenschaften

Das SWbemObject-Objekt verfügt über diese Eigenschaften.

Eigenschaft	Zugriffstyp	Beschreibung
Derivation_	Schreibgeschützt	Enthält ein Array von Zeichenfolgen, das die Ableitungshierarchie für die Klasse beschreibt.
Methods_	Schreibgeschützt	Ein SWbemMethodSet-Objekt, bei dem es sich um die Auflistung von Methoden für dieses Objekt handelt.
Path_	Schreibgeschützt	Enthält ein SWbemObjectPath-Objekt, das den Objektpfad der aktuellen Klasse oder Instanz repräsentiert.
Properties_	Schreibgeschützt	Ein SWbemPropertySet-Objekt, bei dem es sich um die Auflistung von Eigenschaften für dieses Objekt handelt.
Qualifiers_	Schreibgeschützt	Ein SWbemQualifierSet-Objekt, bei dem es sich um die Auflistung von Qualifizierern für dieses Objekt handelt.
Sicherheit_	Schreibgeschützt	Enthält ein SWbemSecurity-Objekt, das zum Lesen oder Ändern der Sicherheitseinstellungen verwendet wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Header	Wbemdisp.h
Typbibliothek	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

Siehe auch

SWbemObjectEx

Skripterstellung für API-Objekte