3.2.5.3.15 Rules for the wxf:ConnectResponse Message

  • Article

A client uses the wxf:Connect message to create a RunspacePool or a pipeline on the server, as specified in section 3.1.5.3.14. A server implementation MUST process the wxf:Connect message and send either a wxf:ConnectResponse message (as specified in [MS-WSMV] section 3.1.4.5.2) to indicate success, or a wxf:Fault message (as specified in [MS-WSMV] section 2.2.4.43) to indicate failure. The server MUST use wxf:ConnectResponse messages to send server SESSION_CAPABILITY messages back to the client.

When connecting to a RunspacePool, the wxf:Connect message sent by clients MUST contain an option with the name "protocolversion" and the value "2.2". If the server does not accept a client's protocol version, then the server MUST send an error message to the client using a wxf:Fault message (as specified in [MS-WSMV] section 2.2.4.43).

The following information MUST be included in the wxf:Fault message.

Element

Value

Code

The value 2152991685.

Machine

A string that SHOULD specify the machine name where the fault occurred.

Message

A string message in the following format:

"<PSProtocolVersionError ServerProtocolVersion="x.y" ServerBuildVersion="a.b.cdef.g"> message </PSProtocolVersionError>"

Where "x.y" represents the server's ProtocolVersion (currently 2.1), and "a.b.cdef.g" represents the server's build number (such as 7.0.7000.0) and "message" is an unstructured text that SHOULD describe the cause of the fault in detail.