ResourceLocator オブジェクト
リソースへのパスを提供する オブジェクト。 Session.Get、Session.Put、Session.Enumerate などの Session オブジェクト操作では、リソース URI の代わりに ResourceLocator オブジェクトを使用できます。
このオブジェクトを使用すると、次のことが可能になります。
- リソースの特定 のインスタンスを 識別するセレクターを 1 つ以上追加します。 これは、キーを使用するリソースのリソース URI にキー値を指定するのと同じです。 詳細については、「 ResourceLocator.AddSelector」を参照してください。 Session.Enumerate の呼び出しで filter パラメーターを使用して、同様の操作を実行できます。
- フラグメント パスと言語を指定して、リソースのプロパティを 1 つだけ取得します。 配列インデックスを指定して、配列プロパティの 1 つまたはすべての要素を指定することもできます。 詳細については、「 ResourceLocator.FragmentPath」を参照してください。
- データ ソースが要求を処理するために必要な オプション を 1 つ以上追加します。 詳細については、「 ResourceLocator.AddOption」を参照してください。
詳細については、「 リソースの特定のインスタンスのクエリ」を参照してください。
メンバー
ResourceLocator オブジェクトには、次の種類のメンバーがあります。
メソッド
ResourceLocator オブジェクトには、これらのメソッドがあります。
| メソッド | 説明 |
|---|---|
| AddOption | 要求を処理するために必要な追加データを追加します。 |
| AddSelector |
ResourceLocator オブジェクトにセレクターを追加します。 |
| ClearOptions |
ResourceLocator オブジェクトからオプションを削除します。 |
| ClearSelectors |
ResourceLocator オブジェクトからすべてのセレクターを削除します。 |
プロパティ
ResourceLocator オブジェクトには、これらのプロパティがあります。
| プロパティ | アクセスの種類 | 説明 |
|---|---|---|
|
FragmentDialect |
読み取り/書き込み |
リソースフラグメントの言語言語言語を取得または設定します。 |
|
FragmentPath |
読み取り/書き込み |
リソースフラグメントまたはプロパティのパスを取得または設定します。 |
|
MustUnderstandOptions |
読み取り/書き込み |
ResourceLocator オブジェクトの MustUnderstandOptions 値を取得または設定します。 |
|
ResourceURI |
読み取り/書き込み |
ResourceLocator オブジェクトのリソース URI を取得または設定します。 |
解説
ResourceLocator オブジェクトは、IWSManResourceLocator インターフェイスに対応します。
例
次の VBScript コード例では、Win32_Processorの特定のインスタンスから NumberOfLogicalProcessors プロパティと NumberOfCores プロパティを取得します。
Option Explicit
Dim strUri
strUri = "http://schemas.microsoft.com/wbem/wsman/1/" _
& "wmi/root/cimv2/Win32_Processor"
Const FragmentDialect = _
"https://www.w3.org/TR/1999/REC-xpath-19991116"
Dim WSMan
Set WSMan = CreateObject("WSMan.Automation")
Dim Session
Set Session = WSMan.CreateSession
Dim Locator
Set Locator = WSMan.CreateResourceLocator(strUri)
Locator.AddSelector "DeviceID", "CPU0"
Dim NumberOfCores_XML
Locator.FragmentPath = "NumberOfCores"
Locator.FragmentDialect = FragmentDialect
NumberOfCores_XML = Session.Get(Locator)
DisplayOutput NumberOfCores_XML
Dim NumberOfLogicalProcessors_XML
Locator.FragmentPath = "NumberOfLogicalProcessors"
Locator.FragmentDialect = FragmentDialect
NumberOfLogicalProcessors_XML = Session.Get(Locator)
DisplayOutput NumberOfLogicalProcessors_XML
'****************************************************
' Displays WinRM XML message using built-in XSL
'****************************************************
Sub DisplayOutput( strWinRMXml )
Dim xmlFile, xslFile
Set xmlFile = CreateObject( "MSXml2.DOMDocument.3.0" )
Set xslFile = CreateObject( "MSXml2.DOMDocument.3.0" )
xmlFile.LoadXml( strWinRMXml )
xslFile.Load( "WsmTxt.xsl" )
Wscript.Echo xmlFile.TransformNode( xslFile )
End Sub
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| ヘッダー |
|
| IDL |
|
| ライブラリ |
|
| [DLL] |
|