Freigeben über

New-AzureTrafficManagerProfile

  • Referenz
Modul:
Azure

Erstellt ein Traffic Manager-Profil.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

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

Beschreibung

Das Cmdlet New-AzureTrafficManagerProfile erstellt ein Microsoft Azure Traffic Manager-Profil.

Nachdem Sie ein Profil erstellt haben, in dem Sie den LoadBalancingMethod-Wert auf "Failover" festgelegt haben, können Sie die Failoverreihenfolge der Endpunkte bestimmen, die Sie Ihrem Profil mit dem Cmdlet "Add-AzureTrafficManagerEndpoint" hinzufügen. Weitere Informationen finden Sie in Beispiel 2 unten.

Beispiele

Beispiel 1: Erstellen eines Traffic Manager-Profils

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

Mit diesem Befehl wird ein Traffic Manager-Profil namens "MyProfile" in der angegebenen Traffic Manager-Domäne mit einer Round Robin-Lastenausgleichsmethode, einer TTL von 30 Sekunden, einem HTTP-Überwachungsprotokoll, der Überwachung von Port 80 und mit dem angegebenen Pfad erstellt.

Beispiel 2: Neuanordnen von Endpunkten an die gewünschte Failoverreihenfolge

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

In diesem Beispiel werden die Endpunkte neu angeordnet, die myProfile zur gewünschten Failoverreihenfolge hinzugefügt wurden.

Der erste Befehl ruft das Traffic Manager-Profilobjekt mit dem Namen MyProfile ab und speichert das Objekt in der variablen $Profile.

Der zweite Befehl sortiert die Endpunkte aus dem Endpunktarray erneut in die Reihenfolge, in der Failover ausgeführt werden soll.

Der letzte Befehl aktualisiert das in $Profile gespeicherte Traffic Manager-Profil mit der neuen Endpunktreihenfolge.

Parameter

-DomainName

Gibt den Domänennamen des Traffic Manager-Profils an. Dies muss eine Unterdomäne von trafficmanager.net sein.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LoadBalancingMethod

Gibt die Lastenausgleichsmethode an, die zum Verteilen der Verbindung verwendet werden soll. Gültige Werte sind:

  • Leistung
  • Failover
  • RoundRobin
Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MonitorPort

Gibt den Port an, der zum Überwachen der Endpunktintegrität verwendet wird. Gültige Werte sind ganzzahlige Werte, die größer als 0 und kleiner als oder gleich 65.535 sind.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MonitorProtocol

Gibt das Protokoll an, mit dem die Endpunktintegrität überwacht werden soll. Gültige Werte sind:

  • Http

  • HTTPS

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MonitorRelativePath

Gibt den Pfad relativ zum Endpunktdomänennamen an, um den Integritätszustand zu untersuchen. Der Pfad muss die folgenden Einschränkungen erfüllen:

  • Der Pfad muss zwischen 1 und 1000 Zeichen bestehen.

  • Er muss mit einem Schrägstrich /beginnen.

  • Sie darf keine XML-Elemente enthalten. <>

  • Er darf keine Doppelstriche enthalten, //.

  • Sie darf keine ungültigen HTML-Escapezeichen enthalten. Beispiel: %XY.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des zu erstellenden Traffic Manager-Profils an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Ttl

Gibt die DNS-Time-to-Live (TTL) an, die die lokalen DNS-Resolver darüber informiert, wie lange DNS-Einträge zwischengespeichert werden sollen. Gültige Werte sind ganze Zahlen zwischen 30 und 999.999.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

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

Dieses Cmdlet generiert ein Traffic Manager-Profilobjekt.