Set-DtcNetworkSetting

Article
08/02/2013

Applies To: Windows Server 2012 R2 Preview

Set-DtcNetworkSetting

Set-DtcNetworkSetting modifies the DTC network and security configuration for the DTC service specified by the DtcName parameter. Set-DtcNetworkSetting will restart the DTC service.

Syntax

Parameter Set: DisableNetwork
Set-DtcNetworkSetting -DisableNetworkAccess [-DtcName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: NetworkSettings
Set-DtcNetworkSetting [-AuthenticationLevel <String> ] [-DtcName <String> ] [-InboundTransactionsEnabled <Boolean> ] [-LUTransactionsEnabled <Boolean> ] [-OutboundTransactionsEnabled <Boolean> ] [-RemoteAdministrationAccessEnabled <Boolean> ] [-RemoteClientAccessEnabled <Boolean> ] [-XATransactionsEnabled <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

Set-DtcNetworkSetting modifies the DTC network and security configuration for the DTC service specified by the DtcName parameter. Set-DtcNetworkSetting will restart the DTC service.

Parameters

-DtcName<String>

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByValue, ByPropertyName)
Accept Wildcard Characters?	false

-DisableNetworkAccess

Disables network access for the DTC instance.

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

-AuthenticationLevel<String>

Sets the network authentication level of the DTC instance to NoAuth, Incoming, or Mutual.

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

-InboundTransactionsEnabled<Boolean>

Enables or Disables inbound transactions to the DTC instance.

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

-LUTransactionsEnabled<Boolean>

Enables or Disables LU transactions in the DTC instance.

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

-XATransactionsEnabled<Boolean>

Enables or Disables XA transactions in the DTC instance.

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

-OutboundTransactionsEnabled<Boolean>

Enables or Disables outbound transactions from the DTC instance.

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

-RemoteAdministrationAccessEnabled<Boolean>

Enables or Disables remote administration access for the DTC instance.

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

-RemoteClientAccessEnabled<Boolean>

Enables or Disables remote client access for the DTC instance.

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

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?	false
Position?	named
Default Value	false
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

A basic example of how to use Set-DtcNetworkSetting to change DTC Network and Security settings.

Change the Network and Security settings for the Local DTC instance.

PS C:\> Set-DtcNetworkSetting -DtcName Local -AuthenticationLevel Incoming -InboundTransactionsEnabled 0

Verify the changes now with Get-DtcNetworkSetting.

PS C:\> Get-DtcNetworkSetting -DtcName Local

__GENUS                           : 2
__CLASS                           : DtcNetworkSettings
__SUPERCLASS                      :
__DYNASTY                         : DtcNetworkSettings
__RELPATH                         :
__PROPERTY_COUNT                  : 7
__DERIVATION                      : {}
__SERVER                          :
__NAMESPACE                       :
__PATH                            :
AuthenticationLevel               : Mutual
InboundTransactionsEnabled        : True
LUTransactionsEnabled             : True
OutboundTransactionsEnabled       : True
RemoteAdministrationAccessEnabled : True
RemoteClientAccessEnabled         : True
XATransactionsEnabled             : True

Set-DtcNetworkSetting