Join-DtcDiagnosticResourceManager
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 |