Объект ResourceLocator

Объект, предоставляющий путь к ресурсу. Вы можете использовать объект ResourceLocator вместо URI ресурса в операциях с объектами сеанса , таких как Session. Get, Session.WHERE или Session. Enumerate.

Этот объект позволяет выполнять следующие задачи:

  • Добавьте один или несколько селекторов , которые указывают конкретный экземпляр ресурса. Это то же самое, что и указание значения ключа в универсальном коде ресурса (URI) ресурса, использующего ключи. Дополнительные сведения см. в разделе ResourceLocator. аддселектор. Аналогичную операцию можно выполнить с помощью параметра Filter в вызове Session. Enumerate.
  • Укажите путь фрагмента и диалект, чтобы получить только одно свойство ресурса. Можно также указать один или все элементы свойства массива, указав индекс массива. Дополнительные сведения см. в разделе ResourceLocator. фрагментпас.
  • Добавьте один или несколько параметров , которые могут потребоваться источнику данных для обработки запроса. Дополнительные сведения см. в разделе ResourceLocator. аддоптион.

Дополнительные сведения см. в разделе запрос конкретных экземпляров ресурса.

Элементы

Объект ResourceLocator имеет следующие типы членов:

Методы

Объект ResourceLocator содержит эти методы.

Метод Описание
аддоптион Добавляет дополнительные данные, необходимые для обработки запроса.
аддселектор Добавляет селектор в объект ResourceLocator .
клеароптионс Удаляет все Параметры из объекта ResourceLocator .
клеарселекторс Удаляет все селекторы из объекта ResourceLocator .

Свойства

Объект ResourceLocator имеет следующие свойства.

Свойство Тип доступа Описание
фрагментдиалект
Чтение/запись
Возвращает или задает диалект языка для фрагмента ресурса .
фрагментпас
Чтение/запись
Возвращает или задает путь к фрагменту или свойству ресурса .
мустундерстандоптионс
Чтение/запись
Возвращает или задает значение мустундерстандоптионс для объекта ResourceLocator .
ResourceURI
Чтение/запись
Возвращает или задает URI ресурса в объекте ResourceLocator .

Remarks

Объект ResourceLocator соответствует интерфейсу ивсманресаурцелокатор .

Примеры

Следующий пример кода VBScript получает свойства нумберофлогикалпроцессорс и нумберофкорес из определенного экземпляра _ процессора Win32.

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

Requirements (Требования)

Требование Значение
Минимальная версия клиента
Windows Vista
Минимальная версия сервера
Windows Server 2008
Заголовок
Всмандисп. h
IDL
Всмандисп. idl
Библиотека
Всмандисп. tlb
DLL
WSMAuto.dll

См. также

API сценариев WinRM