Partager via

Set-AzLoadBalancerRuleConfig

  • Référence
Module:
Az.Network

Met à jour une configuration de règle pour un équilibreur de charge.

Syntaxe

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

L’applet de commande Set-AzLoadBalancerRuleConfig met à jour une configuration de règle pour un équilibreur de charge.

Exemples

Exemple 1 : Modifier une configuration de règle d’équilibrage de charge

$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

Exemple 2 : Modifier une configuration de règle d’équilibrage de charge pour avoir deux pools d’adresses 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

La première commande obtient l’équilibreur de charge nommé MyLoadBalancer, puis le stocke dans la variable $slb. La deuxième commande utilise l’opérateur de pipeline pour passer l’équilibreur de charge dans $slb à Add-AzLoadBalancerRuleConfig, qui ajoute une règle nommée NewRule à celle-ci. La troisième commande transmet l’équilibreur de charge à Set-AzLoadBalancerRuleConfig, qui définit la nouvelle configuration de règle. Notez que la configuration n’active pas une adresse IP flottante, qui a été activée par la commande précédente.

Paramètres

-BackendAddressPool

Spécifie un objet BackendAddressPool à associer à une règle d’équilibreur de charge.

Type:PSBackendAddressPool[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-BackendAddressPoolId

Spécifie l’ID d’un objet BackendAddressPool à associer à une configuration de règle d’équilibreur de charge.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-BackendPort

Spécifie le port principal du trafic mis en correspondance par cette configuration de règle.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableOutboundSNAT

Configure SNAT pour les machines virtuelles du pool principal afin d’utiliser l’adresse publicIP spécifiée dans le serveur frontal de la règle d’équilibrage de charge.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableFloatingIP

Indique que cette applet de commande active une adresse IP flottante pour une configuration de règle.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableTcpReset

Recevez la réinitialisation TCP bidirectionnelle sur le délai d’inactivité du flux TCP ou l’arrêt de connexion inattendu. Cet élément est utilisé uniquement lorsque le protocole est défini sur TCP.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FrontendIpConfiguration

Spécifie une liste d’adresses IP frontales à associer à une configuration de règle d’équilibreur de charge.

Type:PSFrontendIPConfiguration
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-FrontendIpConfigurationId

Spécifie l’ID d’une configuration d’adresse IP frontale.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-FrontendPort

Spécifie le port frontal mis en correspondance par une configuration de règle d’équilibreur de charge.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-IdleTimeoutInMinutes

Spécifie la durée, en minutes, pendant laquelle l’état des conversations est conservé dans un équilibreur de charge.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LoadBalancer

Spécifie un équilibreur de charge. Cette applet de commande met à jour une configuration de règle pour l’équilibreur de charge spécifié par ce paramètre.

Type:PSLoadBalancer
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LoadDistribution

Spécifie une distribution de charge. Les valeurs acceptables pour ce paramètre sont : SourceIP et SourceIPProtocol.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie le nom d’un équilibreur de charge.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Probe

Spécifie une sonde à associer à une configuration de règle d’équilibreur de charge.

Type:PSProbe
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ProbeId

Spécifie l’ID de la sonde à associer à une configuration de règle d’équilibreur de charge.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Protocol

Spécifie le protocole mis en correspondance par une règle d’équilibreur de charge. Les valeurs acceptables pour ce paramètre sont : Tcp ou Udp.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

PSLoadBalancer

String

Int32

PSFrontendIPConfiguration

PSBackendAddressPool

PSProbe

Sorties

PSLoadBalancer