Partager via

Add-AzureTrafficManagerEndpoint

  • Référence
Module:
Azure

Ajoute un point de terminaison à 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

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

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 autorisées 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:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TrafficManagerProfile

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