Set-DtcClusterTMMapping
Applies To: Windows Server 2012 R2 Preview
Set-DtcClusterTMMapping
Set-DtcClusterTMMapping is supported only on clustered computers and modifies an existing Cluster DTC Mapping.
Syntax
Parameter Set: ComPlusSet
Set-DtcClusterTMMapping -ComPlusAppId <String> -Name <String> [-ClusterResourceName <String> ] [-Local <Boolean> ] [-MappingName <String> ] [ <CommonParameters>]
Parameter Set: ExeSet
Set-DtcClusterTMMapping -ExecutablePath <String> -Name <String> [-ClusterResourceName <String> ] [-Local <Boolean> ] [-MappingName <String> ] [ <CommonParameters>]
Parameter Set: LocalSet
Set-DtcClusterTMMapping -Local <Boolean> -Name <String> [-ClusterResourceName <String> ] [-MappingName <String> ] [ <CommonParameters>]
Parameter Set: ResourceNameSet
Set-DtcClusterTMMapping -ClusterResourceName <String> -MappingName <String> -Name <String> [-Local <Boolean> ] [ <CommonParameters>]
Parameter Set: ServiceSet
Set-DtcClusterTMMapping -Name <String> -Service <String> [-ClusterResourceName <String> ] [-Local <Boolean> ] [-MappingName <String> ] [ <CommonParameters>]
Detailed Description
Set-DtcClusterTMMapping is supported only on clustered computers and modifies an existing Cluster DTC Mapping.
Parameters
-MappingName<String>
Mapping name of the TM Mapping to be set.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ClusterResourceName<String>
Specifies the ClusterResourceName from which the TM Mapping is to be set.
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>
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.
DtcClusterTMMapping
An object of DtcClusterTMMapping containing modified mapping information.
Examples
Modify an existing DTC Cluster TM Mapping using Set-DtcClusterTMMapping.
Create a new DTC Cluster TM Mapping.
PS C:\> Set-DtcClusterTMMapping -Name "localTestAppMapping" -ExecutablePath "c:\TestApp\SampleApp.exe" -ClusterResourceName "DtcResource2"