Join-DtcDiagnosticResourceManager

NAME Join-DtcDiagnosticResourceManager



SYNOPSIS

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.





PARAMETERS

-ComputerName [<String>]

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.



Required? false

Position? 2

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Port [<Int32>]

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.



Required? false

Position? 3

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Transaction <DtcDiagnosticTransaction>

Specifies the transaction object on which to enlist the RM.



Required? true

Position? 1

Default value none

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-Volatile [<SwitchParameter>]

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



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS











OUTPUTS











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.







RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/p/?linkid=317166

Start-DtcDiagnosticResourceManager

Stop-DtcDiagnosticResourceManager

New-DtcDiagnosticTransaction