ResourceLocator 物件

提供資源路徑的物件。 您可以使用ResourceLocator物件，而不是Session物件作業中的資源 URI，例如Session.Get、Session.Put或Session.Enumerate。

此物件可讓您：

• 新增一或多個 選取器 ，以識別資源的特定實例。 這與為使用金鑰的資源提供資源 URI 中的金鑰值相同。 如需詳細資訊，請參閱 ResourceLocator.AddSelector。 您可以在對Session.Enumerate的呼叫中使用filter參數來執行類似的作業。
• 指定 片段 路徑和方言，以只取得資源的一個屬性。 您也可以藉由提供陣列索引來指定陣列屬性的一或所有元素。 如需詳細資訊，請參閱 ResourceLocator.FragmentPath。
• 新增資料來源可能需要處理要求的一或多個 選項 。 如需詳細資訊，請參閱 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
標頭	WSManDisp.h
Idl	WSManDisp.idl
程式庫	WSManDisp.tlb
DLL	WSMAuto.dll

另請參閱

WinRM 腳本 API