New-SqlAvailabilityReplica

模块:: SQLPS Module

创建可用性副本。

语法

ByPath （默认值）

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

AsTemplate

New-SqlAvailabilityReplica
    [-Name] <String>
    -AvailabilityMode <AvailabilityReplicaAvailabilityMode>
    -FailoverMode <AvailabilityReplicaFailoverMode>
    -EndpointUrl <String>
    [-SessionTimeout <Int32>]
    [-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
    [-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
    [-BackupPriority <Int32>]
    [-ReadOnlyRoutingList <String[]>]
    [-ReadonlyRoutingConnectionUrl <String>]
    [-AsTemplate]
    [-Version <ServerVersion>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject

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

说明

New-SqlAvailabilityReplica cmdlet 创建可用性副本。在托管主副本的 SQL Server 实例上运行此 cmdlet。

若要在创建可用性组之前创建可用性副本，请指定 AsTemplate 参数。若要将副本添加到现有可用性组， InputObject 或 Path 参数指定可用性组。

示例

示例 1：创建可用性副本的表示形式

PS C:\> $ServerObject = Get-Item "SQLSERVER:\Sql\PrimaryServer\InstanceName"
PS C:\> New-SqlAvailabilityReplica -Name "PrimaryServer\Instance" -EndpointUrl "TCP://PrimaryServerName.domain.com:5022" -FailoverMode Automatic -AvailabilityMode SynchronousCommit -AsTemplate -Version $ServerObject.Version

此示例创建可用性副本的内存中表示形式。不会向服务器提交任何更改。可以将此副本用作 New-SqlAvailabilityGroup的 AvailabilityReplica 参数的值

第一个命令获取主服务器的实例。

第二个命令创建可用性副本。此副本使用位于指定 URL 的数据库镜像终结点来与可用性组中的其他副本通信。此副本支持自动故障转移和同步提交可用性模式。 Version 参数指定将承载此新副本的服务器实例的版本。

示例 2：创建支持手动故障转移和异步提交的可用性副本

PS C:\> $ServerObject = Get-Item "SQLSERVER:\Sql\PrimaryServer\InstanceName"
PS C:\> New-SqlAvailabilityReplica -Name "SecondaryServer\Instance" -EndpointUrl "TCP://PrimaryServerName.domain.com:5022" -FailoverMode Manual -AvailabilityMode AsynchronousCommit -AsTemplate -Version $ServerObject.Version

此示例创建可用性副本的内存中表示形式。不会向服务器提交任何更改。

第一个命令获取主服务器的实例。

第二个命令创建可用性副本。此副本使用位于指定 URL 的数据库镜像终结点来与可用性组中的其他副本通信。此副本支持手动故障转移和异步提交可用性模式。 Version 参数指定将承载此新副本的服务器实例的版本。

示例 3：将可用性副本添加到可用性组

PS C:\> New-SqlAvailabilityReplica -Name "SecondaryServer\Instance" -EndpointUrl "TCP://PrimaryServerName.domain.com:5022" -FailoverMode Manual -AvailabilityMode AsynchronousCommit -ConnectionModeInSecondaryRole AllowAllConnections -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"

此命令将可用性副本添加到名为 MainAG 的现有可用性组。此副本支持手动故障转移和异步提交可用性模式。在辅助角色中，此副本支持读取访问连接。此配置允许将只读处理卸载到此副本。

参数

-AsTemplate

指示此 cmdlet 在内存中创建临时 AvailabilityReplica 对象。在创建可用性副本之前，请指定此参数以创建可用性组。使用 New-SqlAvailabilityGroup cmdlet 创建可用性组。将临时可用性副本指定为 AvailabilityReplica 参数的值。

如果指定 AsTemplate，则此 cmdlet 将忽略 InputObject 和 Path 参数的值。

如果指定此参数，还必须为 Version 参数指定 SQL Server 版本，或者当前会话必须与实例建立活动连接。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

AsTemplate

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AvailabilityMode

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

SyncCommit
AsynchronousCommit

可以指定一个值$Null。

参数属性

类型:	AvailabilityReplicaAvailabilityMode
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-BackupPriority

指定执行备份中副本的所需优先级。此参数的可接受值为：从 0 到 100 的整数。在联机和可用的副本集中，具有最高优先级的副本执行备份。

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

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

参数属性

类型:	SwitchParameter
默认值:	False
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ConnectionModeInPrimaryRole

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

AllowReadWriteConnections。允许读/写连接
AllowAllConnections。允许所有连接

参数属性

类型:	AvailabilityReplicaConnectionModeInPrimaryRole
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ConnectionModeInSecondaryRole

指定在辅助角色中时可用性副本如何处理连接。此参数的可接受值为：

AllowNoConnections。禁止连接
AllowReadIntentConnectionsOnly。仅允许读取意向连接
AllowAllConnections。允许所有连接

参数属性

类型:	AvailabilityReplicaConnectionModeInSecondaryRole
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EndpointUrl

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

TCP：//system-address：port

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-FailoverMode

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

自动
手动指定$Null值。

参数属性

类型:	AvailabilityReplicaFailoverMode
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-InputObject

将可用性组指定为 副本所属的可用性组 对象。

参数属性

类型:	AvailabilityGroup
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByObject

Position:	3
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Name

使用以下格式指定可用性副本的名称：

Computer\Instance

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	2
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Path

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByPath

Position:	3
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ReadonlyRoutingConnectionUrl

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

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ReadOnlyRoutingList

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

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Script

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SessionTimeout

指定在连接失败之前，在主副本与此副本之间等待响应的时间（以秒为单位）。

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Version

指定 SQL Server 版本。如果指定 AsTemplate 参数，则必须指定版本。模板对象是在包含此版本的服务器上的设计模式下创建的。可以指定整数或字符串，如以下示例所示：

13
"13.0.0"

参数属性

类型:	ServerVersion
默认值:	None
支持通配符:	False
不显示:	False

参数集

AsTemplate

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。

通过

New-SqlAvailabilityReplica

语法

ByPath （默认值）

AsTemplate

ByObject

说明

示例

示例 1：创建可用性副本的表示形式

示例 2：创建支持手动故障转移和异步提交的可用性副本

示例 3：将可用性副本添加到可用性组

参数

-AsTemplate

参数属性

参数集

-AvailabilityMode

参数属性

参数集

-BackupPriority

参数属性

参数集

-Confirm

参数属性

参数集

-ConnectionModeInPrimaryRole

参数属性

参数集

-ConnectionModeInSecondaryRole

参数属性

参数集

-EndpointUrl

参数属性

参数集

-FailoverMode

参数属性

参数集

-InputObject

参数属性

参数集

-Name

参数属性

参数集

-Path

参数属性

参数集

-ReadonlyRoutingConnectionUrl

参数属性

参数集

-ReadOnlyRoutingList

参数属性

参数集

-Script

参数属性

参数集

-SessionTimeout

参数属性

参数集

-Version

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

输出

Microsoft.SqlServer.Management.Smo.AvailabilityReplica

相关链接

反馈