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 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。