Set-SqlAvailabilityGroup
構文
ByPath (既定)
Set-SqlAvailabilityGroup
[[-Path] <String>]
[-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
[-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
[-HealthCheckTimeout <Int32>]
[-DatabaseHealthTrigger <Boolean>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Set-SqlAvailabilityGroup
[-InputObject] <AvailabilityGroup>
[-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
[-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
[-HealthCheckTimeout <Int32>]
[-DatabaseHealthTrigger <Boolean>]
[-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
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DatabaseHealthTrigger
Set-SqlAvailabilityGroup コマンドレットは、AlwaysOn 可用性グループの既存の可用性グループの設定を変更します。
自動バックアップ設定、障害状態レベル、正常性チェックのタイムアウトを変更できます。
このコマンドレットは、プライマリ レプリカをホストするサーバー インスタンスで実行する必要があります。
パラメーターのプロパティ
| 型: | Boolean
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FailureConditionLevel
可用性グループの自動フェールオーバー動作を指定します。
このパラメーターに使用できる値は次のとおりです。
- OnServerDown。
SQL Server サービスが停止した場合は、フェールオーバーまたは再起動します。
- OnServerUnresponsive。
低い値の条件が満たされている場合、および SQL Server サービスがクラスターに接続されていて HealthCheckTimeout しきい値を超えた場合、または現在プライマリ ロールの可用性レプリカが失敗状態にある場合は、フェールオーバーまたは再起動します。
- OnCriticalServerError。
低い値の条件が満たされている場合、および内部重大なサーバー エラーが発生した場合 (メモリ不足、重大な書き込みアクセス違反、またはダンプが多すぎる場合など) は、フェールオーバーまたは再起動します。
- OnModerateServerError。
低い値の条件が満たされている場合、および中程度のサーバー エラーが発生した場合は、フェールオーバーまたは再起動します。メモリ不足の永続的な状態が含まれます。
- OnAnyQualifiedFailureConditions。
低い値の条件が満たされている場合はフェールオーバーまたは再起動します。さらに、エンジン ワーカー スレッドの枯渇や解決できないデッドロックの検出など、条件を満たすエラー状態が発生した場合は、フェールオーバーまたは再起動します。
パラメーターのプロパティ
| 型: | AvailabilityGroupFailureConditionLevel
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-HealthCheckTimeout
AlwaysOn 可用性グループが応答しないサーバーを異常と宣言するまでの時間 (ミリ秒単位) を指定します。
パラメーターのプロパティ
| 型: | Int32
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
このコマンドレットが変更する可用性グループを AvailabilityGroup オブジェクトとして指定します。
| 型: | AvailabilityGroup
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
ByObject
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Path
コマンドレットが変更する可用性データベースのパスを指定します。
このパラメーターを指定しない場合、このコマンドレットは現在の作業場所を使用します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ByPath
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Script
このコマンドレットは、このコマンドレットが実行するタスクを実行する Transact-SQL スクリプトを返します。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。
コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。