通过

Set-SqlAvailabilityReplica

  • 参考
模块:
SQLPS

设置可用性副本 (replica) 的设置。

语法

Set-SqlAvailabilityReplica
   [-AvailabilityMode <AvailabilityReplicaAvailabilityMode>]
   [-FailoverMode <AvailabilityReplicaFailoverMode>]
   [-EndpointUrl <String>]
   [-SessionTimeout <Int32>]
   [-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
   [-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
   [-BackupPriority <Int32>]
   [-ReadOnlyRoutingList <String[]>]
   [-ReadonlyRoutingConnectionUrl <String>]
   [[-Path] <String>]
   [-Script]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SqlAvailabilityReplica
   [-AvailabilityMode <AvailabilityReplicaAvailabilityMode>]
   [-FailoverMode <AvailabilityReplicaFailoverMode>]
   [-EndpointUrl <String>]
   [-SessionTimeout <Int32>]
   [-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
   [-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
   [-BackupPriority <Int32>]
   [-ReadOnlyRoutingList <String[]>]
   [-ReadonlyRoutingConnectionUrl <String>]
   [-InputObject] <AvailabilityReplica>
   [-Script]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-SqlAvailabilityReplica cmdlet 设置或修改可用性副本 (replica) 的各种属性。 在承载主副本 (replica) 的服务器实例上运行此 cmdlet。

示例

示例 1：修改副本 (replica) 可用性模式和自动故障转移

PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode "SynchronousCommit" -FailoverMode Automatic -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"

此命令修改名为 MainAG 的可用性组中名为 Replica02 的副本 (replica) ，以使用同步提交可用性模式并支持自动故障转移。

示例 2：修改副本 (replica) 以支持强制手动故障转移

PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode AsynchronousCommit -FailoverMode Manual -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"

此命令修改名为 MainAG 的可用性组中名为 Replica02 的副本 (replica) ，以使用异步提交可用性模式并仅支持可能导致数据丢失的强制手动故障转移。

示例 3：允许辅助角色中的所有连接

PS C:\> Set-SqlAvailabilityReplica -ConnectionModeInSecondaryRole AllowAllConnections -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"

此命令修改可用性组 MainAG 中的副本 (replica) “Replica02”，以允许辅助角色中的所有连接。 这使你可以将只读数据处理工作负载卸载到次要副本。

示例 4：为只读路由配置主副本 (replica) 和辅助副本 (replica) 

PS C:\> Set-Location "SQLSERVER:\SQL\PrimaryServer\default\AvailabilityGroups\MainAG"
C:\PS> $PrimaryReplica = Get-Item "AvailabilityReplicas\PrimaryServer"
C:\PS> $SecondaryReplica = Get-Item "AvailabilityReplicas\SecondaryServer"
C:\PS> Set-SqlAvailabilityReplica -ReadOnlyRoutingConnectionUrl "TCP://PrimaryServer.domain.com:5022" -InputObject $PrimaryReplica
C:\PS> Set-SqlAvailabilityReplica -ReadOnlyRoutingConnectionUrl "TCP://SecondaryServer.domain.com:5022" -InputObject $SecondaryReplica
C:\PS> Set-SqlAvailabilityReplica -ReadOnlyRoutingList "SecondaryServer","PrimaryServer" -InputObject $PrimaryReplica

第一个命令将位置更改为 SQLSERVER： 提供程序中的位置。

第二个命令获取主服务器的副本 (replica) ，然后将其存储在 $PrimaryReplica 变量中。

第三个命令获取辅助服务器的副本 (replica) ，然后将其存储在 $SecondaryReplica 变量中。

第四个命令将只读路由 URL 分配给主副本 (replica) 。 然后，在主副本上设置只读路由列表。

第五个命令将只读路由 URL 分配给辅助副本 (replica) 。

第六个命令设置主副本 (replica) 上的只读路由列表。 具有 ReadOnly 属性连接字符串Connections将重定向到辅助副本 (replica) 。 如果辅助副本 (replica) 不可读，则连接将定向回主副本 (replica) 。

示例 5：修改备份优先级

PS C:\> Set-SqlAvailabilityReplica -BackupPriority 60 -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"

此命令将可用性副本 (replica) “Replica02”的备份优先级设置为 60。 托管主副本 (replica) 的服务器实例使用此优先级来决定哪个副本 (replica) 应为可用性组中数据库上的自动备份请求提供服务。 选择优先级最高的副本 (replica) 。

参数

-AvailabilityMode

指定副本 (replica) 可用性模式。 此参数的可接受值为：

  • SynchronousCommit
  • AsynchronousCommit

可以将值指定为 $Null。

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

-BackupPriority

指定执行备份时副本的所需优先级。 此参数的可接受值为：0 到 100 的整数。 在联机且可用的一组副本中，具有最高优先级的副本 (replica) 执行备份。

值为 0 (0) 表示副本 (replica) 不是候选项。

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

-Confirm

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

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

-ConnectionModeInPrimaryRole

指定可用性副本 (replica) 在担任主要角色时如何处理连接。 此参数的可接受值为：

  • AllowReadWriteConnections。 允许读/写连接。
  • AllowAllConnections。 允许所有连接。
类型:AvailabilityReplicaConnectionModeInPrimaryRole
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ConnectionModeInSecondaryRole

指定可用性副本 (replica) 在辅助角色中处理连接的方式。 此参数的可接受值为：

  • AllowNoConnections。 禁止连接。
  • AllowReadIntentConnectionsOnly。 仅允许读取意向连接。
  • AllowAllConnections。 允许所有连接。
类型:AvailabilityReplicaConnectionModeInSecondaryRole
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EndpointUrl

指定数据库镜像终结点的 URL。 此 URL 是采用以下格式的 TCP 地址：

TCP：//system-address：port

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

-FailoverMode

指定故障转移模式。 此参数的可接受值为：

  • 自动
  • 手动。 可以将值指定为 $Null。
类型:AvailabilityReplicaFailoverMode
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

将可用性组指定为可用性组对象，副本 (replica) 所属。

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

-Path

指定副本 (replica) 所属的可用性组的路径。 如果未指定此参数，则此 cmdlet 将使用当前工作位置。

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

-ReadonlyRoutingConnectionUrl

指定在路由到只读连接副本 (replica) 时要使用的完全限定域名 (FQDN) 和端口，如以下示例所示：

TCP://DBSERVER8.manufacturing.Contoso.com:7024

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

-ReadOnlyRoutingList

指定副本 (replica) 服务器名称的有序列表，这些名称表示连接控制器在通过此可用性副本 (replica) 重定向只读连接时要使用的探测序列。 如果可用性副本 (replica) 是可用性组的当前主副本 (replica) ，则此参数适用。

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

-Script

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

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

-SessionTimeout

指定在主副本 (replica) 和此副本 (replica) 之间等待响应的时间（以秒为单位），然后连接失败。

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

-WhatIf

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

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

输入

Microsoft.SqlServer.Management.Smo.AvailabilityReplica