PowerShell Logo Small

Stop-Dtc



This is the built-in help made by Microsoft for the command 'Stop-Dtc', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 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

Stops a DTC instance.

SYNTAX


Stop-Dtc [-AsJob] [-CimSession <CimSession[]>] [-DtcName <String>] [-Recursive] [-ThrottleLimit <Int32>] [-Confirm] [-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Stop-Dtc cmdlet stops the Distributed Transaction Coordinator (DTC) instance that the DtcName parameter specifies.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/p/?linkid=317185
Get-Dtc
Install-Dtc
Start-Dtc
Test-Dtc
Uninstall-Dtc

REMARKS

<

Examples


Example 1: Stop a local DTC instance

This command uses the Get-Dtc cmdlet to view the status of the local DTC instance.
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 : Contoso093
XAEndpointCid : ced49d85-82a9-49d9-a6ee-8c5b4bd7b5bd

This command stops the local DTC instance. The first command shows that the instance is started, and, therefore, it is safe to stop that instance.
PS C:\> Stop-Dtc -DtcName "Local"

This command uses Get-Dtc, again, 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 : Contoso093
XAEndpointCid : ced49d85-82a9-49d9-a6ee-8c5b4bd7b5bd



This example stops the local DTC instance. To stop a different instance, specify a different value for the DtcName parameter.