Export (0) Print
Expand All

3.1.5.3.5 Rules for the wxf:Send Message

The wxf:Send message (as specified in [MS-WSMV] section 3.1.4.13) is used to send input to a pipeline or a RunspacePool. The following information is included in the message.

Element

Value

ResourceURI

The Resource URI of the RunspacePool to which this send message is targeted. For more information see section 3.1.5.3.3.

ShellID selector

The ShellID returned in the wxf:ResourceCreated message (see section 3.1.5.3.2).

The body of the send message MUST contain a send data type as described in [MS-WSMV] section 2.2.4.32. The data type MUST contain the following information.

Element

Value

Stream

Stdin - if messages are to be sent in the regular priority order.

Pr - to send a PIPELINE_HOST_RESPONSE message (see sections 2.2.2.27 and RUNSPACEPOOL_HOST_RESPONSE message 2.2.2.16).

The Name attribute of the stream element MUST be accordingly stdin or pr.

A wxf:Send message can be sent to a RunspacePool or pipeline. If the wxf:Send message is targeted to a pipeline it MUST contain the following attribute:

Element

Attribute

Value

Stream

CommandId

The CommandId returned in the wxf:CommandResponse message (see section 3.1.5.3.4).

This attribute MUST NOT be specified if the wxf:Send message is targeted to a RunspacePool.

If the wxf:Send message is successfully received and processed by the server, the server MUST send either a success or a failure message. In either case a response is sent from the server. A wxf:SendResponse message, described in [MS-WSMV] section 2.2.4.33, is sent to notify success. A wxf:Fault message, described in [MS-WSMV] section 2.2.4.43, is sent to notify failure.

For any given RunspacePool or pipeline, there can only be one outstanding wxf:Send message targeted to that RunspacePool or pipeline. The PowerShell client MUST wait until the PowerShell server replies to the wxf:Send message with a wxf:SendResponse message or a wxf:Fault message before sending another wxf:Send message targeted to the same RunspacePool or pipeline.

Only the following PowerShell messages are allowed to be sent to the server using the wxf:Send message: SESSION_CAPABILITY (section 2.2.2.1), INIT_RUNSPACEPOOL (section 2.2.2.2), PUBLIC_KEY (section 3.1.5.4.3), SET_MAX_RUNSPACES (section 3.1.5.4.6), SET_MIN_RUNSPACES (section 3.1.5.4.7), CREATE_PIPELINE (section 3.1.5.4.10), GET_AVAILABLE_RUNSPACES (section 3.1.5.4.11), RUNSPACEPOOL_HOST_RESPONSE (section 3.1.5.4.16), PIPELINE_INPUT (section 3.1.5.4.17), END_OF_PIPELINE_INPUT (section 3.1.5.4.18), and PIPELINE_HOST_RESPONSE (section 3.1.5.4.27).

 
Show:
© 2014 Microsoft