Set-SqlAvailabilityGroup
可用性グループの設定を設定します。
構文
Set-SqlAvailabilityGroup
[-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
[-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
[-HealthCheckTimeout <Int32>]
[-DatabaseHealthTrigger <Boolean>]
[[-Path] <String>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SqlAvailabilityGroup
[-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
[-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
[-HealthCheckTimeout <Int32>]
[-DatabaseHealthTrigger <Boolean>]
[-InputObject] <AvailabilityGroup>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Set-SqlAvailabilityGroup コマンドレットは、AlwaysOn 可用性グループの既存の可用性グループの設定を変更します。 自動バックアップ設定、障害状態レベル、正常性チェックタイムアウトを変更できます。 プライマリ レプリカをホストするサーバー インスタンスでこのコマンドレットを実行する必要があります。
例
例 1: 正常性チェックタイムアウト期間を変更する
PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MAinAG" -HealthCheckTimeout 120000このコマンドは、MainAG という名前の可用性グループの正常性チェックタイムアウト プロパティを 120,000 ミリ秒 (2 分) に変更します。 自動フェールオーバーが有効になっている場合、この時間が経過すると、AlwaysOn 可用性グループによって自動フェールオーバーが開始されます。
例 2: 自動バックアップ設定を変更する
PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -AutomatedBackupPreference SecondaryOnlyこのコマンドは、MainAG という名前の可用性グループの自動バックアップ設定を SecondaryOnly に変更します。 この可用性グループ内のデータベースの自動バックアップは、プライマリ レプリカでは行われません。 代わりに、バックアップの優先度が最も高いセカンダリ レプリカで自動バックアップが実行されます。
例 3: 障害条件レベルを変更する
PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -FailureConditionLevel OnServerDownこのコマンドは、MainAG という名前の可用性グループのエラー条件レベルを OnServerDown に変更します。 プライマリ レプリカをホストするサーバー インスタンスがオフラインになり、自動フェールオーバーが有効になっている場合、AlwaysOn 可用性グループは自動フェールオーバーを開始します。
パラメーター
-AutomatedBackupPreference
可用性グループの自動バックアップ設定を指定します。 このパラメーターの有効値は、次のとおりです。
- プライマリ。 バックアップが常にプライマリ レプリカで実行されることを指定します。 このオプションでは、差分バックアップなど、セカンダリ レプリカでバックアップを実行するときに使用できない機能の使用がサポートされています。
- SecondaryOnly。 プライマリ レプリカでバックアップが実行されないように指定します。 プライマリ レプリカがオンラインの唯一のレプリカである場合、バックアップは実行されません。
- セカンダリ。 プライマリ レプリカがオンラインの唯一のレプリカでない限り、セカンダリ レプリカでバックアップが行われることを指定します。 その後、プライマリ レプリカでバックアップが実行されます。
- [なし] : バックアップを実行するレプリカを決定するときに、プライマリまたはセカンダリの状態が考慮されないことを指定します。 代わりに、バックアップの優先度とオンライン状態によって、バックアップを実行するレプリカが決まります。
| 型: | AvailabilityGroupAutomatedBackupPreference |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DatabaseHealthTrigger
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FailureConditionLevel
可用性グループの自動フェールオーバー動作を指定します。 このパラメーターの有効値は、次のとおりです。
- OnServerDown。 SQL Server サービスが停止した場合は、フェールオーバーまたは再起動します。
- OnServerUnresponsive。 より低い値の条件が満たされた場合、さらにSQL Server サービスがクラスターに接続されていて HealthCheckTimeout しきい値を超えた場合、または現在プライマリ ロールにある可用性レプリカが失敗状態になっている場合は、フェールオーバーまたは再起動します。
- OnCriticalServerError。 より小さい値の条件が満たされた場合、およびメモリ不足状態、重大な書き込みアクセス違反、またはダンプが多すぎる内部クリティカルなサーバー エラーが発生した場合は、フェールオーバーまたは再起動します。
- OnModerateServerError。 より低い値の条件が満たされた場合はフェールオーバーまたは再起動します。さらに、中程度のサーバー エラーが発生した場合は、メモリ不足状態が永続的に含まれます。
- OnAnyQualifiedFailureConditions。 より低い値の条件が満たされた場合はフェールオーバーまたは再起動します。さらに、エンジン ワーカー スレッドの枯渇や解決不可能なデッドロックが検出された状態を含む、条件を満たすエラー条件が発生した場合は再起動します。
| 型: | AvailabilityGroupFailureConditionLevel |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-HealthCheckTimeout
AlwaysOn 可用性グループが応答しないサーバーを異常と宣言するまでの時間の長さをミリ秒単位で指定します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InputObject
このコマンドレットが変更する可用性グループを AvailabilityGroup オブジェクトとして指定します。
| 型: | AvailabilityGroup |
| 配置: | 2 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Path
コマンドレットが変更する可用性データベースのパスを指定します。 このパラメーターを指定しない場合、このコマンドレットは現在の作業場所を使用します。
| 型: | String |
| 配置: | 2 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Script
このコマンドレットによって、このコマンドレットが実行するタスクを実行する Transact-SQL スクリプトが返されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |