PowerShell Logo Small

Stop-Dtc



This is the built-in help made by Microsoft for the command 'Stop-Dtc', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Stop-Dtc stops the DTC instance specified by the DtcName parameter.

SYNTAX


Stop-Dtc [-DtcName <String>] [-Recursive [<SwitchParameter>]] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


Stop-Dtc stops the DTC instance specified by the DtcName parameter.



<

RELATED LINKS


Online Version:



REMARKS

<

Examples




1. Get-Dtc -DtcName Local to view the Local DTC instance's Status.
PS C:\> Get-Dtc -DtcName Local
__GENUS : 2
__CLASS : DtcInstance
__SUPERCLASS :
__DYNASTY : DtcInstance
__RELPATH :
__PROPERTY_COUNT : 7
__DERIVATION : {}
__SERVER :
__NAMESPACE :
__PATH :
DtcName : Local
KtrmEndpointCid : b6628c9f-46ff-404d-a0fa-62657cb828af
OleTxEndpointCid : f3027ea1-4ee5-45b5-a01c-06f41221111b
Status : Started
UisEndpointCid : e9385758-8092-4dd7-8b09-587aa427a58e
VirtualServerName : CSDVM736403-GU
XAEndpointCid : ced49d85-82a9-49d9-a6ee-8c5b4bd7b5bd
2. Since the Status shows that the instance is started, it is safe to Stop-Dtc -DtcName Local.
PS C:\> Stop-Dtc -DtcName Local

3. Get-Dtc -DtcName Local one last time to confirm that the DTC instance is stopped.
PS C:\> Get-Dtc -DtcName Local
__GENUS : 2
__CLASS : DtcInstance
__SUPERCLASS :
__DYNASTY : DtcInstance
__RELPATH :
__PROPERTY_COUNT : 7
__DERIVATION : {}
__SERVER :
__NAMESPACE :
__PATH :
DtcName : Local
KtrmEndpointCid : b6628c9f-46ff-404d-a0fa-62657cb828af
OleTxEndpointCid : f3027ea1-4ee5-45b5-a01c-06f41221111b
Status : Stopped
UisEndpointCid : e9385758-8092-4dd7-8b09-587aa427a58e
VirtualServerName : CSDVM736403-GU
XAEndpointCid : ced49d85-82a9-49d9-a6ee-8c5b4bd7b5bd



Stopping a DTC instance.

For the purpose of this example the Local DTC instance is used, however you can stop any instance by changing the value of the DtcName
parameter