Send-Dtc Diagnostic Transaction

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.

Required Parameters

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

Optional 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
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, the cmdlet uses the name of the local computer.

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