Partager via

New-AzTrafficManagerEndpoint

Module:
Az.TrafficManager Module

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

Syntaxe

Default (Par défaut) 

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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:Enabled, Disabled
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-CustomHeader

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

Propriétés du paramètre

Type:

List<T>[TrafficManagerCustomHeader]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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/).

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-EndpointStatus

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

  • Enabled
  • 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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:Enabled, Disabled
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

List<T>[String]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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/).

Propriétés du paramètre

Type:

Nullable<T>[UInt32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 ».

Propriétés du paramètre

Type:

Nullable<T>[UInt32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 ».

Propriétés du paramètre

Type:

Nullable<T>[UInt32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

Nullable<T>[UInt32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 ».

Propriétés du paramètre

Type:

List<T>[TrafficManagerIpAddressRange]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 .

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Type

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

  • AzureEndpoints
  • ExternalEndpoints
  • NestedEndpoints

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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é.

Propriétés du paramètre

Type:

Nullable<T>[UInt32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

None

Sorties

TrafficManagerEndpoint