Partager via

Set-AzureTrafficManagerProfile

  • Référence
Module:
Azure

Met à jour les propriétés d’un profil Traffic Manager.

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-AzureTrafficManagerProfile
   [-Name <String>]
   [-LoadBalancingMethod <String>]
   [-MonitorPort <Int32>]
   [-MonitorProtocol <String>]
   [-MonitorRelativePath <String>]
   [-Ttl <Int32>]
   -TrafficManagerProfile <IProfileWithDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

L’applet de commande Set-AzureTrafficManagerProfile met à jour les propriétés d’un profil Microsoft Azure Traffic Manager.

Pour les profils pour lesquels vous avez défini la valeur LoadBalancingMethod sur « Basculement », vous pouvez déterminer l’ordre de basculement des points de terminaison que vous avez ajoutés à votre profil avec l’applet de commande Add-AzureTrafficManagerEndpoint. Pour plus d’informations, consultez l’exemple 3 ci-dessous.

Exemples

Exemple 1 : Définir la durée de vie d’un profil Traffic Manager

PS C:\>Set-AzureTrafficManagerProfile -TrafficManagerProfile $MyTrafficManagerProfile -Ttl 60

Cette commande définit la durée de vie sur 60 secondes pour l’objet de profil Traffic Manager MyTrafficManagerProfile.

Exemple 2 : Définir plusieurs valeurs pour un profil

PS C:\>Get-AzureTrafficManagerProfile -Name "MyProfile" | Set-AzureTrafficManagerProfile -LoadBalancingMethod "RoundRobin" -Ttl 30 -MonitorProtocol "Http" -MonitorPort 80 -MonitorRelativePath "/"

Cette commande obtient un profil Traffic Manager nommé MyProfile à l’aide de l’applet de commande Get-AzureTrafficManagerProfile . Le profil utilise la méthode d’équilibrage de charge RoundRobin, une durée de vie de 30 secondes, le protocole HTTP du protocole monitor, le port de surveillance et le chemin relatif d’un profil Traffic Manager.

Exemple 3 : Réorganiser les points de terminaison selon l’ordre de basculement souhaité

PS C:\>$Profile = Get-AzureTrafficManagerProfile -Name "MyProfile"
PS C:\> $Profile.Endpoints[0],$Profile.Endpoints[1] = $Profile.Endpoints[1],$Profile.Endpoints[0]
PS C:\> $Profile = Set-AzureTrafficManagerProfile

Cet exemple réorganise les points de terminaison ajoutés à MyProfile dans l’ordre de basculement souhaité.

La première commande obtient l’objet de profil Traffic Manager nommé MyProfile et stocke l’objet dans la variable $Profile.

La deuxième commande récommande les points de terminaison du tableau des points de terminaison vers l’ordre dans lequel le basculement doit se produire.

La dernière commande met à jour le profil Traffic Manager stocké dans $Profile avec la nouvelle commande de point de terminaison.

Paramètres

-LoadBalancingMethod

Spécifie la méthode d’équilibrage de charge à utiliser pour distribuer la connexion. Les valeurs valides sont :

  • Performances
  • Type de basculement
  • RoundRobin
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

-MonitorPort

Spécifie le port utilisé pour surveiller l’intégrité du point de terminaison. Les valeurs valides sont des valeurs entières supérieures à 0 et inférieures ou égales à 65 535.

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

-MonitorProtocol

Spécifie le protocole à utiliser pour surveiller l’intégrité des points de terminaison. Les valeurs valides sont :

  • Http
  • Https
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

-MonitorRelativePath

Spécifie le chemin d’accès relatif au nom de domaine de point de terminaison pour détecter l’état d’intégrité. Le chemin d’accès doit respecter les restrictions suivantes :

  • Le chemin d’accès doit être compris entre 1 et 1 000 caractères.
  • Elle doit commencer par une barre oblique, /.
  • Il ne doit contenir aucun élément XML. <>
  • Elle ne doit contenir aucune double barre oblique, //.
  • Il ne doit contenir aucun caractère d’échappement HTML non valide. Par exemple, %XY.
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

-Name

Spécifie le nom du profil Traffic Manager à mettre à jour.

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

-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

-TrafficManagerProfile

Spécifie l’objet de profil Traffic Manager que vous utilisez pour définir le profil.

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

-Ttl

Spécifie la durée de vie du DNS (TTL) qui informe les résolveurs DNS locaux combien de temps pour mettre en cache les entrées DNS. Les valeurs valides sont un entier compris entre 30 et 999 999.

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

Sorties

Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition

Cette applet de commande génère un objet de profil Traffic Manager.