Share via


Add-AzTrafficManagerEndpointConfig

Ajoute un point de terminaison à un objet de profil Traffic Manager local.

Syntax

Add-AzTrafficManagerEndpointConfig
   -EndpointName <String>
   -TrafficManagerProfile <TrafficManagerProfile>
   -Type <String>
   [-TargetResourceId <String>]
   [-Target <String>]
   -EndpointStatus <String>
   [-Weight <UInt32>]
   [-Priority <UInt32>]
   [-EndpointLocation <String>]
   [-AlwaysServe <String>]
   [-MinChildEndpoints <UInt32>]
   [-MinChildEndpointsIPv4 <UInt32>]
   [-MinChildEndpointsIPv6 <UInt32>]
   [-GeoMapping <System.Collections.Generic.List`1[System.String]>]
   [-SubnetMapping <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerIpAddressRange]>]
   [-CustomHeader <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerCustomHeader]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Add-AzTrafficManagerEndpointConfig ajoute un point de terminaison à un objet de profil Azure Traffic Manager local. Vous pouvez obtenir un profil à l’aide des applets de commande New-AzTrafficManagerProfile ou Get-AzTrafficManagerProfile.

Cette applet de commande fonctionne sur l’objet de profil local. Validez vos modifications dans le profil de Traffic Manager à l’aide de l’applet de commande Set-AzTrafficManagerProfile. Pour créer un point de terminaison et valider la modification dans une seule opération, utilisez l’applet de commande New-AzTrafficManagerEndpoint.

Exemples

Exemple 1 : Ajouter un point de terminaison à un profil

$TrafficManagerProfile = Get-AzTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11"
Add-AzTrafficManagerEndpointConfig -EndpointName "contoso" -EndpointStatus Enabled -Target "www.contoso.com" -TrafficManagerProfile $TrafficManagerProfile -Type ExternalEndpoints -EndpointLocation "North Europe" -Priority 1 -Weight 10
Set-AzTrafficManagerProfile -TrafficManagerProfile $TrafficManagerProfile

La première commande obtient un profil Azure Traffic Manager à l’aide de l’applet de commande Get-AzTrafficManagerProfile . La commande stocke le profil local dans la variable $TrafficManagerProfile.

La deuxième commande ajoute un point de terminaison nommé contoso au profil stocké dans $TrafficManagerProfile. La commande inclut des données de configuration pour le point de terminaison. Cette commande modifie uniquement l’objet local.

La commande finale met à jour le profil Traffic Manager dans Azure pour qu’il corresponde à la valeur locale dans $TrafficManagerProfile.

Paramètres

-AlwaysServe

Si Always Serve est activé, la détection de l’intégrité des points de terminaison est désactivée et les points de terminaison sont inclus dans la méthode de routage du trafic.

Type:String
Accepted values:Enabled, Disabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomHeader

Liste des paires nom d’en-tête et valeur personnalisées pour les demandes de sonde.

Type:List<T>[TrafficManagerCustomHeader]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EndpointLocation

Spécifie l’emplacement du point de terminaison à utiliser dans la méthode de routage du trafic de performances. Ce paramètre s’applique uniquement aux points de terminaison des points de terminaison des points de terminaison externes ou au type NestedEndpoints. Vous devez spécifier ce paramètre lorsque la méthode de routage du trafic performance est utilisée.

Spécifiez un nom de région Azure. Pour obtenir la liste complète des régions Azure, consultez Régionshttp://azure.microsoft.com/regions/ Azure (http://azure.microsoft.com/regions/).

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

-EndpointName

Spécifie le nom du point de terminaison Traffic Manager ajouté par cette applet de commande.

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

-EndpointStatus

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

  • Activé(e)
  • Disabled

Si l’état est Activé, le point de terminaison est détecté pour l’intégrité du point de terminaison et est inclus dans la méthode de routage du trafic.

Type:String
Accepted values:Enabled, Disabled
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-GeoMapping

Liste des régions mappées à ce point de terminaison lors de l’utilisation de la méthode de routage du trafic « Géographique ». Consultez la documentation Traffic Manager pour obtenir la liste complète des valeurs acceptées.

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinChildEndpoints

Nombre minimal de points de terminaison qui doivent être disponibles dans le profil enfant afin que le point de terminaison imbriqué dans le profil parent soit considéré comme disponible. Applicable uniquement au point de terminaison de type « NestedEndpoints ».

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinChildEndpointsIPv4

Nombre minimal de points de terminaison IPv4 (type d’enregistrement DNS A) qui doivent être disponibles dans le profil enfant afin que le point de terminaison imbriqué dans le profil parent soit considéré comme disponible. Applicable uniquement au point de terminaison de type « NestedEndpoints ».

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinChildEndpointsIPv6

Nombre minimal de points de terminaison IPv6 (type d’enregistrement DNS AAAA) qui doivent être disponibles dans le profil enfant afin que le point de terminaison imbriqué dans le profil parent soit considéré comme disponible. Applicable uniquement au point de terminaison de type « NestedEndpoints ».

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Priority

Spécifie la priorité affectée par Traffic Manager au point de terminaison. Ce paramètre est utilisé uniquement si le profil Traffic Manager est configuré avec la méthode de routage du trafic Prioritaire. Les valeurs valides sont des entiers compris entre 1 et 1 000. Les valeurs inférieures représentent une priorité plus élevée.

Si vous spécifiez une priorité, vous devez spécifier des priorités sur tous les points de terminaison du profil, et aucun point de terminaison ne peut partager la même valeur de priorité. Si vous ne spécifiez pas de priorités, Traffic Manager affecte les valeurs de priorité par défaut aux points de terminaison, en commençant par un (1), dans l’ordre dans lequel le profil répertorie les points de terminaison.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubnetMapping

Liste des plages d’adresses ou sous-réseaux mappés à ce point de terminaison lors de l’utilisation de la méthode de routage du trafic « Sous-réseau ».

Type:List<T>[TrafficManagerIpAddressRange]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Target

Spécifie le nom DNS complet du point de terminaison. Traffic Manager retourne cette valeur dans les réponses DNS lorsqu’il dirige le trafic vers ce point de terminaison. Spécifiez ce paramètre uniquement pour le type de point de terminaison ExternalEndpoints. Pour les autres types de points de terminaison, spécifiez plutôt le paramètre TargetResourceId .

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

-TargetResourceId

Spécifie l’ID de ressource de la cible. Spécifiez ce paramètre uniquement pour les types de points de terminaison AzureEndpoints et NestedEndpoints. Pour le type de point de terminaison ExternalEndpoints, spécifiez le paramètre Cible à la place.

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

-TrafficManagerProfile

Spécifie un objet TrafficManagerProfile local. Cette applet de commande modifie cet objet local. Pour obtenir un objet TrafficManagerProfile , utilisez l’applet de commande Get-AzTrafficManagerProfile.

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

-Type

Spécifie le type de point de terminaison que cette applet de commande ajoute au profil Azure Traffic Manager. Les valeurs valides sont :

  • AzureEndpoints
  • ExternalEndpoints
  • NestedEndpoints
Type:String
Accepted values:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Weight

Spécifie le poids que Traffic Manager affecte au point de terminaison. Les valeurs valides sont des entiers compris entre 1 et 1 000. La valeur par défaut est une (1). Ce paramètre est utilisé uniquement si le profil Traffic Manager est configuré avec la méthode de routage du trafic pondéré.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

TrafficManagerProfile

Sorties

TrafficManagerProfile