Enable-SqlAlwaysOn
AlwaysOn 可用性グループ機能を有効にします。
構文
Enable-SqlAlwaysOn
[[-Path] <String>]
[-NoServiceRestart]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Enable-SqlAlwaysOn
[-InputObject] <Server>
[-NoServiceRestart]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Enable-SqlAlwaysOn
-ServerInstance <String>
[-NoServiceRestart]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Enable-SqlAlwaysOn コマンドレットは、SQL Serverのインスタンスで AlwaysOn を有効にします。 SQL Server サービスの実行中に AlwaysOn 可用性グループ機能が有効になっている場合は、変更を完了するためにデータベース エンジン サービスを再起動する必要があります。 Force パラメーターを指定しない限り、コマンドレットはサービスの再起動を求めるメッセージを表示します。
AlwaysOn 可用性グループ機能が既に有効になっている場合、アクションは実行されません。
このコマンドレットはリモート サービスに対して実行できます。
このコマンドレットを実行するには、管理者権限が必要です。
例
例 1: 指定したパスで AlwaysOn 可用性グループを有効にする
PS C:\> Enable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance"
このコマンドを実行すると、指定したパスにある SQL Serverのインスタンスで AlwaysOn 可用性グループが有効になります。 この変更ではインスタンスを再起動する必要があり、再起動するかどうかを確認するメッセージが表示されます。
例 2: 指定したパスで AlwaysOn 可用性グループを有効にし、確認なしでサーバーを再起動する
PS C:\> Enable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -Force
このコマンドを実行すると、指定したパスにある SQL Serverのインスタンスで AlwaysOn 可用性グループが有効になります。 [強制] オプションを選択すると、確認を求めずにサーバー インスタンスが再起動されます。
例 3: 指定したサーバー インスタンスに対して AlwaysOn 可用性グループを有効にする
PS C:\> Enable-SqlAlwaysOn -ServerInstance "Computer\Instance"
このコマンドを実行すると、Computer\Instance という名前のSQL Serverのインスタンスで AlwaysOn 可用性グループが有効になります。 この変更にはインスタンスを再起動する必要があり、この再起動を確認するメッセージが表示されます。
例 4: Windows 認証を使用して、指定したサーバー インスタンスの AlwaysOn 可用性グループを有効にする
PS C:\> Enable-SqlAlwaysOn -ServerInstance "Computer\Instance" -Credential (Get-Credential "DOMAIN\Username")
このコマンドは、Windows 認証を使用して Computer\Instance という名前のSQL Serverのインスタンスで AlwaysOn 可用性グループを有効にします。 指定したアカウントのパスワードを入力するように求められます。 この変更ではインスタンスを再起動する必要があり、再起動するかどうかを確認するメッセージも表示されます。
例 5: サーバーを再起動せずに、指定したパスで AlwaysOn 可用性グループを有効にする
PS C:\> Enable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -NoServiceRestart
このコマンドは、指定したパスにあるSQL Server インスタンスで AlwaysOn 可用性グループを有効にしますが、コマンドはインスタンスを再起動しません。 変更を有効にするには、このサーバー インスタンスを手動で再起動する必要があります。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Credential
AlwaysOn 可用性グループ機能を有効にするSQL Server インスタンスの名前を指定します。 形式は MACHINENAME\INSTANCE です。 リモート サーバーでこの設定を有効にするには、 Credential パラメーターと共にこれを使用します。
型: | PSCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。 スクリプトの作成を許可するために、このパラメーターを指定しています。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
SQL Server インスタンスのサーバー オブジェクトを指定します。
型: | Server |
配置: | 2 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-NoServiceRestart
ユーザーがSQL Server サービスの再起動を求めないことを示します。 変更を有効にするには、手動で SQL Server サービスを再起動する必要があります。 このパラメーターを設定すると、 Force は無視されます。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Path
SQL Server インスタンスへのパスを指定します。 これは省略可能なパラメーターです。 指定しない場合は、現在の作業場所が使用されます。
型: | String |
配置: | 2 |
規定値: | 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 |