SWbemPropertySet オブジェクト

SWbemPropertySet オブジェクトは、SWbemProperty オブジェクトのコレクションです。 Add メソッドを使用した項目のコレクションへの追加、Item メソッドを使用したコレクションからの項目の取得、Remove メソッドを使用したコレクションからの項目の削除を実行できます。 詳細については、コレクションへのアクセスに関する記事を参照してください。 このオブジェクトは、VBScript の CreateObject 呼び出しでは作成できません。

SWbemPropertySet コレクションを構成する SWbemProperty オブジェクトは、単一の WMI クラスまたはインスタンスのプロパティを記述するために使用されます。

メンバー

SWbemPropertySet オブジェクトには、次の種類のメンバーがあります。

• メソッド
• プロパティ

メソッド

SWbemPropertySet オブジェクトには、次のメソッドがあります。

メソッド	説明
追加	SWbemProperty オブジェクトを SWbemPropertySet コレクションに追加します。
Item	コレクションから名前付き SWbemProperty を取得します。 これは、このオブジェクトの既定のメソッドです。
[削除]	コレクションから SWbemProperty オブジェクトを削除します。

プロパティ

SWbemPropertySet オブジェクトには、次のプロパティがあります。

プロパティ	アクセスの種類	説明
Count	読み取り専用	SWbemPropertySet コレクション内の項目の数。

例

次の VBScript サンプルは、プロパティがオーバーライドされた場合に SWbemPropertySet.Remove が wbemErrResetToDefault を返す可能性があるしくみを示しています。

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
Header	Wbemdisp.h
タイプ ライブラリ	Wbemdisp.tlb
[DLL]	Wbemdisp.dll
CLSID	CLSID_SWbemPropertySet
IID	IID_ISWbemPropertySet

関連項目

スクリプト API オブジェクト