Freigeben über


WS-Verwaltungsprotokoll

Das WS-Verwaltungsprotokoll wurde von einer Gruppe von Hardware- und Softwareherstellern als öffentlicher Standard für den Remoteaustausch von Verwaltungsdaten mit beliebigen Geräten entwickelt, die das Protokoll implementieren.

Standards

Weitere Informationen zu WS-Management Protokoll finden Sie unter Web Services for Management (WS-Management) Specification.

Die Absicht des Protokolls besteht darin, Konsistenz und Interoperabilität für Verwaltungsvorgänge auf vielen Arten von Geräten (einschließlich Firmware) und Betriebssystemen zu gewährleisten. WS-Management Protokoll kann erweitert werden, wenn neue Vorgänge von der IT-Branche identifiziert werden.

Die aktuelle Implementierung des WS-Management-Protokolls basiert auf den folgenden Standardspezifikationen: HTTPS, SOAP over HTTP (WS-I-Profil), SOAP 1.2, WS-Addressing, WS-Transfer, WS-Enumeration und WS-Eventing. Weitere Informationen zu den WS-Management Standards und XML-Schemas finden Sie unter https://dmtf.org/standards/wsman

Nachrichten

Das WS-Management-Protokoll bietet einen Standard zum Erstellen von XML-Nachrichten unter Verwendung verschiedener Webdienststandards wie WS-Addressing und WS-Transfer. Diese Standards definieren XML-Schemas für Webdienstnachrichten. Die Nachrichten verweisen auf eine Ressource , die einen Ressourcen-URI verwendet. Das WS-Management-Protokoll fügt eine Reihe von Definitionen für Verwaltungsvorgänge und -werte hinzu. Beispielsweise definiert WS-Transfer die Vorgänge Get, Put, Create und Delete für eine Ressource. WS-Management Protokoll fügt Rename, Partial Get und Partial Put hinzu.

Die Meldungen folgen den Konventionen des Simple Object Access Protocol (SOAP), das von allen Webdienstprotokollen verwendet wird.

Das folgende Codebeispiel zeigt eine Nachricht mit einem Get-Vorgang. Dieses Beispiel wird als Hilfe gezeigt, um zu verstehen, wie die zugrunde liegenden Nachrichten aussehen. Sie müssen nicht wissen, wie SOAP-Nachrichten erzeugt werden. Die Nachrichten werden von der Windows-Remoteverwaltung zusammengestellt, wenn Sie einen Befehl mit dem Winrm-Befehlszeilentool ausführen oder ein Skript ausführen, das mit der WinRM-Skript-API geschrieben wurde.

Die Nachricht ist eine Anforderung zum Abrufen der instance von Win32_LogicalDisk mit der DeviceID-Eigenschaft "c:" von einem Server mit dem Namen RemoteComputer. Die Anforderung verwendet den HTTP-Transport über Port 80. Das Konto, das die Anforderung sendet, muss sich in der lokalen Administratorgruppe auf dem Remotecomputer befinden.

Die Zeichen vor dem Doppelpunkt am Anfang jedes Tags geben an, welcher Standard das XML-Element definiert. Gibt beispielsweise an, <wsa:To> dass das To-Element durch den WS-Addressing-Standard definiert ist und <s:Header> den Anfang des Headerinhalts in einer SOAP-Nachricht angibt. Beachten Sie, dass der Großteil der Nachricht aus XML-Elementen besteht, die durch SOAP oder WS-Addressing definiert sind. WS-Management Protokoll werden MaxEnvelopeSize, Selector und SelectorSet hinzugefügt.

<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>

Informationen zur Windows-Remoteverwaltung

Remotehardwareverwaltung