Partager via

Set-AzureRmLoadBalancerRuleConfig

  • Référence
Module:
AzureRM.Network

Définit l’état d’objectif d’une configuration de règle d’équilibreur de charge.

Avertissement

Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

Set-AzureRmLoadBalancerRuleConfig
   -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-AzureRmLoadBalancerRuleConfig
   -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-AzureRmLoadBalancerRuleConfig définit l’état d’objectif d’une configuration de règle d’équilibreur de charge.

Exemples

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

PS C:\>$slb = Get-AzureRmLoadBalancer -Name "MyLoadBalancer" -ResourceGroupName "MyResourceGroup"
PS C:\> $slb | Add-AzureRmLoadBalancerRuleConfig -Name "NewRule" -FrontendIPConfiguration $slb.FrontendIpConfigurations[0] -Protocol "Tcp" -FrontendPort 3350 -BackendPort 3350 -EnableFloatingIP
PS C:\> $slb | Set-AzureRmLoadBalancerRuleConfig -Name "NewRule" -FrontendIPConfiguration $slb.FrontendIpConfigurations[0] -Protocol "Tcp" -FrontendPort 3350 -BackendPort 3350

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-AzureRmLoadBalancerRuleConfig, qui ajoute une règle nommée NewRule à celle-ci. La troisième commande transmet l’équilibreur de charge à Set-AzureRmLoadBalancerRuleConfig, 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: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 définit la configuration de la règle d’état d’objectif 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

Paramètres : LoadBalancer (ByValue)

Sorties

PSLoadBalancer