Receive-Dtc Diagnostic Transaction

Module:
msdtc
Propagates a transaction from a given diagnostic Resource Manager.

Syntax 

Receive-DtcDiagnosticTransaction
       [[-ComputerName] <String>]
       [[-Port] <Int32>]
       [[-PropagationMethod] <DtcTransactionPropagation>]
       [<CommonParameters>]

Description

The Receive-DtcDiagnosticTransaction cmdlet propagates a transaction from a specified diagnostic Resource Manager (RM). A transaction is created on the specified RM and propagated to the Windows PowerShell® client using either pull or push propagation. Use the PropagationMethod parameter to specify the propagation mechanism.

Examples

Example 1: Receive a diagnostic transaction 

PS C:\> Receive-DtcDiagnosticTransaction -ComputerName "Host1" -Port 17123 -PropagationMethod Pull
Id
--
d23fd4b1-1b54-486a-9e9f-a92550a19ce2

This command pulls a diagnostic transaction from Host1 port 17123.

Optional Parameters

-ComputerName

Specifies the host name of the computer on which the RM runs. If you do not specify a host name, this cmdlet uses the name of the local computer.

Type: String
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Port

Specifies the listening port of the test RM. If you do not specify a port number, this cmdlet uses the name of the local computer.

Type: Int32
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PropagationMethod

Specifies the propagation mechanism, pull or push, to use. The default is pull.

Type: DtcTransactionPropagation
Parameter Sets: Pull, Push
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False