Протокол WS-Management
Протокол WS-Management разрабатывался группой изготовителей оборудования и программного обеспечения в качестве открытого стандарта для удаленного обмена данными управления между любыми компьютерными устройствами, в которых реализован этот протокол.
Стандарты
Дополнительные сведения о протоколе WS-Management см. в статье Спецификация веб-служб для управления (WS-Management).
Протокол предназначен для обеспечения согласованности и взаимодействия для операций управления на многих типах устройств (включая встроенное ПО) и операционных систем. WS-Management протокол можно расширить по мере выявления новых операций в ИТ-отрасли.
Текущая реализация протокола WS-Management основана на следующих стандартных спецификациях: HTTPS, SOAP через HTTP (профиль WS-I), SOAP 1.2, WS-Addressing, WS-Transfer, WS-Enumeration и WS-Eventing. Дополнительные сведения о стандартах WS-Management и схемах XML см. в разделе https://dmtf.org/standards/wsman
Сообщения
Протокол WS-Management предоставляет стандарт для создания XML-сообщений с использованием различных стандартов веб-служб, таких как WS-Addressing и WS-Transfer. Эти стандарты определяют СХЕМЫ XML для сообщений веб-службы. Сообщения ссылаются на ресурс с помощью универсального кода ресурса (URI). Протокол WS-Management добавляет набор определений для операций управления и значений. Например, WS-Transfer определяет операции Get, Put, Create и Delete для ресурса. WS-Management протокол добавляет Rename, Partial Get и Partial Put.
Сообщения следуют соглашениям протокола SOAP, который используется всеми протоколами веб-службы.
В следующем примере кода показано сообщение с операцией Get. Этот пример показан как помощь в понимании того, как выглядят базовые сообщения. Вам не нужно знать, как создавать сообщения SOAP. Сообщения собираются службой удаленного управления Windows при выполнении команды с помощью программы командной строки Winrm или при запуске скрипта, написанного с помощью API сценариев WinRM.
Сообщение представляет собой запрос на получение экземпляра Win32_LogicalDisk со свойством DeviceID "c:" с сервера с именем RemoteComputer. Запрос использует транспорт HTTP через порт 80. Учетная запись, отправляя запрос, должна находиться в группе локальных администраторов на удаленном компьютере.
Символы перед двоеточием в начале каждого тега указывают, какой стандарт определяет XML-элемент. Например, указывает, <wsa:To> что элемент To определен стандартом WS-Addressing и <s:Header> указывает начало содержимого заголовка в сообщении SOAP. Имейте в виду, что большая часть сообщения состоит из XML-элементов, определенных SOAP или WS-Addressing. WS-Management протокол добавляет MaxEnvelopeSize, Selector и SelectorSet.
<s:Envelope xmlns:s="https://www.w3.org/2003/05/soap-envelope"
xmlns:a="https://schemas.xmlsoap.org/ws/2004/08/addressing"
xmlns:w="https://schemas.dmtf.org/wbem/wsman/1/wsman.xsd">
<s:Header>
<a:To>https://RemoteComputer:80/wsman</a:To>
<w:ResourceURI s:mustUnderstand="true">
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_logicaldisk
</w:ResourceURI>
<a:ReplyTo>
<a:Address s:mustUnderstand="true">
https://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous
</a:Address>
</a:ReplyTo>
<a:Action s:mustUnderstand="true">
https://schemas.xmlsoap.org/ws/2004/09/transfer/Get
</a:Action>
<w:MaxEnvelopeSize s:mustUnderstand="true">153600</w:MaxEnvelopeSize>
<a:MessageID>uuid:4ED2993C-4339-4E99-81FC-C2FD3812781A</a:MessageID>
<w:Locale xml:lang="en-US" s:mustUnderstand="false"/>
<w:SelectorSet>
<w:Selector Name="DeviceId">c:</w:Selector>
</w:SelectorSet>
<w:OperationTimeout>PT60.000S</w:OperationTimeout>
</s:Header>
<s:Body/>
</s:Envelope>
Связанные темы