Enable-SqlAlwaysOn

Always On 可用性グループ機能を有効にします。

構文

Enable-SqlAlwaysOn
      [[-Path] <String>]
      [-NoServiceRestart]
      [-Force]
      [-Credential <PSCredential>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-SqlAlwaysOn
      [-InputObject] <Server>
      [-NoServiceRestart]
      [-Force]
      [-Credential <PSCredential>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Enable-SqlAlwaysOn
      -ServerInstance <String>
      [-NoServiceRestart]
      [-Force]
      [-Credential <PSCredential>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Enable-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:\> Enable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance"

このコマンドを実行すると、指定したパスにある SQL Server のインスタンスで Always On 可用性グループが有効になります。 この変更にはインスタンスを再起動する必要があり、この再起動を確認するメッセージが表示されます。

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

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

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

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

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

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

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

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

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

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

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

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

パラメーター

-Confirm

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

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

-Credential

Always On 可用性グループ機能を有効にする SQL Server インスタンスの名前を指定します。 形式は MACHINENAME\INSTANCE です。 リモート サーバーでこの設定を有効にするには、Credential パラメーターと共にこれを使用します。

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

-Force

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

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

-InputObject

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

SQL Server インスタンスの名前を指定します。 形式は MACHINENAME\INSTANCE です。 リモート サーバーでこの設定を有効にするには、Credential パラメーターと共にこれを使用します。

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

-WhatIf

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

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

入力

Microsoft.SqlServer.Management.Smo.Server

System.String

出力

System.Object