Add-AzureTrafficManagerEndpoint

Ajoute un point de terminaison à un profil Traffic Manager.

Notes

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

Add-AzureTrafficManagerEndpoint
   -DomainName <String>
   [-Location <String>]
   -Type <String>
   -Status <String>
   [-Weight <Int32>]
   [-MinChildEndpoints <Int32>]
   -TrafficManagerProfile <IProfileWithDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

L’applet de commande Add-AzureTrafficManagerEndpoint ajoute un point de terminaison à un profil Microsoft Azure Traffic Manager. 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 : Ajouter un point de terminaison à un profil

PS C:\>$TrafficManagerProfile = Get-AzureTrafficManagerProfile -Name "ContosoProfile"
PS C:\> Add-AzureTrafficManagerEndpoint -TrafficManagerProfile $TrafficManagerProfile -DomainName "Contoso02App.cloudapp.net" -Status "Enabled" -Type "CloudService" | 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 ajoute un point de terminaison au profil Traffic Manager stocké dans $TrafficManagerProfile. Le point de terminaison a le nom de domaine Contoso02App.couldapp.net. La commande spécifie également s’il est activé et son type. La commande transmet l’objet de profil à l’applet de commande Set-AzureTrafficManagerProfile pour vous connecter à Azure pour enregistrer vos modifications.

Exemple 2 : Ajouter un point de terminaison qui a un emplacement et un poids spécifiés

PS C:\>Add-AzureTrafficManagerEndpoint -TrafficManagerProfile ContosoTrafficManagerProfile -DomainName " Contoso02App.cloudapp.net" -Status Enabled -Type CloudService -Weight 2 -Location myLocation | Set-AzureTrafficManagerProfile

Cette commande ajoute un point de terminaison à un profil Traffic Manager. Le point de terminaison a le nom de domaine Contoso02App.couldapp.net. La commande spécifie également s’il est activé et son type. La commande spécifie également l’épaisseur et l’emplacement du point de terminaison. La commande transmet l’objet de profil à Set-AzureTrafficManagerProfile pour vous connecter à Azure pour enregistrer vos modifications.

Paramètres

-DomainName

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

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

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é
  • Désactivé

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

-TrafficManagerProfile

Spécifie l’objet de profil Traffic Manager auquel ajouter 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

  • Quelconque

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:True
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.