New-SqlAvailabilityGroupListener
创建可用性组侦听器并将其附加到可用性组。
语法
ByPath （默认值）
New-SqlAvailabilityGroupListener
[-Name] <String>
[[-Path] <String>]
[-DhcpSubnet <String>]
[-StaticIp <String[]>]
[-Port <Int32>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
New-SqlAvailabilityGroupListener
[-Name] <String>
[-InputObject] <AvailabilityGroup>
[-DhcpSubnet <String>]
[-StaticIp <String[]>]
[-Port <Int32>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
New-SqlAvailabilityGroupListener cmdlet 创建可用性组侦听器，并将其附加到可用性组。 在承载主副本的服务器实例上运行此 cmdlet。
示例
示例 1：为可用性组创建侦听器
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"
此命令为名为 MainAG 的可用性组创建名为 MainListener 的可用性组侦听器。 此侦听器使用 DHCP 获取虚拟 IP 地址。 在承载主副本的服务器实例上运行此命令。
示例 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 |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DhcpSubnet
指定网络的 IPv4 地址和子网掩码。 侦听器使用 DHCP 确定此网络上的地址。 使用以下格式指定地址：192.168.0.1\255.255.255.0。
如果指定此参数，请不要指定 StaticIp 参数。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-InputObject
将可用性组指定为 AvailabilityGroup 对象，此 cmdlet 将侦听器附加到该对象。
参数属性
| 类型: | AvailabilityGroup |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ByObject
| Position: | 3 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
指定侦听器的名称。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 2 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Path
指定此 cmdlet 附加到侦听器的可用性组的路径。 如果未指定此参数，此 cmdlet 将使用当前工作位置。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ByPath
| Position: | 3 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Port
指定侦听器侦听连接的端口。 默认端口为 TCP 端口 1433。
参数属性
| 类型: | Int32 |
| 默认值: | 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 |
-StaticIp
指定地址数组。 每个地址条目都是 IPv4 地址和子网掩码或 IPv6 地址。 侦听器侦听此参数指定的地址。
如果指定此参数，请不要指定 DhcpSubnet 参数。
参数属性
| 类型: | String[] |
| 默认值: | 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。