Stop-SqlInstance

モジュール:: SqlServer

指定した SQL Server インスタンスを停止します。

構文

Stop-SqlInstance
    [-Path <String[]>]
    [-Credential] <PSCredential>
    [-AutomaticallyAcceptUntrustedCertificates]
    [-ManagementPublicPort <Int32>]
    [-RetryTimeout <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-SqlInstance
    -InputObject <Server[]>
    [-Credential] <PSCredential>
    [-AutomaticallyAcceptUntrustedCertificates]
    [-ManagementPublicPort <Int32>]
    [-RetryTimeout <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-SqlInstance
    -ServerInstance <String[]>
    [-Credential] <PSCredential>
    [-AutomaticallyAcceptUntrustedCertificates]
    [-ManagementPublicPort <Int32>]
    [-RetryTimeout <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Stop-SqlInstance コマンドレットは、SQL Server の指定されたインスタンスを停止します。

SQL Server クラウドアダプターは、SQL Server のインスタンスをホストするコンピューター上で実行され、アクセス可能である必要があります。

このコマンドレットは、次の操作モードをサポートしています。

インスタンスの Windows PowerShell パスを指定します。
サーバーオブジェクトを指定します。
SQL Server のターゲットインスタンスの ServerInstance オブジェクトを指定します。

Note: This cmdlet ceased to work a long time ago. It's been removed in version 22 of the module.

例

例 1: SQL Server のインスタンスを停止する

PS C:\> CD SQLSERVER:\SQL\Computer\Instance
PS SQLSERVER:\SQL\Computer\Instance> Stop-SqlInstance -Credential $Credential -AcceptSelfSignedCertificate

最初のコマンドは、作業ディレクトリを SQLSERVER:\SQL\Computer\Instanceに変更します。

例 2: 指定したコンピューター上の SQL Server のすべてのインスタンスを停止する

PS C:\> Get-SqlInstance -Credential $Credential -MachineName "Computer006" | Stop-SqlInstance -Credential $Credential -AcceptSelfSignedCertificate

このコマンドは、 Computer006 という名前のコンピューター上の SQL Server のすべてのインスタンスを取得し、すべてのインスタンスを停止します。ターゲットコンピューターの自己署名証明書は、ユーザーにメッセージを表示せずに自動的に受け入れられます。

パラメーター

-AutomaticallyAcceptUntrustedCertificates

このコマンドレットが信頼されていない証明書を自動的に受け入れることを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Credential

ターゲットコンピューター上の Windows 管理者の資格情報を持つユーザーアカウントを指定します。

型:	PSCredential
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

ターゲットインスタンスのサーバーオブジェクトの配列を指定します。

型:	Server[]
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ManagementPublicPort

ターゲットコンピューターのパブリック管理ポートを指定します。このパラメーターは、ターゲットコンピューターのポートに直接アクセスできないが、エンドポイントを介して公開されている場合に使用されます。つまり、このコマンドレットは別のポートに接続する必要があります。

SQL Server クラウドアダプターには、このポートからアクセスできる必要があります。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Path

このコマンドレットが操作を実行する文字列配列として、SQL Server のインスタンスへのパスを指定します。このパラメーターの値を指定しない場合、コマンドレットは現在の作業場所を使用します。

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RetryTimeout

ターゲットサーバーでコマンドを再試行する期間を指定します。タイムアウトが切れると、再試行は行われません。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ServerInstance

操作のターゲットとなる SQL Server のインスタンスの名前を文字列配列として指定します。

型:	String[]
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]