Partager via

Set-AzureLoadBalancedEndpoint

  • Référence
Module:
Azure

Modifie tous les points de terminaison d’un jeu d’équilibreur de charge au sein d’un service Azure.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

Set-AzureLoadBalancedEndpoint
   -LBSetName <String>
   [-Protocol <String>]
   [-LocalPort <Int32>]
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   [-ServiceName] <String>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureLoadBalancedEndpoint
   -LBSetName <String>
   [-Protocol <String>]
   [-LocalPort <Int32>]
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   [-ProbeProtocolTCP]
   [-ProbePort <Int32>]
   [-ProbeIntervalInSeconds <Int32>]
   [-ProbeTimeoutInSeconds <Int32>]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   [-ServiceName] <String>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureLoadBalancedEndpoint
   -LBSetName <String>
   [-Protocol <String>]
   [-LocalPort <Int32>]
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   [-ProbeProtocolHTTP]
   -ProbePath <String>
   [-ProbePort <Int32>]
   [-ProbeIntervalInSeconds <Int32>]
   [-ProbeTimeoutInSeconds <Int32>]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   [-ServiceName] <String>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande Set-AzureLoadBalancedEndpoint modifie tous les points de terminaison d’un jeu d’équilibreur de charge dans un service Azure.

Exemples

Exemple 1 : Modifier les points de terminaison d’un jeu d’équilibreurs de charge

PS C:\> Set-AzureLoadBalancedEndpoint -ServiceName "ContosoService" -LBSetName "LBSet01" -Protocol "TCP" -LocalPort 80 -ProbeProtocolTCP -ProbePort 8080

Cette commande modifie tous les points de terminaison du jeu d’équilibreur de charge nommé LBSet01 pour utiliser le protocole TCP et le port privé 80. La commande définit la sonde d’équilibreur de charge pour utiliser le protocole TCP sur le port 8080.

Exemple 2 : Spécifier une adresse IP virtuelle différente

PS C:\> Set-AzureLoadBalancedEndpoint -ServiceName "ContosoService" -LBSetName "LBSet02" -VirtualIPName "Vip01"

Cette commande modifie l’équilibreur de charge qui a le nom défini par l’équilibreur de charge pour utiliser une adresse IP virtuelle nommée Vip01.

Paramètres

-ACL

Spécifie un objet de configuration de liste de contrôle d’accès (ACL) que cette applet de commande s’applique aux points de terminaison.

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

-DirectServerReturn

Spécifie si cette applet de commande active le retour direct du serveur. Spécifiez $True pour activer ou $False à désactiver.

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

-IdleTimeoutInMinutes

Spécifie le délai d’inactivité TCP, en minutes, pour les points de terminaison.

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

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Demander
  • SilentlyContinue
  • Stop
  • Suspendre
Type:ActionPreference
Alias:infa
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationVariable

Spécifie une variable d’informations.

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

-InternalLoadBalancerName

Spécifie le nom de l’équilibreur de charge interne inclus dans cette applet de commande dans la configuration.

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

-LBSetName

Spécifie le nom du jeu d’équilibreur de charge que cette applet de commande met à jour.

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

-LoadBalancerDistribution

Spécifie l’algorithme de distribution de l’équilibreur de charge. Les valeurs valides sont :

  • sourceIP. Une affinité de deux tuples : adresse IP source, adresse IP de destination
  • sourceIPProtocol. Une affinité de trois tuples : adresse IP source, adresse IP de destination, protocole
  • aucun. Une affinité de cinq tuples : adresse IP source, port source, adresse IP de destination, port de destination, protocole

La valeur par défaut n’est pas.

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

-LocalPort

Spécifie le port local, privé et le port que ces points de terminaison utilisent. Les applications de la machine virtuelle écoutent sur ce port pour les demandes d’entrée de service pour ce point de terminaison.

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

-ProbeIntervalInSeconds

Spécifie l’intervalle d’interrogation de la sonde, en secondes, pour les points de terminaison.

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

-ProbePath

Spécifie le chemin relatif de la sonde HTTP.

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

-ProbePort

Spécifie le port utilisé par la sonde d’équilibreur de charge.

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

-ProbeProtocolHTTP

Spécifie que les points de terminaison de l’équilibreur de charge utilisent une sonde HTTP.

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

-ProbeProtocolTCP

Spécifie que les points de terminaison de l’équilibreur de charge utilisent une sonde TCP.

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

-ProbeTimeoutInSeconds

Spécifie le délai d’interrogation de la sonde en secondes.

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

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

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

-Protocol

Spécifie le protocole des points de terminaison. Les valeurs valides sont :

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

-PublicPort

Spécifie le port public utilisé par le point de terminaison. Si vous ne spécifiez pas de valeur, Azure affecte un port disponible.

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

-ServiceName

Spécifie le nom du service Azure qui contient les points de terminaison modifiés par cette applet de commande.

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

-VirtualIPName

Spécifie le nom d’une adresse IP virtuelle associée par Azure aux points de terminaison. Pour ajouter des adresses IP virtuelles à votre service, utilisez l’applet de commande Add-AzureVirtualIP .

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