Edit

Share via

Send-DtcDiagnosticTransaction

  • Reference
Module:
MsDtc

Propagates a transaction to a specified diagnostic Resource Manager.

Syntax

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

Description

The Send-DtcDiagnosticTransaction cmdlet propagates a transaction to a specified diagnostic Resource Manager (RM). Use the PropagationMethod parameter to specify the propagation method.

Examples

Example 1: Send a DTC diagnostic transaction

PS C:\> $Tx = New-DtcDiagnosticTransaction
PS C:\> Send-DtcDiagnosticTransaction -Transaction $Tx -ComputerName "Host1" -PropagationMethod Push

The first command creates a new DTC diagnostic transaction and assigns it to a variable.

The second command sends the diagnostic transaction to an RM running on the computer named Host1.

Parameters

-ComputerName

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

Type:String
Position:1
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:2
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:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Transaction

Specifies the DtcDiagnosticTransaction object to use in the transaction propagation. You can use the pipeline operator to pass this parameter value to the cmdlet.

Type:DtcDiagnosticTransaction
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False