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>]
Description
Set-SqlAvailabilityGroup Cmdlet 會修改 AlwaysOn 可用性群組中現有可用性群組上的設定。
您可以修改自動備份喜好設定、失敗狀況層級,以及健康情況檢查逾時。
您必須在裝載主要複本的伺服器實例上執行此 Cmdlet。
範例
範例 1:變更健康情況檢查逾時期限
PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MAinAG" -HealthCheckTimeout 120000
此命令會將MainAG可用性群組上的健康情況檢查逾時屬性變更為120,000毫秒,或兩分鐘。
如果啟用自動故障轉移,在這段時間長度之後,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 |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
參數屬性
| 類型: | SwitchParameter
|
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DatabaseHealthTrigger
Set-SqlAvailabilityGroup Cmdlet 會修改 AlwaysOn 可用性群組中現有可用性群組上的設定。
您可以修改自動備份喜好設定、失敗狀況層級,以及健康情況檢查逾時。
您必須在裝載主要複本的伺服器實例上執行此 Cmdlet。
參數屬性
| 類型: | Boolean
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-FailureConditionLevel
指定可用性群組的自動故障轉移行為。
此參數可接受的值為:
- OnServerDown。
如果 SQL Server 服務停止,故障轉移或重新啟動。
- OnServerUnresponsive。
如果滿足任何較低值的條件,則故障轉移或重新啟動,以及當 SQL Server 服務聯機到叢集且超過 HealthCheckTimeout 臨界值時,或如果目前處於主要角色的可用性複本處於失敗狀態,則為故障轉移或重新啟動。
- OnCriticalServerError。
如果滿足任何較低值的條件,則故障轉移或重新啟動,以及發生內部重大伺服器錯誤時,包括記憶體不足狀況、嚴重寫入存取違規或太多傾印。
- OnModerateServerError。
如果滿足任何較低值的條件,以及發生中度伺服器錯誤,故障轉移或重新啟動,則包含持續性記憶體不足狀況。
- OnAnyQualifiedFailureConditions。
如果滿足任何較低值的條件,則故障轉移或重新啟動,如果發生合格的失敗狀況,包括引擎背景工作線程耗盡和偵測到無法解決的死結。
參數屬性
| 類型: | AvailabilityGroupFailureConditionLevel
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-HealthCheckTimeout
指定時間長度,以毫秒為單位,之後 AlwaysOn 可用性群組會宣告無回應的伺服器狀況不良。
參數屬性
| 類型: | Int32
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
指定可用性群組做為 AvailabilityGroup 物件,此 Cmdlet 會修改。
| 類型: | AvailabilityGroup
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
ByObject
| Position: | 2 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Path
指定 Cmdlet 修改的可用性資料庫路徑。
如果您未指定此參數,此 Cmdlet 會使用目前的工作位置。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ByPath
| Position: | 2 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Script
指出此 Cmdlet 會傳回執行此 Cmdlet 所執行工作的 Transact-SQL 腳本。
參數屬性
| 類型: | SwitchParameter
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。
指令未執行。
參數屬性
| 類型: | SwitchParameter
|
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。