Disable-SqlAlwaysOn

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

構文

Disable-SqlAlwaysOn
       [[-Path] <String>]
       [-NoServiceRestart]
       [-Force]
       [-Credential <PSCredential>]
       [-ProgressAction <ActionPreference>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-SqlAlwaysOn
       [-InputObject] <Server>
       [-NoServiceRestart]
       [-Force]
       [-Credential <PSCredential>]
       [-ProgressAction <ActionPreference>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-SqlAlwaysOn
       -ServerInstance <String>
       [-NoServiceRestart]
       [-Force]
       [-Credential <PSCredential>]
       [-ProgressAction <ActionPreference>]
       [-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

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

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

-Credential

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

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

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。 このパラメーターは、スクリプトの構築を許可するために指定されます。

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

-InputObject

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

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

-NoServiceRestart

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

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

-Path

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

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

-ProgressAction

スクリプト、コマンドレット、またはプロバイダーによって生成された進行状況の更新 (Write-Progress コマンドレットによって生成された進行状況バーなど) に対する PowerShell の応答方法を決定します。 Write-Progress コマンドレットは、コマンドの状態を示す進行状況バーを作成します。

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

-ServerInstance

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

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

-WhatIf

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

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

入力

Microsoft.SqlServer.Management.Smo.Server

System.String

出力

System.Object