Compartilhar via

New-AzAvailabilityGroupListener

  • Referência
Módulo:
Az.SqlVirtualMachine

Cria ou atualiza um ouvinte de grupo de disponibilidade.

Sintaxe

New-AzAvailabilityGroupListener
   -Name <String>
   -ResourceGroupName <String>
   -SqlVMGroupName <String>
   [-SubscriptionId <String>]
   [-AvailabilityGroupConfigurationReplica <IAgReplica[]>]
   [-AvailabilityGroupName <String>]
   [-CreateDefaultAvailabilityGroupIfNotExist]
   [-IpAddress <String>]
   [-LoadBalancerResourceId <String>]
   [-ProbePort <Int32>]
   [-PublicIpAddressResourceId <String>]
   [-SqlVirtualMachineId <String[]>]
   [-SubnetId <String>]
   [-MultiSubnetIPConfiguration <IMultiSubnetIPConfiguration[]>]
   [-Port <Int32>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cria ou atualiza um ouvinte de grupo de disponibilidade.

Exemplos

Exemplo 1

New-AzAvailabilityGroupListener -ResourceGroupName 'ResourceGroup01' -SqlVMGroupName 'sqlvmgroup01' -Name 'AgListener01' -AvailabilityGroupName 'AG01' -IpAddress '192.168.16.7' -LoadBalancerResourceId $LoadBalancerResourceId -SubnetId $SubnetResourceId -ProbePort 9999 -SqlVirtualMachineId $sqlvmResourceId1,$sqlvmResourceId2

Name         ResourceGroupName
----         -----------------
AgListener01 ResourceGroup01

Crie um novo ouvinte de grupo de disponibilidade "AgListener01" com a Configuração do Load Balancer para o Grupo de Disponibilidade "AG01" no Grupo de Máquinas Virtuais do SQL "sqlvmgroup01".

Exemplo 2

$msconfig1 = New-AzSqlVirtualMachineMultiSubnetIPConfigurationObject -PrivateIPAddressSubnetResourceId $SubnetResourceId1 -PrivateIPAddressIpaddress '192.168.16.9' -SqlVirtualMachineInstance $sqlvmResourceId1
$msconfig2 = New-AzSqlVirtualMachineMultiSubnetIPConfigurationObject -PrivateIPAddressSubnetResourceId $SubnetResourceId2 -PrivateIPAddressIpaddress '192.168.17.9' -SqlVirtualMachineInstance $sqlvmResourceId2

New-AzAvailabilityGroupListener -Name 'AgListener02' -ResourceGroupName 'ResourceGroup01' -SqlVMGroupName 'sqlvmgroup01' -AvailabilityGroupName 'AG02' -MultiSubnetIPConfiguration $msconfig1,$msconfig2

Name         ResourceGroupName
----         -----------------
AgListener02 ResourceGroup01

Crie um novo ouvinte de grupo de disponibilidade "AgListener02" com configuração de várias sub-redes para o grupo de disponibilidade "AG02" no Grupo de Máquinas Virtuais do SQL "sqlvmgroup01".

Parâmetros

-AsJob

Executar o comando como um trabalho

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

-AvailabilityGroupConfigurationReplica

Configurações de réplica. Para construir, consulte a seção NOTES para propriedades AVAILABILITYGROUPCONFIGURATIONREPLICA e crie uma tabela de hash.

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

-AvailabilityGroupName

Nome do grupo de disponibilidade.

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

-Confirm

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

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

-CreateDefaultAvailabilityGroupIfNotExist

Crie um grupo de disponibilidade padrão se ele não existir.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IpAddress

Endereço IP privado associado ao ouvinte do grupo de disponibilidade.

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

-LoadBalancerResourceId

ID do recurso do balanceador de carga.

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

-MultiSubnetIPConfiguration

Lista de configurações de IP de várias sub-redes para um ouvinte de AG. Para construir, consulte a seção NOTES para propriedades MULTISUBNETIPCONFIGURATION e crie uma tabela de hash.

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

-Name

Nome do ouvinte do grupo de disponibilidade.

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

-NoWait

Executar o comando de forma assíncrona

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

-Port

Porta do ouvinte.

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

-ProbePort

Porta de investigação.

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

-PublicIpAddressResourceId

ID do recurso do IP público.

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

-ResourceGroupName

Nome do grupo de recursos que contém o recurso. Você pode obter esse valor na API do Azure Resource Manager ou no portal.

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

-SqlVirtualMachineId

Lista das IDs de recurso da instância da máquina virtual do SQL que estão registradas no ouvinte do grupo de disponibilidade.

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

-SqlVMGroupName

Nome do grupo de máquinas virtuais do SQL.

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

-SubnetId

Sub-rede usada para incluir IP privado.

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

-SubscriptionId

ID da assinatura que identifica uma assinatura do Azure.

Tipo:String
Cargo:Named
Valor padrão:(Get-AzContext).Subscription.Id
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:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

IAvailabilityGroupListener