Edit

Share via

Join-DtcDiagnosticResourceManager

  • Reference
Module:
MsDtc

Enlists a diagnostic Resource Manager for a transaction object.

Syntax

Join-DtcDiagnosticResourceManager
    [-Transaction] <DtcDiagnosticTransaction>
    [[-ComputerName] <String>]
    [[-Port] <Int32>]
    [-Volatile]
    [<CommonParameters>]

Description

The Join-DtcDiagnosticResourceManager cmdlet enlists a diagnostic Resource Manager (RM) for a specified transaction object. The transaction first needs to be sent to the RM.

Examples

Example 1: Enlist a new diagnostic transaction

PS C:\> $Transaction = New-DtcDiagnosticTransaction
PS C:\> Join-DtcDiagnosticResourceManager -Transaction $Transaction

The first command creates a transaction by using the New-DtcDiagnosticTransaction cmdlet, and then stores that transaction in the $Transaction variable.

The second command enlists the transaction stored in $Transaction to a diagnostic resource manager.

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

-Transaction

Specifies the transaction object on which to enlist the RM.

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

-Volatile

Indicates that this cmdlet makes a volatile enlistment. If you do not specify this parameter, the cmdlet makes a durable enlistment.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False