Dela via


WS-Management Protocol

Protokollet WS-Management utvecklades av en grupp maskin- och programvarutillverkare som en offentlig standard för fjärrutbyte av hanteringsdata med alla datorenheter som implementerar protokollet.

Standarder

Mer information om WS-Management protokoll finns i Web Services for Management (WS-Management) Specification.

Avsikten med protokollet är att tillhandahålla konsekvens och samverkan för hanteringsåtgärder över många typer av enheter (inklusive inbyggd programvara) och operativsystem. WS-Management protokoll kan utökas när nya åtgärder identifieras av IT-branschen.

Den aktuella implementeringen av WS-Management-protokollet baseras på följande standardspecifikationer: HTTPS, SOAP över HTTP (WS-I profil), SOAP 1.2, WS-Addressing, WS-Transfer, WS-Enumeration och WS-Eventing. Mer information om WS-Management standarder och XML-scheman finns i https://dmtf.org/standards/wsman

Meddelanden

WS-Management-protokollet innehåller en standard för att konstruera XML--meddelanden med hjälp av olika webbtjänststandarder som WS-Addressing och WS-Transfer. Dessa standarder definierar XML-scheman för webbtjänstmeddelanden. Meddelandena refererar till en resurs med hjälp av en resurs-URI. Protokollet WS-Management lägger till en uppsättning definitioner för hanteringsåtgärder och värden. Till exempel definierar WS-Transfer åtgärderna Get, Put, Create och Delete för en resurs. WS-Management protokoll lägger till Rename, Partial Get och Partial Put.

Meddelandena följer konventionerna i SIMPLE Object Access Protocol (SOAP) som används av alla webbtjänstprotokoll.

I följande kodexempel visas ett meddelande med en Get-åtgärd. Det här exemplet visas som ett hjälpmedel för att förstå hur de underliggande meddelandena ser ut. Du behöver inte veta hur du skapar SOAP-meddelanden. Meddelandena sammanställs av Windows Remote Management när du kör ett kommando med hjälp av kommandoradsverktyget Winrm eller kör ett skript skrivet med WinRM-skript-API:et.

Meddelandet är en begäran om att hämta instansen av Win32_LogicalDisk med en DeviceID- egenskap "c:" från en server med namnet RemoteComputer. Begäran använder HTTP-transporten via port 80. Kontot som skickar begäran måste finnas i den lokala administratörsgruppen på fjärrdatorn.

Tecknen före kolonet i början av varje tagg anger vilken standard som definierar XML-elementet. Till exempel anger <wsa:To> att till-elementet definieras av WS-Addressing standard och <s:Header> anger början av rubrikinnehållet i ett SOAP-meddelande. Tänk på att merparten av meddelandet består av XML-element som definieras av SOAP eller WS-Addressing. WS-Management protokoll lägger till MaxEnvelopeSize, Selector och 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>

Om Windows Remote Management

Hantering av fjärrmaskinvara