Enable-SqlAlwaysOn
Always On可用性グループ機能を有効にします。
構文
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のインスタンスで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 という名前のインスタンスAlways On可用性グループSQL Server有効になります。 この変更にはインスタンスを再起動する必要があり、この再起動を確認するメッセージが表示されます。
例 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
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Always On可用性グループ機能を有効にするSQL Server インスタンスの名前を指定します。 形式は MACHINENAME\INSTANCE です。 リモート サーバーでこの設定を有効にするには、Credential パラメーターと共にこれを使用します。
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
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
SQL Server インスタンスの名前を指定します。 形式は MACHINENAME\INSTANCE です。 リモート サーバーでこの設定を有効にするには、Credential パラメーターと共にこれを使用します。
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