2.2.4.11 ListenerType

ListenerType is used by Web Services Management Protocol Extensions for Windows Server 2003 servers 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 message authentication code (MAC) address. The schema MUST be as follows.

 <xs:schema xmlns:cfg="wsman:microsoft.com/wsman/2005
 /06/config.xsd" 
  xmlns:xs="http://www.w3.org/2001/XMLSchema" 
  targetNamespace="wsman:microsoft.com/wsman/2005/06/
 config.xsd" 
  elementFormDefault="qualified">
   <xs:element name="Listener" type="cfg:ListenerType"/>
   <xs:complexType name="ListenerType">
     <xs:sequence>
       <xs:element name="IP" 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="Transport" type="xs:string"/>
       <xs:element name="CertificateThumbprint" 
 type="xs:string"
                   minOccurs="0"/>
       <xs:element name="MACAddress" 
 type="xs:string" minOccurs="0"/>
     </xs:sequence>
   </xs:complexType>
 </xs:schema>
  

IP: IP address for which this listener MUST be created. The value MAY be a static IP address either in IPv4 dotted-decimal format or in IPv6 colon-delimited hexadecimal format, or the literal string "*".

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

Hostname: MUST be the Host name of the machine where the WS-Management service is running.

Enabled: Indicates whether the listener is enabled or disabled.

URLPrefix: MUST be the URI prefix on which to accept HTTP or HTTPS requests. MUST NOT be blank. MUST be a string containing only the characters a-zA-Z9-0_/ and MUST NOT start with or end with '/'. For example, if the machine name is SampleMachine, the WS-Management client specifies http://SampleMachine/<URLPrefix> in the destination address.

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

CertificateThumbprint: MUST contain the SHA-1 hash of the certificate as a 40-digit hexadecimal number. This MUST be required if the transport is HTTPS.

MACAddress: MUST be the Media Access Control (MAC) address of the network interface card (NIC). Listeners MAY be defined for a specific IP address or for all IP addresses associated with a specific MAC address. Required if IP is "*". MUST be a sequence of six or eight pairs of case-insensitive hexadecimal digits separated by "-" (for example, 32-a3-58-90-be-cc).

These configuration settings MUST be used when processing messages as described in section 3.1.4.1.29.