3.1.4.17 Connect

Web Services Management Protocol Extensions for Windows Vista SHOULD<126> support the Connect operation, using the following Action URIs.

 http://schemas.microsoft.com/wbem/wsman/1/windows/shell/Connect http://schemas.microsoft.com/wbem/wsman/1/windows/shell/ConnectResponse

The set of resource URIs on which Web Services Management Protocol Extensions for Windows Vista MAY support the Connect operation is defined in the following table. Where relevant, the XML Schema Definition (XSD) type for the data that is passed as part of the request or response is referenced.

Resource URI

Input Data Type

Output Data Type

http://schemas.microsoft.com/wbem/wsman/1/windows/shell/cmd

rsp:Connect

rsp:ConnectResponse

This operation is applicable for the Custom Remote Shell scenario only. To connect to a shell instance when the client does not have HLP state from a previous WSMV connection to the shell, the client sends a Connect message to the EPR of that existing shell instance.

If the ShellID in the request is not present in the CustomRemoteShells table, the server MUST return a wsman:InvalidSelectorsInternalError fault. The server MUST return a wsman:InternalError fault if a Connect message is received for a shell that is already in the "connected" state.

Upon successful processing of a Connect request message, a shell processor MUST return a ConnectResponse message.