3.1.5.3.16 Rules for the wxf:Disconnect Message
The PowerShell Remoting Protocol disconnects a remote RunspacePool, created using a remote shell as specified in section 3.1.5.3.1, by sending a wxf:Disconnect message to the remote shell as specified in [MS-WSMV] section 3.1.4.11. Once the server shell is disconnected, all command input and output streams associated with the shell are automatically suspended. The header of the wxf:Disconnect message MUST contain the following information.
Element |
Value |
---|---|
ResourceURI |
Any string that satisfies the rules specified in [MS-WSMV] section 3.1.4.5.2.<10> |
ShellID selector |
The ShellID returned in the wxf:ResourceCreated message (see section 3.1.5.3.2). |
The body of the message MAY contain the following optional elements.
Element |
Value |
---|---|
IdleTimeout |
Any integer value, which will override the idle timeout value specified in the prior wxf:Create message.<11> |
BufferMode |
Either of the strings "Drop" or "Block", which indicate the buffering mode the server will use when the shell is disconnected. |
If the wxf:Disconnect message is successfully received and processed by the server, the server MUST send either a success or a failure message. A wxf:DisconnectResponse message, as specified in [MS-WSMV] section 3.1.4.15, indicates success. A wxf:Fault message, specified in [MS-WSMV] section 2.2.4.43, indicates failure.