Share 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.

Syntax

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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-BackendAddressPoolId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-BackendPort

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableFloatingIP

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FrontendIpConfiguration

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

Type:PSFrontendIPConfiguration
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-FrontendIpConfigurationId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-FrontendPort

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-LoadDistribution

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Probe

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

Type:PSProbe
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProbeId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

PSLoadBalancer

Paramètres : LoadBalancer (ByValue)

Sorties

PSLoadBalancer