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
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 |
|
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID_SWbemObject |
| IID |
IID_ISWbemObject |