共用方式為


ResourceLocator 物件

提供資源路徑的物件。 您可以使用ResourceLocator物件,而不是Session物件作業中的資源 URI,例如Session.Get、Session.PutSession.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實例取得NumberOfLogicalProcessorsNumberOfCores屬性。

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