URI ресурсов

  • Статья

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.

Чувствительность к регистру

Подключаемый модуль WMI сохраняет регистр URI ресурса, полученного в запросе. Однако для обеспечения взаимодействия с другими реализациями протокола WS-Management используйте правильный вариант для запрошенного ресурса в URI ресурса. Правильный вариант — это правописание, определенное поставщиком ресурсов.

В то время как URI ресурсов не требуют учета регистра, xml фрагментов делает. Фрагмент задает только одно свойство, а не весь набор свойств ресурса. В случае с ресурсами WMI синтаксис фрагмента получает одно свойство из экземпляра ресурса. Например, для получения только свойства Version из Win32_OperatingSystem требуется использовать фрагмент . Дополнительные сведения о фрагментах см. в разделе Добавление селектора к объекту ResourceLocator или IWSManResourceLocator статьи Удаленное управление Windows и WMI.

В соответствии со стандартами XML и XPathподключаемый модуль WMI обеспечивает чувствительность к регистру для фрагментов и XML, который определяет входные параметры метода. Учет регистра требуется для поддержки стандарта XPath 1.0/Level 1. Чтобы получить данные WMI с помощью WinRM, учет регистра означает, что имена классов, свойств и методов WMI должны соответствовать регистру имени, найденного в репозитории WMI.

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

Примеры учета регистра

Например, скрипт, который получает свойство SECURITY_DESCRIPTOR из экземпляра класса WMI Win32_Service , не может использовать прописные буквы для имен в пути фрагмента, только URI. Подключаемый модуль WMI WinRM возвращает ошибку для следующего примера 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

Сведения об удаленном управлении Windows

Удаленное управление оборудованием

ResourceLocator