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.