Partilhar via


Set-AzLoadBalancerRuleConfig

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

Sintaxe

SetByResource (Predefinição)

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

SetByResourceId

Set-AzLoadBalancerRuleConfig
    -LoadBalancer <PSLoadBalancer>
    -Name <String>
    [-Protocol <String>]
    [-LoadDistribution <String>]
    [-FrontendPort <Int32>]
    [-BackendPort <Int32>]
    [-IdleTimeoutInMinutes <Int32>]
    [-EnableFloatingIP]
    [-EnableTcpReset]
    [-DisableOutboundSNAT]
    [-EnableConnectionTracking]
    [-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.

Propriedades dos parâmetros

Tipo:

PSBackendAddressPool[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResource
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-BackendAddressPoolId

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResourceId
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-BackendPort

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

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-EnableConnectionTracking

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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-EnableFloatingIP

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-FrontendIpConfiguration

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

Propriedades dos parâmetros

Tipo:PSFrontendIPConfiguration
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResource
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-FrontendIpConfigurationId

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResourceId
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-FrontendPort

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

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-IdleTimeoutInMinutes

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

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:PSLoadBalancer
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-LoadDistribution

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Name

Especifica o nome de um balanceador de carga.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Probe

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

Propriedades dos parâmetros

Tipo:PSProbe
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResource
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ProbeId

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResourceId
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

PSLoadBalancer

String

Int32

PSFrontendIPConfiguration

PSBackendAddressPool

PSProbe

Saídas

PSLoadBalancer