New-AzTrafficManagerEndpoint

  • Référence
Module:
Az.TrafficManager

Crée un point de terminaison dans un profil Azure Traffic Manager.

Syntax

New-AzTrafficManagerEndpoint
   -Name <String>
   -ProfileName <String>
   -ResourceGroupName <String>
   -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 New-AzTrafficManagerEndpoint crée un point de terminaison dans un profil Azure Traffic Manager.

Cette applet de commande valide chaque nouveau point de terminaison dans le service Traffic Manager. Pour ajouter plusieurs points de terminaison à un objet de profil Traffic Manager local et valider les modifications dans une seule opération, utilisez l’applet de commande Add-AzTrafficManagerEndpointConfig.

Exemples

Exemple 1 : Créer un point de terminaison externe pour un profil

New-AzTrafficManagerEndpoint -EndpointStatus Enabled -Name "contoso" -ProfileName "ContosoProfile" -ResourceGroupName "ResourceGroup11" -Type ExternalEndpoints -EndpointLocation "North Europe" -Priority 1 -Target "www.contoso.com" -Weight 10

Cette commande crée un point de terminaison externe nommé contoso dans le profil nommé ContosoProfile dans le groupe de ressources nommé ResourceGroup11.

Exemple 2 : Créer un point de terminaison Azure pour un profil

New-AzTrafficManagerEndpoint -EndpointStatus Enabled -Name "contoso" -ProfileName "ContosoProfile" -ResourceGroupName "ResourceGroup11" -Type AzureEndpoints -Priority 1 -TargetResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Default-Web-CentralUS/providers/Microsoft.Web/sites/contoso-web-app" -Weight 10

Cette commande crée un point de terminaison Azure nommé contoso dans le profil nommé ContosoProfile dans le groupe de ressources ResourceGroup11. Le point de terminaison Azure pointe vers l’application web Azure dont l’ID Azure Resource Manager est donné par le chemin d’URI dans TargetResourceId. La commande ne spécifie pas le paramètre EndpointLocation , car la ressource Web App fournit l’emplacement.

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 du type ExternalEndpoints ou 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

-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

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

-Name

Spécifie le nom du point de terminaison Traffic Manager que cette applet de commande crée.

Type:String
Position:Named
Default value:None
Required:True
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

-ProfileName

Spécifie le nom d’un profil Traffic Manager auquel cette applet de commande ajoute un point de terminaison. Pour obtenir un profil, utilisez les applets de commande New-AzTrafficManagerProfile ou Get-AzTrafficManagerProfile.

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

-ResourceGroupName

Spécifie le nom d’un groupe de ressources. Cette applet de commande crée un point de terminaison Traffic Manager dans le groupe spécifié par ce paramètre.

Type:String
Position:Named
Default value:None
Required:True
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

-Type

Spécifie le type de point de terminaison que cette applet de commande ajoute au profil 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

None

Sorties

TrafficManagerEndpoint