New-AzTrafficManagerProfile

Module:
Az.TrafficManager Module

Crée un profil Traffic Manager.

Syntaxe

Default (Par défaut) 

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>]
    [-RecordType <String>]
    [-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

L’applet de commande 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.

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

-ExpectedStatusCodeRange

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

Propriétés du paramètre

Type:

List<T>[TrafficManagerExpectedStatusCodeRange]

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

-MaxReturn

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

Propriétés du paramètre

Type:

Nullable<T>[Int64]

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

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

Propriétés du paramètre

Type:

Nullable<T>[Int32]

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

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

-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 (/).

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

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

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

Propriétés du paramètre

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

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

-MonitorProtocol

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

  • HTTP
  • HTTPS

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:HTTP, HTTPS, TCP
Prend en charge les caractères génériques:False
DontShow:False
Alias:ProtocolForMonitor

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

-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 de 10.

Propriétés du paramètre

Type:

Nullable<T>[Int32]

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

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

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

Propriétés du paramètre

Type:

Nullable<T>[Int32]

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

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 un nom pour le profil Traffic Manager créé par cette applet de commande.

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

-ProfileStatus

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

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

-RecordType

Lorsque RecordType est défini, le profil Traffic Manager autorise uniquement les points de terminaison qui correspondent au type d’enregistrement DNS spécifié. Lorsqu’il n’est pas défini, le profil autorise les points de terminaison d’un type pris en charge. Les valeurs valides sont les suivantes :

  • A
  • AAAA
  • CNAME

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:A, AAAA, CNAME
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

-RelativeDnsName

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

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

-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"}

Propriétés du paramètre

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

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

-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é
  • Priority
  • Géographique

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:Performance, Weighted, Priority, Geographic, Subnet, MultiValue
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

-Ttl

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

Propriétés du paramètre

Type: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:True
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 communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

None

Sorties

TrafficManagerProfile