Join-DtcDiagnosticResourceManager
Enlists a diagnostic Resource Manager for a transaction object.
Syntax
Default (Default)
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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Transaction
Specifies the transaction object on which to enlist the RM.
Parameter properties
| Type: | DtcDiagnosticTransaction |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Volatile
Indicates that this cmdlet makes a volatile enlistment. If you do not specify this parameter, the cmdlet makes a durable enlistment.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.