Add-AzTrafficManagerEndpointConfig
Ajoute un point de terminaison à un objet de profil Traffic Manager local.
Syntaxe
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 |
Valeurs acceptées: | Enabled, Disabled |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-EndpointName
Spécifie le nom du point de terminaison Traffic Manager ajouté par cette applet de commande.
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 |
-EndpointStatus
Spécifie l’état du point de terminaison. Les valeurs autorisées 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 |
Valeurs acceptées: | Enabled, Disabled |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | 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 |
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 que cette applet de commande ajoute au profil Azure Traffic Manager. Les valeurs autorisées sont :
- AzureEndpoints
- ExternalEndpoints
- NestedEndpoints
Type: | String |
Valeurs acceptées: | AzureEndpoints, ExternalEndpoints, NestedEndpoints |
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 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |