Set-DtcNetworkSetting

Article
05/22/2012

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
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
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
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
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
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
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
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
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
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Confirm

Prompts you for confirmation before executing the command.

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

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

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

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