Set-SqlAvailabilityGroupListener

Referencia

Módulo:: SQLPS

Establece la configuración de puerto en un agente de escucha de grupo de disponibilidad.

Syntax

Set-SqlAvailabilityGroupListener
   [-Port <Int32>]
   [[-Path] <String>]
   [-Script]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SqlAvailabilityGroupListener
   [-Port <Int32>]
   [-InputObject] <AvailabilityGroupListener>
   [-Script]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-SqlAvailabilityGroupListener modifica la configuración de puerto en un agente de escucha de grupo de disponibilidad existente. Ejecute este cmdlet en la instancia del servidor que hospeda la réplica principal.

Ejemplos

Ejemplo 1: Modificación de un agente de escucha para un grupo de disponibilidad

PS C:\> Set-SqlAvailabilityGroupListener -Port 1535 -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityGroupListeners\MainListener"

Este comando establece que el número de puerto del agente de escucha del grupo de disponibilidad denominado MainListener sea 1535. Este puerto se usa para escuchar las conexiones del agente de escucha.

Ejemplo 2: Creación de un script que modifica un agente de escucha

PS C:\> Set-SqlAvailabilityGroupListener -Port 1535 -Script -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityGroupListeners\MainListener"

Este comando genera el script de Transact-SQL que establece el número de puerto del agente de escucha del grupo de disponibilidad denominado MainListener en 1535. Este comando no realiza ese cambio.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Especifica el agente de escucha, como un objeto AvailabilityGroupListener , que este cmdlet modifica.

Type:	AvailabilityGroupListener
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Path

Especifica la ruta de acceso del agente de escucha del grupo de disponibilidad que modifica este cmdlet. Si no especifica este parámetro, este cmdlet usa la ubicación de trabajo actual.

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Port

Especifica el puerto en el que el agente de escucha escucha las conexiones. El puerto predeterminado es el puerto TCP 1433.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Script

Indica que este cmdlet devuelve un script de Transact-SQL que realiza la tarea que realiza este cmdlet.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

Microsoft.SqlServer.Management.Smo.AvailabilityGroupListener