Receive-DtcDiagnosticTransaction

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.

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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Port

Specifies the listening port of the test RM.

Type:	Int32
Position:	1
Default value:	3002
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PropagationMethod

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

Type:	DtcTransactionPropagation
Accepted values:	Pull, Push
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False