Disable-SqlAlwaysOn

リファレンス

モジュール:: SQLServer

サーバーのAlways On可用性グループ機能を無効にします。

構文

Disable-SqlAlwaysOn
       [[-Path] <String>]
       [-NoServiceRestart]
       [-Force]
       [-Credential <PSCredential>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Disable-SqlAlwaysOn
       [-InputObject] <Server>
       [-NoServiceRestart]
       [-Force]
       [-Credential <PSCredential>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Disable-SqlAlwaysOn
       -ServerInstance <String>
       [-NoServiceRestart]
       [-Force]
       [-Credential <PSCredential>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

説明

Disable-SqlAlwaysOn コマンドレットは、SQL Server インスタンスのAlways Onの可用性グループ機能を無効にします。

SQL Server サービスの実行中にAlways On可用性グループ機能が無効になっている場合は、変更を完了するためにデータベースエンジンサービスを再起動する必要があります。

Force パラメーターを指定しない限り、コマンドレットはサービスの再起動を求めます。

Always On可用性グループ機能が既に無効になっている場合、このコマンドレットは変更を行いません。

このコマンドレットはリモートサービスに対して実行できます。

このコマンドレットを実行するには、管理者権限が必要です。

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

例

例 1: 指定したパスAlways On可用性グループを無効にする

PS C:\> Disable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance"

このコマンドは、指定したパスにあるSQL ServerのインスタンスでAlways On可用性グループを無効にします。このコマンドの場合、サーバーインスタンスを再起動する必要があり、再起動するかどうかを確認するメッセージが表示されます。

例 2: 指定したパスで可用性グループAlways On無効にし、確認なしでサーバーを再起動する

PS C:\> Disable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -Force

このコマンドは、指定したパスにあるSQL ServerのインスタンスでAlways On可用性グループを無効にします。 [強制] オプションを選択すると、確認を求めずにサーバーインスタンスが再起動されます。

例 3: 指定したサーバーインスタンスAlways On可用性グループを無効にする

PS C:\> Disable-SqlAlwaysOn -ServerInstance "Computer\Instance"

このコマンドは、'Computer\Instance' という名前のSQL ServerインスタンスのAlways On可用性グループを無効にします。このコマンドはインスタンスを再起動する必要があり、この再起動を確認するメッセージが表示されます。

例 4: Windows 認証を使用して、指定したサーバーインスタンスAlways On可用性グループを無効にする

PS C:\> Disable-SqlAlwaysOn -ServerInstance "Computer\Instance" -Credential (Get-Credential "DOMAIN\Username")

このコマンドは、Windows 認証を使用して、'Computer\Instance' という名前のSQL ServerインスタンスのAlways On可用性グループを無効にします。指定したアカウント "DOMAIN\Username" のパスワードを入力するように求められます。この変更にはインスタンスを再起動する必要があり、この再起動の確認も求められます。

例 5: サーバーを再起動せずに、指定したパスAlways On可用性グループを無効にする

PS C:\> Disable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -NoServiceRestart

このコマンドは、指定したパスにあるSQL ServerのインスタンスでAlways On可用性グループを無効にしますが、コマンドはインスタンスを再起動しません。変更を有効にするには、このサーバーインスタンスを手動で再起動する必要があります。

パラメーター

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

SQL Server インスタンスのAlways On設定を変更するアクセス許可を持つ Windows 資格情報を指定します。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。スクリプトの作成を許可するために、このパラメーターを指定しています。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Always On可用性グループ設定が無効になっているSQL Serverのインスタンスのサーバーオブジェクトを指定します。

Type:	Server
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoServiceRestart

ユーザーがSQL Server サービスの再起動を求めないことを示します。変更を有効にするには、手動で SQL Server サービスを再起動する必要があります。このパラメーターを設定すると、Force は無視されます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

SQL Serverのインスタンスへのパスを指定します。これは省略可能なパラメーターです。指定しない場合は、現在の作業場所の値が使用されます。

Type:	String
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerInstance

Always Onが無効になっているSQL Serverのインスタンスの名前を指定します。 MACHINENAME\INSTANCE という形式で指定する必要があります。 Credential パラメーターを使用して、リモートサーバーのAlways On設定を変更します。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.SqlServer.Management.Smo.Server

System.String

出力

System.Object

Enable-SqlAlwaysOn