Stop-Dtc

Stop-Dtc

Stops a DTC instance.

Syntax

Parameter Set: Stop3
Stop-Dtc [-CimSession <CimSession[]> ] [-DtcName <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-Recursive] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Detaillierte Beschreibung

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

Parameter

-CimSession<CimSession[]>

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets New-CimSession oder Get-CimSession. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

-DtcName<String>

Specifies the DTC instance to stop. If you do not specify this parameter, or if you specify a value of Local, this cmdlet stops the local DTC instance.

-InformationAction<System.Management.Automation.ActionPreference>

-InformationVariable<System.String>

-Recursive

Indicates that the cmdlet stops any services that rely on the specified DTC instance, such as Microsoft SQL Server.

-ThrottleLimit<Int32>

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen dieses Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen oder der Wert 0 eingegeben wird, berechnet Windows PowerShell® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Die Drosselungsgrenze gilt nur für das aktuelle Cmdlet und nicht für die Sitzung oder den Computer.

-Confirm

Sie werden vor dem Ausführen des Cmdlets zur Bestätigung aufgefordert.

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

<WorkflowParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Workflowparameter: -PSParameterCollection, -PSComputerName, -PSCredential, -PSConnectionRetryCount, -PSConnectionRetryIntervalSec, -PSRunningTimeoutSec, -PSElapsedTimeoutSec, -PSPersist, -PSAuthentication, -PSAuthenticationLevel, -PSApplicationName, -PSPort, -PSUseSSL, -PSConfigurationName, -PSConnectionURI, -PSAllowRedirection, -PSSessionOption, -PSCertificateThumbprint, -PSPrivateMetadata, -AsJob, -JobName und -InputObject. Weitere Informationen finden Sie unter  about_WorkflowCommonParameters.

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

Beispiele

Example 1: Stop a local DTC instance

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

This command uses the Get-Dtc cmdlet to view the status of the local DTC instance.

PS C:\> Get-Dtc -DtcName "Local"

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"

Verwandte Themen

Get-Dtc

Install-Dtc

Start-Dtc

Test-Dtc

Uninstall-Dtc