Freigeben über

Set-AzureTrafficManagerProfile

  • Referenz
Modul:
Azure

Aktualisiert die Eigenschaften eines Traffic Manager-Profils.

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

Set-AzureTrafficManagerProfile
   [-Name <String>]
   [-LoadBalancingMethod <String>]
   [-MonitorPort <Int32>]
   [-MonitorProtocol <String>]
   [-MonitorRelativePath <String>]
   [-Ttl <Int32>]
   -TrafficManagerProfile <IProfileWithDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzureTrafficManagerProfile aktualisiert die Eigenschaften eines Microsoft Azure Traffic Manager-Profils.

Für Profile, für die Sie den LoadBalancingMethod-Wert auf "Failover" festgelegt haben, können Sie die Failoverreihenfolge der Endpunkte bestimmen, die Sie Ihrem Profil mit dem Add-AzureTrafficManagerEndpoint-Cmdlet hinzugefügt haben. Weitere Informationen finden Sie in Beispiel 3 unten.

Beispiele

Beispiel 1: Festlegen der TTL für ein Traffic Manager-Profil

PS C:\>Set-AzureTrafficManagerProfile -TrafficManagerProfile $MyTrafficManagerProfile -Ttl 60

Mit diesem Befehl wird die TTL auf 60 Sekunden für das Traffic Manager-Profilobjekt MyTrafficManagerProfile festgelegt.

Beispiel 2: Festlegen mehrerer Werte für ein Profil

PS C:\>Get-AzureTrafficManagerProfile -Name "MyProfile" | Set-AzureTrafficManagerProfile -LoadBalancingMethod "RoundRobin" -Ttl 30 -MonitorProtocol "Http" -MonitorPort 80 -MonitorRelativePath "/"

Mit diesem Befehl wird ein Traffic Manager-Profil namens "MyProfile" mithilfe des Cmdlets "Get-AzureTrafficManagerProfile " abgerufen. Das Profil verwendet die RoundRobin-Lastenausgleichsmethode, eine TTL von 30 Sekunden, das Monitorprotokoll HTTP, den Monitorport und den relativen Pfad für ein Traffic Manager-Profil.

Beispiel 3: 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

-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:False
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:False
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:False
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:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
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

-TrafficManagerProfile

Gibt das Traffic Manager-Profilobjekt an, das Sie zum Festlegen des Profils verwenden.

Typ:IProfileWithDefinition
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
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 eine ganze Zahl zwischen 30 und 999.999.

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

Ausgaben

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

Dieses Cmdlet generiert ein Traffic Manager-Profilobjekt.