Protocollo WS-Management
Il protocollo WS-Management è stato sviluppato da un gruppo di produttori di hardware e software come standard pubblico per lo scambio remoto di dati di gestione con ogni dispositivo in cui il protocollo è implementato.
Standard
Per altre informazioni sul protocollo di WS-Management, vedere Specifica di Servizi Web per la gestione (WS-Management).
Lo scopo del protocollo è garantire coerenza e interoperabilità per le operazioni di gestione in molti tipi di dispositivi (incluso firmware) e sistemi operativi. WS-Management protocollo può essere esteso man mano che le nuove operazioni vengono identificate dal settore IT.
L'implementazione corrente del protocollo WS-Management è basata sulle specifiche standard seguenti: HTTPS, SOAP su HTTP (profilo WS-I), SOAP 1.2, WS-Addressing, WS-Transfer, WS-Enumeration e WS-Eventing. Per altre informazioni sugli standard WS-Management e sugli XML Schema, vedere https://dmtf.org/standards/wsman
Messaggi
Il protocollo WS-Management fornisce uno standard per la costruzione di messaggi XML usando vari standard del servizio Web, ad esempio WS-Addressing e WS-Transfer. Questi standard definiscono XML Schema per i messaggi del servizio Web. I messaggi fanno riferimento a una risorsa usando un URI della risorsa. Il protocollo WS-Management aggiunge un set di definizioni per operazioni e valori di gestione. Ad esempio, WS-Transfer definisce le operazioni Get, Put, Create e Delete per una risorsa. WS-Management protocollo aggiunge Rename, Partial Get e Partial Put.
I messaggi seguono le convenzioni del protocollo SOAP (Simple Object Access Protocol) usato da tutti i protocolli del servizio Web.
Nell'esempio di codice seguente viene illustrato un messaggio con un'operazione Get. Questo esempio viene illustrato come un aiuto per comprendere l'aspetto dei messaggi sottostanti. Non è necessario sapere come produrre messaggi SOAP. I messaggi vengono assemblati da Gestione remota Windows quando si esegue un comando usando lo strumento da riga di comando Winrm o si esegue uno script scritto con l'API di scripting WinRM.
Il messaggio è una richiesta per ottenere l'istanza di Win32_LogicalDisk con una proprietà DeviceID "c:" da un server denominato RemoteComputer. La richiesta usa il trasporto HTTP tramite la porta 80. L'account che invia la richiesta deve trovarsi nel gruppo administrators locale nel computer remoto.
I caratteri precedenti ai due punti all'inizio di ogni tag indicano quale standard definisce l'elemento XML. Ad esempio, <wsa:To> indica che l'elemento To è definito dallo standard WS-Addressing e <s:Header> indica l'inizio del contenuto dell'intestazione in un messaggio SOAP. Tenere presente che la maggior parte del messaggio è costituita da elementi XML definiti da SOAP o WS-Addressing. WS-Management protocollo aggiunge MaxEnvelopeSize, Selector e 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>
Argomenti correlati