Edit

Share via

Receive-DtcDiagnosticTransaction

  • Reference
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