Объект 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

Поделиться через