Share via

2.2.4.6 ClientType

  • Article

ClientType is the overall container for the Web Services Management Protocol Extensions for Windows Vista client configuration. The schema MUST be as follows.

The type is used under the following namespace:  http://schemas.microsoft.com/wbem/wsman/1/config

 <xs:complexType name="ClientType">
   <xs:sequence>
     <xs:element name="NetworkDelayms"
       type="xs:unsignedInt"
       default="5000"
      />
     <xs:element name="URLPrefix"
       type="xs:string"
       default="wsman"
      />
     <xs:element name="AllowUnencrypted"
       type="xs:boolean"
       default="false"
      />
     <xs:element name="Auth"
       type="cfg:ClientAuthType"
      />
     <xs:element name="DefaultPorts"
       type="cfg:ClientDefaultPortsType"
      />
     <xs:element name="TrustedHosts"
       type="xs:string"
      />
   </xs:sequence>
 </xs:complexType>
 

Elements

NetworkDelayms: Extra time in milliseconds that the Web Services Management Protocol Extensions for Windows Vista client waits to accommodate for network delay time. The minimum value MUST be 500. The maximum value MUST be 4294967295. The default value MUST be 5000. This configuration setting is used by the Client Operation Timeout timer, as specified in section 3.2.5.

URLPrefix: Default URI suffix that MUST be used by Web Services Management Protocol Extensions for Windows Vista clients when sending requests. It MUST NOT be blank. It MUST be a string containing only the following characters: a-zA-Z9-0_/. It MUST NOT start with or end with "/". The default value MUST be "wsman".

AllowUnencrypted: Contains a setting that allows the Web Services Management Protocol Extensions for Windows Vista client to send requests by using an authentication scheme and transport that does not encrypt the request and response, such as Digest over HTTP. The default value MUST be false. Used when sending messages as specified in section 3.2.4.1.22.1.

Auth: This MUST contain additional elements to configure authentication schemes, as specified in section 2.2.4.4.

DefaultPorts: This MUST contain additional elements to configure the default ports used when sending request messages, as specified in section 2.2.4.5.

TrustedHosts: Contains host names to which the Web Services Management Protocol Extensions for Windows Vista clients are allowed to send requests by using an authentication scheme and transport that does not allow the client to authenticate the service, such as Basic over HTTP. The specified host names can be either Internet host names or IP addresses. TrustedHosts MUST be one of three possible values:

  • Blank: No hosts are trusted.

  • The asterisk "*" character: All hosts are trusted.

  • A list of host name patterns separated by the comma "," character, in which each host name can be one of four possible values:

    • String starting with the asterisk "*" character and containing at least two characters. All hosts that share the suffix are trusted.

    • String ending with the asterisk "*" character and containing at least two characters. All hosts that share the prefix are trusted.

    • The exact string "<local>": All NetBIOS names are trusted (for example, strings that do not contain the period "." character).

    • A string without the asterisk "*" character: The host named by the string is trusted.

The default value for the <TrustedHosts> element MUST be a blank string.