Partager via


Protocole Gestion des services web

Le protocole Gestion des services Web a été développé par un groupe de fabricants de logiciels et de matériel afin de permettre l’échange à distance de données de gestion avec un appareil qui implémente ce protocole.

Standards

Pour plus d’informations sur WS-Management protocole, consultez Spécification des services web pour la gestion (WS-Management).

L’objectif du protocole est de fournir une cohérence et une interopérabilité pour les opérations de gestion sur de nombreux types d’appareils (y compris le microprogramme) et les systèmes d’exploitation. WS-Management protocole peut être étendu à mesure que de nouvelles opérations sont identifiées par le secteur informatique.

L’implémentation actuelle du protocole WS-Management est basée sur les spécifications standard suivantes : HTTPS, SOAP sur HTTP (profil WS-I), SOAP 1.2, WS-Addressing, WS-Transfer, WS-Enumeration et WS-Eventing. Pour plus d’informations sur les normes WS-Management et les schémas XML, consultez https://dmtf.org/standards/wsman

Messages

Le protocole WS-Management fournit une norme pour la construction de messages XML à l’aide de différentes normes de service web telles que WS-Addressing et WS-Transfer. Ces normes définissent des schémas XML pour les messages de service web. Les messages font référence à une ressource à l’aide d’un URI de ressource. Le protocole WS-Management ajoute un ensemble de définitions pour les opérations et les valeurs de gestion. Par exemple, WS-Transfer définit les opérations Get, Put, Create et Delete pour une ressource. WS-Management protocole ajoute Rename, Partial Get et Partial Put.

Les messages suivent les conventions du protocole SOAP (Simple Object Access Protocol) qui est utilisé par tous les protocoles de service web.

L’exemple de code suivant montre un message avec une opération Get. Cet exemple est présenté comme une aide pour comprendre à quoi ressemblent les messages sous-jacents. Vous n’avez pas besoin de savoir comment produire des messages SOAP. Les messages sont assemblés par Windows Remote Management lorsque vous exécutez une commande à l’aide de l’outil en ligne de commande Winrm ou exécutez un script écrit avec l’API de script WinRM.

Le message est une demande d’obtention du instance de Win32_LogicalDisk avec une propriété DeviceID « c: » à partir d’un serveur nommé RemoteComputer. La requête utilise le transport HTTP via le port 80. Le compte qui envoie la demande doit se trouver dans le groupe Administrateurs locaux sur l’ordinateur distant.

Les caractères avant les deux-points au début de chaque balise indiquent quelle norme définit l’élément XML. Par exemple, <wsa:To> indique que l’élément To est défini par la norme WS-Addressing et <s:Header> indique le début du contenu de l’en-tête dans un message SOAP. N’oubliez pas que la majorité du message est composée d’éléments XML définis par SOAP ou WS-Addressing. WS-Management protocole ajoute MaxEnvelopeSize, Selector et 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>

À propos de La gestion à distance windows

Gestion du matériel à distance