Partager via

New-AzureTrafficManagerProfile

  • Référence
Module:
Azure

Crée un profil Traffic Manager.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

New-AzureTrafficManagerProfile
   -Name <String>
   -DomainName <String>
   -LoadBalancingMethod <String>
   -MonitorPort <Int32>
   -MonitorProtocol <String>
   -MonitorRelativePath <String>
   -Ttl <Int32>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

L’applet de commande New-AzureTrafficManagerProfile crée un profil Microsoft Azure Traffic Manager.

Après avoir créé un profil dans lequel vous définissez la valeur LoadBalancingMethod sur « Basculement », vous pouvez déterminer l’ordre de basculement des points de terminaison que vous ajoutez à votre profil avec l’applet de commande Add-AzureTrafficManagerEndpoint. Pour plus d’informations, consultez l’exemple 2 ci-dessous.

Exemples

Exemple 1 : Créer un profil Traffic Manager

PS C:\>New-AzureTrafficManagerProfile -Name "MyProfile" -DomainName "My.profile.trafficmanager.net" -LoadBalancingMethod "RoundRobin" -Ttl 30 -MonitorProtocol "Http" -MonitorPort 80 -MonitorRelativePath "/"

Cette commande crée un profil Traffic Manager nommé MyProfile dans le domaine Traffic Manager spécifié avec une méthode d’équilibrage de charge Round Robin, une durée de vie de 30 secondes, un protocole de surveillance HTTP, le port de surveillance 80 et le chemin spécifié.

Exemple 2 : Réorganiser les points de terminaison selon l’ordre de basculement souhaité

PS C:\>$Profile = Get-AzureTrafficManagerProfile -Name "MyProfile"
PS C:\> $Profile.Endpoints[0],$Profile.Endpoints[1] = $Profile.Endpoints[1],$Profile.Endpoints[0]
PS C:\> $Profile = Set-AzureTrafficManagerProfile

Cet exemple réorganise les points de terminaison ajoutés à MyProfile dans l’ordre de basculement souhaité.

La première commande obtient l’objet de profil Traffic Manager nommé MyProfile et stocke l’objet dans la variable $Profile.

La deuxième commande récommande les points de terminaison du tableau des points de terminaison vers l’ordre dans lequel le basculement doit se produire.

La dernière commande met à jour le profil Traffic Manager stocké dans $Profile avec la nouvelle commande de point de terminaison.

Paramètres

-DomainName

Spécifie le nom de domaine du profil Traffic Manager. Il doit s’agir d’un sous-domaine de trafficmanager.net.

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

-LoadBalancingMethod

Spécifie la méthode d’équilibrage de charge à utiliser pour distribuer la connexion. Les valeurs valides sont :

  • Performances
  • Type de basculement
  • RoundRobin
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

-MonitorPort

Spécifie le port utilisé pour surveiller l’intégrité du point de terminaison. Les valeurs valides sont des valeurs entières supérieures à 0 et inférieures ou égales à 65 535.

Type:Int32
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é des points de terminaison. Les valeurs valides sont :

  • Http

  • Https

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

-MonitorRelativePath

Spécifie le chemin d’accès relatif au nom de domaine de point de terminaison pour détecter l’état d’intégrité. Le chemin d’accès doit respecter les restrictions suivantes :

  • Le chemin d’accès doit être compris entre 1 et 1 000 caractères.

  • Elle doit commencer par une barre oblique, /.

  • Il ne doit contenir aucun élément XML. <>

  • Elle ne doit contenir aucune double barre oblique, //.

  • Il ne doit contenir aucun caractère d’échappement HTML non valide. Par exemple, %XY.

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

-Name

Spécifie le nom du profil Traffic Manager à créer.

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

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

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

-Ttl

Spécifie la durée de vie du DNS (TTL) qui informe les résolveurs DNS locaux combien de temps pour mettre en cache les entrées DNS. Les valeurs valides sont des entiers compris entre 30 et 999 999.

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

Sorties

Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition

Cette applet de commande génère un objet de profil Traffic Manager.