Compartilhar via


Set-SqlAvailabilityGroupListener

Define a configuração de porta em um ouvinte de grupo de disponibilidade.

Sintaxe

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

Description

O cmdlet Set-SqlAvailabilityGroupListener modifica a configuração de porta em um ouvinte de grupo de disponibilidade existente. Execute esse cmdlet na instância do servidor que hospeda o réplica primário.

Exemplos

Exemplo 1: Modificar um ouvinte para um grupo de disponibilidade

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

Esse comando define o número da porta para o ouvinte do grupo de disponibilidade chamado MainListener como 1535. Esta porta é usada para ouvir conexões para o ouvinte.

Exemplo 2: Criar um script que modifique um ouvinte

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

Esse comando gera o script Transact-SQL que define o número da porta para o ouvinte do grupo de disponibilidade chamado MainListener como 1535. Esse comando não faz essa alteração.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica o ouvinte, como um objeto AvailabilityGroupListener , que esse cmdlet modifica.

Tipo:AvailabilityGroupListener
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Path

Especifica o caminho do ouvinte do grupo de disponibilidade que este cmdlet modifica. Se você não especificar esse parâmetro, esse cmdlet usará o local de trabalho atual.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Port

Especifica a porta na qual o ouvinte escuta conexões. A porta padrão é TCP 1433.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Script

Indica que esse cmdlet retorna um script Transact-SQL que executa a tarefa que esse cmdlet executa.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.SqlServer.Management.Smo.AvailabilityGroupListener