URI ресурсов
ресурса— это идентификатор для отдельного типа операции управления или значения, используемого службами управления, реализующими протокол WS-Management. Значение управления может быть температурой внутри компьютера. Примером операции управления является запуск остановленной службы или установка квоты пользователя тома диска.
Формат URI ресурса
URI состоит из префикса и пути к ресурсу, как показано в следующем примере:
"http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk"
Эта спецификация схемы указывает, что URI основан на версии 1 официального протокола WS-Management и что ресурс является Win32_LogicalDisk в пространстве имен root\cimv2 репозитория WMI. Префиксы URI содержат спецификацию схемы, например "schemas.microsoft.com/wbem/wsman/1/wmi" и определенный тип ресурса, например Win32_LogicalDisk. Дополнительные сведения об определении конкретного экземпляра класса WMI см. в разделе удаленного управления Windows и WMI.
Дополнительные сведения см. в префиксов URI.
Типы URI ресурсов
Хотя инструментарий управления Windows (WMI) является основным источником данных управления для операционных систем под управлением Windows, другие источники схемы управления также существуют.
В следующем списке описаны несколько типов URI ресурсов, используемых удаленным управлением Windows:
URI WMI
Эта группа URI представляет путь к классу Common Information Model, который включает пространство имен и класс.
URI WMI можно использовать в:
- методысеанса
- методыIWSManSession
- методы WSMan.CreateResourceLocator или IWSMan.CreateResourceLocator
- методыResourceLocator илиIWSManResourceLocator
URI IPMI
Эта группа URI представляет стандартные URI отрасли на основе CIM версии 2.9. URI IPMI можно использовать в методахсеансаGet, Put, Перечисление и Invoke.
Примером является https://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor.xsd. Этот ресурс определяется в соответствии с схемой CIM DMTF.org.
URI конфигурации WinRM
Эта группа URI — это операции конфигурации для конфигурациипрослушивателя WinRM.
https://schemas.microsoft.com/wbem/wsman/1/config/listener
можно использовать в методахсеансаGet, Put, Create, Deleteи Перечисление.URI системного журнала событий (SEL)
Эта группа URI подписывается на события сборщика событий из BMC. Вы можете подписаться на эти события с помощью средства командной строки Wevtutil.
Конфиденциальность регистра
Подключаемый модуль WMIсохраняет регистр ресурса URI, полученный в запросе. Однако чтобы обеспечить взаимодействие с другими реализациями протокола WS-Management, используйте правильный вариант для запрошенного ресурса в URI ресурса. Правильный случай — это правописание, определенное поставщиком ресурсов.
Хотя URI ресурсов не требуют конфиденциальности регистра, фрагмент XML. Фрагмент задает только одно свойство, а не весь набор свойств ресурса. В случае ресурсов WMI синтаксис фрагмента получает одно свойство из экземпляра ресурса. Например, получение только свойства версии из Win32_OperatingSystem требует использования фрагмента. Дополнительные сведения о фрагментах см. в статье "Добавление селектора к объекту ResourceLocator или IWSManResourceLocator" в удаленном управлении Windows иWMI.
Следуя стандартам XML и XPath,подключаемый модуль WMIWMI применяет конфиденциальность регистра для фрагментов и XML, определяющих входные параметры для метода. Для поддержки стандарта XPath 1.0/Level 1 требуется конфиденциальность регистра. Чтобы получить данные WMI через WinRM, конфиденциальность регистра означает, что имена классов WMI, свойств и методов должны соответствовать регистру имени, найденного в репозитории WMI.
Дополнительные сведения см. в синтаксисе XPath.
Примеры конфиденциальности регистра
Например, скрипт, получающий свойство SECURITY_DESCRIPTOR из экземпляра класса WMI Win32_Service, не может использовать верхний регистр для имен в пути фрагмента только URI. Подключаемыймодуль WMI winRMWMI возвращает ошибку для следующего примера VBScript, так как XML XPath, предоставленный для FragmentPath, не использует правильный вариант. В репозитории WMI класс называется "Win32_Service".
RResourceUri = "http://schemas.microsoft.com/wbem/wsman/1/"_& "wmi/root/cimv2/Win32_Service?Name=winrm"
Set WSMan = CreateObject("WSMan.Automation")
Set Locator = WSMan.CreateResourceLocator(Resourceuri)
Locator.FragmentPath = "/Win32_SERVICE/Name"
Set Session = WSMan.Createsession
xml = Session.Get(Locator)
WScript.Echo xml
В следующей версии того же примера показан правильный вариант использования для класса Win32_Service и свойства SECURITY_DESCRIPTOR.
ResourceUri = "http://schemas.microsoft.com/wbem/wsman/1/"_
& "wmi/root/cimv2/Win32_Service?Name=winrm"
Set WSMan = CreateObject("WSMan.Automation")
Set Locator = WSMan.CreateResourceLocator(Resourceuri)
Locator.FragmentPath = "/Win32_Service/Name"
Set Session = WSMan.Createsession
xml = Session.Get(Locator)
WScript.Echo xml
Связанные разделы