Partager via

New-AzTrafficManagerProfile

  • Référence
Module:
Az.TrafficManager

Crée un profil Traffic Manager.

Syntaxe

New-AzTrafficManagerProfile
   -Name <String>
   -ResourceGroupName <String>
   [-ProfileStatus <String>]
   -RelativeDnsName <String>
   -Ttl <UInt32>
   -TrafficRoutingMethod <String>
   -MonitorProtocol <String>
   -MonitorPort <UInt32>
   [-MonitorPath <String>]
   [-MonitorIntervalInSeconds <Int32>]
   [-MonitorTimeoutInSeconds <Int32>]
   [-MonitorToleratedNumberOfFailures <Int32>]
   [-MaxReturn <Int64>]
   [-Tag <Hashtable>]
   [-CustomHeader <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerCustomHeader]>]
   [-ExpectedStatusCodeRange <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerExpectedStatusCodeRange]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

La cmdlet New-AzTrafficManagerProfile crée un profil Azure Traffic Manager. Spécifiez le paramètre Name et les paramètres requis. Cette applet de commande retourne un objet local qui représente le nouveau profil.

Cette applet de commande ne configure pas les points de terminaison Traffic Manager. Vous pouvez mettre à jour l’objet de profil local à l’aide de l’applet de commande Add-AzTrafficManagerEndpointConfig. Chargez ensuite les modifications apportées à Traffic Manager à l’aide de l’applet de commande Set-AzTrafficManagerProfile. Vous pouvez également ajouter des points de terminaison à l’aide de l’applet de commande New-AzTrafficManagerEndpoint.

Exemples

Exemple 1 : Créer un profil

New-AzTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11" -ProfileStatus Enabled -TrafficRoutingMethod Performance -RelativeDnsName "contosoapp" -TTL 30 -MonitorProtocol HTTP -MonitorPort 80 -MonitorPath "/default.aspx"

Cette commande crée un profil Azure Traffic Manager nommé ContosoProfile dans le groupe de ressources ResourceGroup11. Le nom de domaine complet DNS est contosoapp.trafficmanager.net.

Paramètres

-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

-ExpectedStatusCodeRange

Liste des plages de code d’état HTTP attendues pour les requêtes de sonde.

Type:List<T>[TrafficManagerExpectedStatusCodeRange]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaxReturn

Nombre maximal de réponses retournées pour les profils avec une méthode de routage MultiValue.

Type:Nullable<T>[Int64]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MonitorIntervalInSeconds

Intervalle (en secondes) auquel Traffic Manager vérifie l’intégrité de chaque point de terminaison dans ce profil. La valeur par défaut est 30.

Type:Nullable<T>[Int32]
Alias:IntervalInSecondsForMonitor
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MonitorPath

Spécifie le chemin d’accès utilisé pour surveiller l’intégrité du point de terminaison. Spécifiez une valeur relative au nom de domaine de point de terminaison. Cette valeur doit commencer par une barre oblique (/).

Type:String
Alias:PathForMonitor
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MonitorPort

Spécifie le port TCP utilisé pour surveiller l’intégrité du point de terminaison. Les valeurs valides sont des entiers compris entre 1 et 65535.

Type:UInt32
Alias:PortForMonitor
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MonitorProtocol

Spécifie le protocole à utiliser pour surveiller l’intégrité du point de terminaison. Les valeurs valides sont les suivantes :

  • HTTP
  • HTTPS
Type:String
Alias:ProtocolForMonitor
Valeurs acceptées:HTTP, HTTPS, TCP
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MonitorTimeoutInSeconds

Temps (en secondes) que Traffic Manager autorise les points de terminaison de ce profil à répondre à la vérification d’intégrité. La valeur par défaut est 10.

Type:Nullable<T>[Int32]
Alias:TimeoutInSecondsForMonitor
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MonitorToleratedNumberOfFailures

Nombre de vérifications d’intégrité ayant échoué consécutives que Traffic Manager tolère avant de déclarer un point de terminaison dans ce profil détérioré après le prochain contrôle d’intégrité ayant échoué. La valeur par défaut est 3.

Type:Nullable<T>[Int32]
Alias:ToleratedNumberOfFailuresForMonitor
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie un nom pour le profil Traffic Manager créé 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

-ProfileStatus

Spécifie l’état du profil. Les valeurs valides sont : Activé et Désactivé.

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

-RelativeDnsName

Spécifie le nom DNS relatif fourni par ce profil Traffic Manager. Traffic Manager combine cette valeur et le nom de domaine DNS qu’Azure Traffic Manager utilise pour former le nom de domaine complet (FQDN) du profil.

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

-ResourceGroupName

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

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

-Tag

Paires clé-valeur sous la forme d’une table de hachage définie en tant que balises sur le serveur. Par exemple:

@{key0="value0 » ; key1=$null ; key2="value2"}

Type:Hashtable
Alias:Tags
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TrafficRoutingMethod

Spécifie la méthode de routage du trafic. Cette méthode détermine quel point de terminaison Traffic Manager retourne en réponse aux requêtes DNS entrantes. Les valeurs valides sont les suivantes :

  • Performance
  • Pondéré
  • Priorité
  • Géographique
Type:String
Valeurs acceptées:Performance, Weighted, Priority, Geographic, Subnet, MultiValue
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Ttl

Spécifie la valeur de durée de vie (TTL) DNS.

Type:UInt32
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

TrafficManagerProfile