1.3.2 Typical Message Flow for CIM Operations with Prompting

The WS-Management Protocol can be used to execute operations on CIM resources that support the following PowerShell semantics.

  • Confirm

  • Debug

  • Error

  • Progress

  • Verbose

  • Warning

Providers of CIM resources can implement one or more PowerShell semantics. These extended semantics are grouped into categories according to their effect on input, output, and server-side processing.

Category

Semantics

Options that create additional server output

  • Confirm (Report)

  • Debug

  • ErrorAction (ReportReport)

  • Progress

  • Verbose

  • Warning

Options that modify server execution but do not require additional input from the client

  • Confirm (Ignore)

Options that require additional input from the client

  • Confirm (Inquire)

  • ErrorAction (Inquire)

For options that only create additional server output, the message flow is as follows. Although the Verbose option triggers the largest amount of additional output, the overall pattern of messages is the same for all options that only create additional server output. In the following diagram, [C1] indicates that the messages are transmitted on the primary HTTP connection.

Message sequence for options that create additional server output

Figure 2: Message sequence for options that create additional server output

  1. The client sends the CIM Operation Request message with the Verbose option specified.

  2. The server returns the verbose output in SOAP Response messages, as the CIM operation generates output.

  3. The server sends the CIM Operation Response message as it normally would in the absence of the Verbose option.

For operations that modify server execution but do not require additional client input, the pattern is as follows.

  1. The client sends the CIM Operation Request message, with the appropriate option specified, on the primary HTTP connection.

  2. The server returns any generated output in SOAP Response messages, as the CIM operation generates output, on the primary HTTP connection.

  3. The server returns the CIM Operation Response message that is the response to the original CIM Operation Request message.

For operations that require additional client input, the message sequence is as follows. The optional Confirm option triggers the exchange of a pair of Confirm Request and Confirm Response messages, but otherwise, the pattern of messages is the same for all options in this category. In the following diagram, [C1] and [C2] indicate that messages are transmitted on the primary and secondary HTTP connections, respectively.

Message sequence for options that require additional client input

Figure 3: Message sequence for options that require additional client input

  1. The client sends the CIM Operation Request message, with the Confirm option specified.

  2. The server returns the Confirm request in a SOAP Response message.

  3. The client sends an acknowledgment of the Confirm request on a secondary connection. Any additional input from the client required by this operation is also transmitted over the secondary connection.

  4. The server returns the CIM Operation Response message that is the response to the original CIM Operation Request message.