Объект ResourceLocator

Статья
06/13/2023

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

Этот объект позволяет:

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

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

Элементы

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

Методы
Свойства

Методы

Объект ResourceLocator содержит следующие методы.

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

Свойства

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

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

Примеры

Следующий пример кода VBScript получает свойства NumberOfLogicalProcessors и NumberOfCores из определенного экземпляра Win32_Processor.

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

См. также раздел

API скриптов WinRM