New-SqlAvailabilityGroupListener

模块:

SQLPS

创建可用性组侦听器并将其附加到可用性组。

语法

New-SqlAvailabilityGroupListener
   [-DhcpSubnet <String>]
   [-StaticIp <String[]>]
   [-Port <Int32>]
   [-Name] <String>
   [[-Path] <String>]
   [-Script]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-SqlAvailabilityGroupListener
   [-DhcpSubnet <String>]
   [-StaticIp <String[]>]
   [-Port <Int32>]
   [-Name] <String>
   [-InputObject] <AvailabilityGroup>
   [-Script]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-SqlAvailabilityGroupListener cmdlet 创建可用性组侦听器，并将其附加到可用性组。 在承载主副本 (replica) 的服务器实例上运行此 cmdlet。

示例

示例 1：为可用性组创建侦听器

PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"

此命令为名为 MainAG 的可用性组创建名为 MainListener 的可用性组侦听器。 此侦听器使用 DHCP 获取虚拟 IP 地址。 在承载主副本 (replica) 的服务器实例上运行此命令。

示例 2：为具有非默认端口的可用性组创建侦听器

PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -Port 1434

此命令为名为 MainAG 的可用性组创建名为 MainListener 的可用性组侦听器。 如上一示例中所示，此侦听器使用 DHCP 获取虚拟 IP 地址。 此示例分配它侦听的端口 1434。

示例 3：为使用 DHCP 的可用性组创建侦听器

PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -DhcpSubnet "192.169.0.1/255.255.252.0" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"

此命令为名为 MainAG 的可用性组创建名为 MainListener 的可用性组侦听器。 此侦听器使用 DHCP 获取指定子网中的虚拟 IP 地址。

示例 4：为使用静态地址的可用性组创建侦听器

PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -StaticIp "192.168.3.1/255.255.252.0" -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG"

此命令为名为 MainAG 的可用性组创建名为 MainListener 的可用性组侦听器。 此侦听器使用 StaticIp 参数指定的 IPv4 地址作为其虚拟 IP 地址。

示例 5：创建用于创建侦听器的脚本

PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG" -Script

此命令创建一个 Transact-SQL 脚本，该脚本为名为 MainAG 的可用性组创建名为 MainListener 的可用性组侦听器。 命令不会创建侦听器。

参数

-Confirm

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

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

-DhcpSubnet

指定网络的 IPv4 地址和子网掩码。 侦听器使用 DHCP 确定此网络上的地址。 使用以下格式指定 中的地址：192.168.0.1\255.255.255.0。

如果指定此参数，请不要指定 StaticIp 参数。

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

-InputObject

将此 cmdlet 附加到侦听器的可用性组指定为 AvailabilityGroup 对象。

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

-Name

指定侦听器的名称。

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

-Path

指定此 cmdlet 将侦听器附加到的可用性组的路径。 如果未指定此参数，则此 cmdlet 将使用当前工作位置。

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

-Port

指定侦听器侦听连接的端口。 默认端口为 TCP 端口 1433。

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

-Script

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

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

-StaticIp

指定地址数组。 每个地址条目都是 IPv4 地址和子网掩码或 IPv6 地址。 侦听器侦听此参数指定的地址。

如果指定此参数，请不要指定 DhcpSubnet 参数。

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

-WhatIf

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

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

输入

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

相关链接

• Add-SqlAvailabilityGroupListenerStaticIp
• Set-SqlAvailabilityGroupListener