Compartilhar via


Add-SqlAvailabilityGroupListenerStaticIp

Adiciona um endereço IP estático a um ouvinte de grupo de disponibilidade.

Sintaxe

ByPath (Padrão)

Add-SqlAvailabilityGroupListenerStaticIp
    [[-Path] <String[]>]
    -StaticIp <String[]>
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject

Add-SqlAvailabilityGroupListenerStaticIp
    [-InputObject] <AvailabilityGroupListener[]>
    -StaticIp <String[]>
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Add-SqlAvailabilityGroupListenerStaticIp adiciona um endereço IP estático a uma configuração de ouvinte de grupo de disponibilidade existente. Você pode especificar um endereço IPv4 e uma máscara de sub-rede ou um endereço IPv6 Executar este cmdlet na instância do servidor que hospeda a réplica primária.

Exemplos

Exemplo 1: Adicionar um endereço IPv4

PS C:\> Add-SqlAvailabilityGroupListenerStaticIp -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityGroupListeners\MainListener" -StaticIp "192.169.0.1/255.255.252.0"

Esse comando adiciona um endereço IPv4 estático ao ouvinte do grupo de disponibilidade MainListener no grupo de disponibilidade chamado MainAG. Esse endereço IPv4 serve como o endereço IP virtual do ouvinte na sub-rede 255.255.252.0. Se o grupo de disponibilidade abranger várias sub-redes, adicione um endereço IP estático para cada sub-rede ao ouvinte. Execute este cmdlet na instância do servidor que hospeda a réplica primária.

Exemplo 2: Adicionar um endereço IPv6

PS C:\> Add-SqlAvailabilityGroupListenerStaticIp -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityGroupListeners\MainListener" -StaticIp "2001:0db8:85a3:0000:0000:8a2e:0370:7334"

Esse comando adiciona um endereço IPv6 estático ao ouvinte MainListener no grupo de disponibilidade MainAG.

Exemplo 3: criar um script que adiciona um endereço IPv4

PS C:\> Add-SqlAvailabilityGroupListenerStaticIp -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAg\AvailabilityGroupListeners\MainListener" -StaticIp "192.168.0.1/255.255.255.0" -Script

Isso cria um script Transact-SQL que adiciona um endereço IPv4 estático ao ouvinte do grupo de disponibilidade MainListener no grupo de disponibilidade chamado 'MainAG'.

Parâmetros

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InputObject

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

Propriedades do parâmetro

Tipo:

AvailabilityGroupListener[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByObject
Cargo:2
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Path

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByPath
Cargo:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Script

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StaticIp

Especifica uma matriz de endereços. Cada entrada de endereço é um endereço IPv4 e uma máscara de sub-rede ou um endereço IPv6. O ouvinte escuta nos endereços especificados por esse parâmetro.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

Microsoft.SqlServer.Management.Smo.AvailabilityGroupListener