Set-AzureTrafficManagerEndpoint

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 Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

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

-Status

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

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

-TrafficManagerProfile

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

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

-Type

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

  • CloudService

  • Site AzureWeb

  • TrafficManager

  • N’importe lequel

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