Add-DtcClusterTMMapping

Article
08/02/2013

Applies To: Windows Server 2012 R2 Preview

Add-DtcClusterTMMapping

Add-DtcClusterTMMapping is supported only on clustered computers and can be used to add a Cluster DTC Mapping.

Syntax

Parameter Set: ComPlusSet
Add-DtcClusterTMMapping -ClusterResourceName <String> -ComPlusAppId <String> -Local <Boolean> -Name <String> [ <CommonParameters>]

Parameter Set: ExeSet
Add-DtcClusterTMMapping -ClusterResourceName <String> -ExecutablePath <String> -Local <Boolean> -Name <String> [ <CommonParameters>]

Parameter Set: ServiceSet
Add-DtcClusterTMMapping -ClusterResourceName <String> -Local <Boolean> -Name <String> -Service <String> [ <CommonParameters>]

Detailed Description

Add-DtcClusterTMMapping is supported only on clustered computers and can be used to add a Cluster DTC Mapping.

Parameters

-ClusterResourceName<String>

Specifies a cluster DTC resource to associate with this mapping

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ComPlusAppId<String>

Specifies the COM+ application identifier to associate with this mapping.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ExecutablePath<String>

Specifies the path of the application to associate with this mapping.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Local<Boolean>

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Name<String>

Specifies the name of the DTC mapping to add.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Service<String>

Specifies the name of the Windows service to associate with this mapping.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Create a new DTC Cluster TM Mapping using Add-DtcClusterTMMapping.

Create a new DTC Cluster TM Mapping.

PS C:\> Add-DtcClusterTMMapping -Name "localTestAppMapping" -ExecutablePath "c:\TestApp\App.exe" -ClusterResourceName "DtcResource1" -Local $true

Add-DtcClusterTMMapping