Set-AzLoadBalancerRuleConfig

  • Referência
Módulo:
Az.Network

Atualiza uma configuração de regra para um balanceador de carga.

Sintaxe

Set-AzLoadBalancerRuleConfig
   -LoadBalancer <PSLoadBalancer>
   -Name <String>
   [-Protocol <String>]
   [-LoadDistribution <String>]
   [-FrontendPort <Int32>]
   [-BackendPort <Int32>]
   [-IdleTimeoutInMinutes <Int32>]
   [-EnableFloatingIP]
   [-EnableTcpReset]
   [-DisableOutboundSNAT]
   [-FrontendIpConfiguration <PSFrontendIPConfiguration>]
   [-BackendAddressPool <PSBackendAddressPool[]>]
   [-Probe <PSProbe>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzLoadBalancerRuleConfig
   -LoadBalancer <PSLoadBalancer>
   -Name <String>
   [-Protocol <String>]
   [-LoadDistribution <String>]
   [-FrontendPort <Int32>]
   [-BackendPort <Int32>]
   [-IdleTimeoutInMinutes <Int32>]
   [-EnableFloatingIP]
   [-EnableTcpReset]
   [-DisableOutboundSNAT]
   [-FrontendIpConfigurationId <String>]
   [-BackendAddressPoolId <String[]>]
   [-ProbeId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-AzLoadBalancerRuleConfig atualiza uma configuração de regra para um balanceador de carga.

Exemplos

Exemplo 1: Modificar uma configuração de regra de balanceamento de carga

$slb = Get-AzLoadBalancer -Name "MyLoadBalancer" -ResourceGroupName "MyResourceGroup"
$slb | Add-AzLoadBalancerRuleConfig -Name "NewRule" -FrontendIPConfiguration $slb.FrontendIpConfigurations[0] -Protocol "Tcp" -FrontendPort 3350 -BackendPort 3350 -EnableFloatingIP
$slb | Set-AzLoadBalancerRuleConfig -Name "NewRule" -FrontendIPConfiguration $slb.FrontendIpConfigurations[0] -Protocol "Tcp" -FrontendPort 3350 -BackendPort 3350
$slb | Set-AzLoadBalancer

Exemplo 2: Modificar uma configuração de regra de balanceamento de carga para ter dois pools de endereços de back-end

$slb = Get-AzLoadBalancer -Name "MyLoadBalancer" -ResourceGroupName "MyResourceGroup"
$MyBackendPool1 = Get-AzLoadBalancerBackendAddressPool -ResourceGroupName $resourceGroup -LoadBalancerName $MyLoadBalancer -Name $backendPool1Name
$MyBackendPool2 = Get-AzLoadBalancerBackendAddressPool -ResourceGroupName $resourceGroup -LoadBalancerName $MyLoadBalancer -Name $backendPool2Name
$slb | Set-AzLoadBalancerRuleConfig -Name "NewRule" -FrontendIPConfiguration $slb.FrontendIpConfigurations[0] -Protocol "All" -FrontendPort 0 -BackendPort 0 -BackendAddressPool $MyBackendPool1, $MyBackendPool2
$slb | Set-AzLoadBalancer

O primeiro comando obtém o balanceador de carga chamado MyLoadBalancer e, em seguida, armazena-o na variável $slb. O segundo comando usa o operador de pipeline para passar o balanceador de carga em $slb para Add-AzLoadBalancerRuleConfig, que adiciona uma regra chamada NewRule a ele. O terceiro comando passa o balanceador de carga para Set-AzLoadBalancerRuleConfig, que define a nova configuração da regra. Observe que a configuração não habilita um endereço IP flutuante, que havia sido habilitado pelo comando anterior.

Parâmetros

-BackendAddressPool

Especifica um objeto BackendAddressPool a ser associado a uma regra de balanceador de carga.

Tipo:PSBackendAddressPool[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-BackendAddressPoolId

Especifica a ID de um objeto BackendAddressPool a ser associado a uma configuração de regra de balanceador de carga.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-BackendPort

Especifica a porta de back-end para o tráfego que é correspondido por essa configuração de regra.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DisableOutboundSNAT

Configura o SNAT para que as VMs no pool de back-end usem o endereço IP público especificado no frontend da regra de balanceamento de carga.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EnableFloatingIP

Indica que esse cmdlet habilita um endereço IP flutuante para uma configuração de regra.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EnableTcpReset

Receba TCP Reset bidirecional no tempo limite de inatividade do fluxo TCP ou no encerramento inesperado da conexão. Este elemento só é usado quando o protocolo é definido como TCP.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-FrontendIpConfiguration

Especifica uma lista de endereços IP front-end a serem associados a uma configuração de regra de balanceador de carga.

Tipo:PSFrontendIPConfiguration
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-FrontendIpConfigurationId

Especifica o ID para uma configuração de endereço IP front-end.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-FrontendPort

Especifica a porta front-end que é correspondida por uma configuração de regra de balanceador de carga.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-IdleTimeoutInMinutes

Especifica o período de tempo, em minutos, durante o qual o estado das conversas é mantido em um balanceador de carga.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-LoadBalancer

Especifica um balanceador de carga. Este cmdlet atualiza uma configuração de regra para o balanceador de carga especificado por esse parâmetro.

Tipo:PSLoadBalancer
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-LoadDistribution

Especifica uma distribuição de carga. Os valores aceitáveis para este parâmetro são: SourceIP e SourceIPProtocol.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

Especifica o nome de um balanceador de carga.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Probe

Especifica um teste a ser associado a uma configuração de regra de balanceador de carga.

Tipo:PSProbe
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ProbeId

Especifica a ID da sonda a ser associada a uma configuração de regra de balanceador de carga.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Protocol

Especifica o protocolo que é correspondido por uma regra de balanceador de carga. Os valores aceitáveis para este parâmetro são: Tcp ou Udp.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

PSLoadBalancer

String

Int32

PSFrontendIPConfiguration

PSBackendAddressPool

PSProbe

Saídas

PSLoadBalancer