3.1.4.1.29.5 http://schemas.microsoft.com/wbem/wsman/1/config/listener
The http://schemas.microsoft.com/wbem/wsman/1/config/listener resource URI MUST be used for configuring the server to listen on the network for WS-Management requests. By default, the server is configured with no listeners resulting in no remote configuration of the machine by using WS-Management. This means that no remote configuration can be done initially until some form of configuration is performed locally.
Enumeration can be used to retrieve all listeners configured on the server. The Address and Transport properties that are returned with each of the objects can be used as a selector to address the specific configuration item for updates.
The Web Services Management Protocol Extensions for Windows Vista service MUST support wsman:EnumerationMode for this resource URI and respond with the listener, EPR, or both as requested by the client.
To retrieve and configure an individual listener, the listener needs to be referred by a selector. The following properties, which are part of cfg:ListenerType, are the selectors.
|
Selector name |
Description |
|---|---|
|
Address |
The address on which the server is configured to listen. |
|
Transport |
Transport on which to listen; either HTTP or HTTPS. |
When doing a Create, some properties in cfg:ListenerType are mandatory, whereas others are optional, as shown in following table.
|
Property |
Mandatory |
Default value |
|---|---|---|
|
Address |
Yes |
None, specified as selector. |
|
Transport |
Yes |
None, specified as selector. |
|
Port |
No |
Defaults based upon the values of cfg:ServiceDefaultPortsType. |
|
Hostname |
No |
None if HTTP. Defaults to machine name if HTTPS. |
|
Enabled |
No |
True. |
|
URLPrefix |
No |
wsman. |
|
CertificateThumbprint |
No |
None, if HTTP. Defaults to a certificate whose CN matches the Hostname property. If no such certificate can be found, the create MUST fail. |
|
ListeningOn |
No |
None. This value is computed in an implementation-dependent way and cannot be directly set.<83> The Web Services Management Protocol Extensions for Windows Vista service MUST return a wsman:InternalError fault in response to a Put request if the ListeningOn property is present. |
If and only if the Enabled property is true, the Web Services Management Protocol Extensions for Windows Vista service MUST listen on the network on the port given by the Port property and only process requests sent to a configured destination IP address and addressed to the path given by the URLPrefix property.
When considering destination IP addresses, the Web Services Management Protocol Extensions for Windows Vista service MUST listen to address(es) specified by the Address property of the listener unless those addresses are excluded by the IPv4Filter or IPv6Filter properties of the service configuration. The Address property indicates a specific IP addresses (if the Address property is a valid IP address), on all IP address associated with a specific MAC address (if the Address property is a valid MAC address), or all IP addresses on the server (if the Address property is "*").
A valid IP address is an IP address exposed by the host. A valid MAC address is a MAC address exposed by the host.
The Web Services Management Protocol Extensions for Windows Vista service MUST return a wsman:InternalError fault in response to a Create request if an invalid IP address or an invalid MAC address is specified.
The Web Services Management Protocol Extensions for Windows Vista service MUST return a wsman:InternalError fault in response to a Create or Put request if the Transport property is HTTPS and the certificate identified by the CertificateThumbprint property does not exist or the Common Name in the certificate does not match the Hostname property.