ResourceLocator 对象

提供资源路径的 对象。 可以在 Session 对象操作（如 Session.Get、Session.Put 或 Session.Enumerate）中使用 ResourceLocator 对象而不是资源 URI。

此对象使你能够：

• 添加一个或多个用于标识资源的特定实例 的选择器 。 这与在使用密钥的资源的资源 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