Stop-Dtc

Stop-Dtc

Stops a DTC instance.

構文

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>]

詳細説明

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

パラメーター

-CimSession<CimSession[]>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクトを入力します。既定値は、ローカル コンピューターで実行中の現在のセッションです。

-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>

このコマンドレットを実行するために確立できる最大同時操作数を指定します。このパラメーターを省略するか、値として 0 を入力した場合、Windows PowerShell® では、コンピューターで実行している CIM コマンドレットの数に基づいて、コマンドレットに対する最適なスロットル制限を計算します。スロットル制限は現在のコマンドレットのみに適用され、セッションまたはコンピューターには適用されません。

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

<WorkflowParameters>

このコマンドレットは次のワークフロー共通パラメーターをサポートします。-PSParameterCollection、-PSComputerName、-PSCredential、-PSConnectionRetryCount、-PSConnectionRetryIntervalSec、-PSRunningTimeoutSec、-PSElapsedTimeoutSec、-PSPersist、-PSAuthentication、-PSAuthenticationLevel、-PSApplicationName、-PSPort、-PSUseSSL、-PSConfigurationName、-PSConnectionURI、-PSAllowRedirection、-PSSessionOption、-PSCertificateThumbprint、-PSPrivateMetadata、-AsJob、-JobName、–InputObject。詳細については、以下を参照してください。  about_WorkflowCommonParameters。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

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"

関連トピック

Get-Dtc

Install-Dtc

Start-Dtc

Test-Dtc

Uninstall-Dtc