SWbemPropertySet-Objekt

Artikel
07/03/2023

Ein SWbemPropertySet-Objekt ist eine Sammlung von SWbemProperty-Objekten. Sie können der Sammlung mithilfe der Add-Methode Elemente hinzufügen, mithilfe der Item-Methode Elemente aus der Sammlung abrufen und mithilfe der Remove-Methode Elemente aus der Sammlung entfernen. Weitere Informationen finden Sie unter Zugreifen auf eine Sammlung. Dieses Objekt kann nicht durch den VBScript-Aufruf CreateObject erstellt werden.

Anhand der SWbemProperty-Objekte, aus denen sich eine SWbemPropertySet-Sammlung zusammensetzt, werden die Eigenschaften einer einzelnen WMI-Klasse oder -Instanz beschrieben.

Member

Das SWbemPropertySet-Objekt weist die folgenden Typen von Membern auf:

Methoden
Eigenschaften

Methoden

Das SWbemPropertySet-Objekt verfügt über die folgenden Methoden.

Methode	BESCHREIBUNG
Hinzufügen	Fügt der SWbemPropertySet-Sammlung ein SWbemProperty-Objekt hinzu.
Element	Ruft ein benanntes SWbemProperty-Objekt aus der Sammlung ab. Dies ist die Standardmethode für dieses Objekt.
Remove	Löscht ein SWbemProperty-Objekt aus der Sammlung.

Eigenschaften

Das SWbemPropertySet-Objekt verfügt über die folgenden Eigenschaften.

Eigenschaft	Zugriffstyp	BESCHREIBUNG
Count	Schreibgeschützt	Die Anzahl der Elemente in der SWbemPropertySet-Sammlung.

Beispiele

Im folgenden VBScript-Beispiel wird gezeigt, wie wbemErrResetToDefault von SWbemPropertySet.Remove zurückgeben werden kann, wenn die Eigenschaft überschrieben wird.

on error resume next 

'Create a keyed class with a defaulted property
set service = GetObject("Winmgmts:")
set emptyclass = service.Get
emptyclass.path_.class = "REMOVETEST00"
set prop = emptyclass.properties_.add ("p", 19)

prop.qualifiers_.add "key", true
emptyclass.properties_.add ("q", 19).Value = 12

emptyclass.put_

'create an instance and override the property
set instance = service.get ("RemoveTest00").spawninstance_

instance.properties_("q").Value = 24
instance.properties_("p").Value = 1
instance.put_

'retrieve the instance and remove the property
set instance = service.get ("removetest00=1")
set property = instance.properties_ ("q")

WScript.echo "Overridden value of property is [24]:", property.value
WScript.echo ""

instance.properties_.remove "q"
set property = instance.properties_ ("q")
WScript.echo "Value of property after removal is [12]:", property.value
WScript.echo ""

if err <> 0 then
 WScript.Echo "0x" & Hex(Err.Number), Err.Description, Err.Source
end if

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_SWbemPropertySet
IID	IID_ISWbemPropertySet

Weitere Informationen

Objekte für die Skripterstellungs-API

Freigeben über