2.2.4.19 ListenerType

  • Article

ListenerType MUST be used by the Web Services Management Protocol Extensions for Windows Vista service to listen on one or more IP addresses for WS-Management Protocol requests. ListenerType can be configured for HTTP or HTTPS on a specific IP or on an IP associated with a Media Access Control (MAC) address. The schema MUST be as shown here.

 <xs:schema xmlns:cfg="http://schemas.microsoft.com/wbem/wsman/1/config"
  xmlns:xs="http://www.w3.org/2001/XMLSchema"
  targetNamespace="http://schemas.microsoft.com/wbem/wsman/1/config"
  elementFormDefault="qualified">
   <xs:element name="Listener" type="cfg:ListenerType"/>
   <xs:complexType name="ListenerType">
     <xs:sequence>
       <xs:element name="Address" type="xs:string"/>
       <xs:element name="Transport" type="xs:string"/>
       <xs:element name="Port" type="xs:unsignedInt"/>
       <xs:element name="Hostname" type="xs:string"/>
       <xs:element name="Enabled" type="xs:boolean" default="true"
                   minOccurs="0"/>
       <xs:element name="URLPrefix" type="xs:string" default="wsman"
                   minOccurs="0"/>
       <xs:element name="CertificateThumbprint" type="xs:string"
                   minOccurs="0"/>
       <xs:element name="ListeningOn" type="xs:string" minOccurs="0" 
                   maxOccurs="unbounded"/>
     </xs:sequence>
   </xs:complexType>
 </xs:schema>
 

Elements

Address: The address for which this listener is created. The value can be one of the following:

  • The literal string "*".

  • The literal string "IP:" followed by a valid IP address in either IPv4 dotted-decimal format or in IPv6 coloned-hexadecimal format.

  • The literal string "MAC:" followed by a MAC address of a Network Interface Card (NIC). The MAC address MUST be a sequence of six or eight pairs of case-insensitive hexadecimal digits separated by "-" (for example, 32-a3-58-90-be-cc).

Transport: The transport used to send and receive WS-Management protocol requests and responses. The value MUST be either HTTP or HTTPS.

Port:  The TCP port for which this listener is created. The minimum value MUST be 1. The maximum value MUST be 65535.

Hostname:  Host name of the computer where the WS-Management service is running.

Enabled: Indicates if the listener is enabled or disabled.

URLPrefix: The Uniform Resource Identifier (URI) prefix on which to accept HTTP or HTTPS requests. It MUST NOT be blank. It MUST be a string containing only the characters a-zA-Z9-0_/ and it MUST NOT start with or end with '/'. For example, if the computer name is SampleMachine, the WS-Management client would specify http://SampleMachine/<URLPrefix> in the destination address.

CertificateThumbprint: This MUST contain the thumbprint of the certificate as a 40-digit hexadecimal number. It MUST be required if Transport is HTTPS.

ListeningOn:  Contains the IP address or all IP addresses on which the service is actually listening. This is derived from the Address element based upon the actual IPs associated with the listener. The value of the IP address MUST be in either IPv4 dotted-decimal notation or in IPv6 colon-delimited hexadecimal notation.

These configuration settings are used when processing messages as specified in section 3.1.4.1.29.5.