Partager via

Set-AzureTrafficManagerEndpoint

  • Référence
Module:
Azure

Met à jour les propriétés d’un point de terminaison dans 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-AzureTrafficManagerEndpoint
   -DomainName <String>
   [-Location <String>]
   [-Type <String>]
   [-Status <String>]
   [-Weight <Int32>]
   [-MinChildEndpoints <Int32>]
   -TrafficManagerProfile <IProfileWithDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

L’applet de commande Set-AzureTrafficManagerEndpoint met à jour les propriétés d’un point de terminaison dans un profil Microsoft Azure Traffic Manager. Si le point de terminaison n’existe pas dans le profil actuel, cette applet de commande la crée. Après avoir ajouté un point de terminaison, transmettez le résultat à l’applet de commande Set-AzureTrafficManagerProfile à l’aide de l’opérateur de pipeline. Cette applet de commande se connecte à Azure pour enregistrer vos modifications.

Exemples

Exemple 1 : Mettre à jour un point de terminaison pour un profil

PS C:\>$TrafficManagerProfile = Get-AzureTrafficManagerProfile -Name "ContosoProfile"
PS C:\> Set-AzureTrafficManagerEndpoint -TrafficManagerProfile $TrafficManagerProfile -DomainName "ContosoApp02.cloudapp.net" -Status "Enabled" -Type "CloudService" -Weight 2 -Location myLocation | Set-AzureTrafficManagerProfile

La première commande utilise l’applet de commande Get-AzureTrafficManagerProfile pour obtenir le profil nommé ContosoProfile, puis la stocke dans la variable $TrafficManagerProfile.

La deuxième commande met à jour le point de terminaison dans le profil Traffic Manager stocké dans $TrafficManagerProfile. Le point de terminaison a le nom de domaine ContosoApp02.cloudapp.net. La commande spécifie également l’état, le type, le poids et l’emplacement du point de terminaison. La commande transmet le profil modifié à l’applet de commande Set-AzureTrafficManagerProfile pour vous connecter à Azure pour enregistrer vos modifications.

Paramètres

-DomainName

Spécifie le nom de domaine du point de terminaison à modifier.

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

-Location

Spécifie l’emplacement du point de terminaison ajouté par l’applet de commande. Il doit s’agir d’un emplacement Azure.

Ce paramètre doit contenir une valeur pour les points de terminaison du type « Any » ou de type « TrafficManager » dans un profil dont la méthode d’équilibrage de charge est définie sur « Performance ». Les valeurs possibles sont les noms de région Azure, comme indiqué à l’adresse https://azure.microsoft.com/regions/https://azure.microsoft.com/regions/.

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

-MinChildEndpoints

Spécifie le nombre minimal de points de terminaison que le profil imbriqué doit avoir en ligne pour que ce point de terminaison soit considéré comme en ligne.

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

-Status

Spécifie l’état du point de terminaison de surveillance. Les valeurs valides sont :

  • Activé(e)
  • Disabled

Si vous spécifiez la valeur Enabled, Traffic Manager surveille le point de terminaison et la méthode d’équilibrage de charge la considère lors de la gestion du trafic.

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

-TrafficManagerProfile

Spécifie l’objet de profil Traffic Manager pour lequel modifier le point de terminaison.

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

-Type

Spécifie le type de point de terminaison. Les valeurs valides sont :

  • CloudService

  • Site AzureWeb

  • TrafficManager

  • Tout

S’il existe plusieurs points de terminaison AzureWebsite, les points de terminaison doivent se trouver dans différents centres de données.

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

-Weight

Spécifie le poids du point de terminaison ajouté par l’applet de commande. La plage de valeurs valide pour ce paramètre est [1 1 1000].

Ce paramètre est utilisé uniquement pour les stratégies d’équilibrage de charge RoundRobin.

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, qui contient des informations sur le profil mis à jour.