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 cmdlet 修改 AlwaysOn 可用性组中现有可用性组的设置。 可以修改自动备份首选项、故障条件级别和运行状况检查超时。 必须在承载主副本 (replica) 的服务器实例上运行此 cmdlet。

示例

示例 1:更改运行状况检查超时期限

PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MAinAG" -HealthCheckTimeout 120000

此命令将名为 MainAG 的可用性组的运行状况检查 timeout 属性更改为 120,000 毫秒或两分钟。 如果启用了自动故障转移,则在此时间长度过后,AlwaysOn 可用性组将启动自动故障转移。

示例 2:更改自动备份首选项

PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -AutomatedBackupPreference SecondaryOnly

此命令将名为 MainAG 的可用性组上的自动备份首选项更改为 SecondaryOnly。 主副本 (replica) 不会自动备份此可用性组中的数据库。 相反,自动备份发生在备份优先级最高的辅助副本 (replica) 上。

示例 3:更改失败条件级别

PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -FailureConditionLevel OnServerDown

此命令将名为 MainAG 的可用性组上的故障条件级别更改为 OnServerDown。 如果承载主副本 (replica) 的服务器实例脱机,并且启用了自动故障转移,则 AlwaysOn 可用性组将启动自动故障转移。

参数

-AutomatedBackupPreference

指定可用性组的自动备份首选项。 此参数的可接受值为:

  • 主副本。 指定备份始终发生在主副本 (replica) 上。 此选项支持使用备份在辅助副本 (replica) (例如差异备份)上运行时不可用的功能。
  • SecondaryOnly。 指定从不对主副本执行备份。 如果主副本 (replica) 是唯一联机副本 (replica) ,则不会进行备份。
  • 二 次。 指定备份发生在次要副本上,除非主副本 (replica) 是唯一联机副本 (replica) 。 然后,备份发生在主副本 (replica) 。
  • 无。 指定在决定执行备份的副本 (replica) 时不考虑主要或辅助状态。 相反,备份优先级和联机状态决定了执行备份副本 (replica) 。
类型:AvailabilityGroupAutomatedBackupPreference
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-DatabaseHealthTrigger

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-FailureConditionLevel

指定可用性组的自动故障转移行为。 此参数的可接受值为:

  • OnServerDown。 如果SQL Server服务停止,则故障转移或重启。
  • OnServerUnresponsive。 如果满足任何较低值的条件,以及当SQL Server服务连接到群集且超过 HealthCheckTimeout 阈值时,或者当前处于主要角色的可用性副本 (replica) 处于失败状态,则故障转移或重启。
  • OnCriticalServerError。 如果满足任何较低值的条件,以及发生内部关键服务器错误(包括内存不足、严重写入访问冲突或过多的转储),则故障转移或重启。
  • OnModerateServerError。 如果满足任何较低值的条件,则故障转移或重启,如果发生中度服务器错误,则包括永久性内存不足情况。
  • OnAnyQualifiedFailureConditions。 如果满足任何较低值的条件,则故障转移或重启,如果发生符合条件的故障条件,包括引擎工作线程耗尽和检测到无法解决的死锁。
类型:AvailabilityGroupFailureConditionLevel
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-HealthCheckTimeout

指定时间长度(以毫秒为单位),之后 AlwaysOn 可用性组将无响应服务器声明为不正常。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

指定此 cmdlet 修改的可用性组作为 AvailabilityGroup 对象。

类型:AvailabilityGroup
Position:2
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Path

指定 cmdlet 修改的可用性数据库的路径。 如果未指定此参数,则此 cmdlet 将使用当前工作位置。

类型:String
Position:2
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Script

指示此 cmdlet 返回执行此 cmdlet 执行的任务的 Transact-SQL 脚本。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 此 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False