Freigeben über

Set-AzureTrafficManagerEndpoint

  • Referenz
Modul:
Azure

Aktualisiert die Eigenschaften eines Endpunkts in einem 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

Set-AzureTrafficManagerEndpoint
   -DomainName <String>
   [-Location <String>]
   [-Type <String>]
   [-Status <String>]
   [-Weight <Int32>]
   [-MinChildEndpoints <Int32>]
   -TrafficManagerProfile <IProfileWithDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzureTrafficManagerEndpoint aktualisiert die Eigenschaften eines Endpunkts in einem Microsoft Azure Traffic Manager-Profil. Wenn der Endpunkt nicht im aktuellen Profil vorhanden ist, erstellt es dieses Cmdlet. Nachdem Sie einen Endpunkt hinzugefügt haben, übergeben Sie das Ergebnis mithilfe des Pipelineoperators an das Cmdlet Set-AzureTrafficManagerProfile . Mit diesem Cmdlet wird eine Verbindung mit Azure hergestellt, um Ihre Änderungen zu speichern.

Beispiele

Beispiel 1: Aktualisieren eines Endpunkts für ein Profil

PS C:\>$TrafficManagerProfile = Get-AzureTrafficManagerProfile -Name "ContosoProfile"
PS C:\> Set-AzureTrafficManagerEndpoint -TrafficManagerProfile $TrafficManagerProfile -DomainName "ContosoApp02.cloudapp.net" -Status "Enabled" -Type "CloudService" -Weight 2 -Location myLocation | Set-AzureTrafficManagerProfile

Der erste Befehl verwendet das Cmdlet "Get-AzureTrafficManagerProfile ", um das Profil mit dem Namen "ContosoProfile" abzurufen, und speichert es dann in der variablen $TrafficManagerProfile.

Der zweite Befehl aktualisiert den Endpunkt im Traffic Manager-Profil, das in $TrafficManagerProfile gespeichert ist. Der Endpunkt hat den Domänennamen ContosoApp02.cloudapp.net. Der Befehl gibt außerdem den Status, typ, die Gewichtung und die Position des Endpunkts an. Der Befehl übergibt das geänderte Profil an das Cmdlet Set-AzureTrafficManagerProfile , um eine Verbindung mit Azure herzustellen, um Ihre Änderungen zu speichern.

Parameter

-DomainName

Gibt den Domänennamen des zu ändernden Endpunkts an.

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

-Location

Gibt den Speicherort des Endpunkts an, den das Cmdlet hinzufügt. Dies muss ein Azure-Speicherort sein.

Dieser Parameter muss einen Wert für Endpunkte vom Typ "Any" oder vom Typ "TrafficManager" in einem Profil enthalten, für das die Lastenausgleichsmethode auf "Performance" festgelegt ist. Die möglichen Werte sind die Azure-Regionsnamen, wie unter https://azure.microsoft.com/regions/https://azure.microsoft.com/regions/.

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

-MinChildEndpoints

Gibt die Mindestanzahl der Endpunkte an, die das geschachtelte Profil online haben muss, damit dieser Endpunkt online betrachtet wird.

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

-Status

Gibt den Status des Überwachungsendpunkts an. Gültige Werte sind:

  • Aktiviert
  • Disabled

Wenn Sie einen Wert von "Enabled" angeben, überwacht Traffic Manager den Endpunkt, und die Lastenausgleichsmethode berücksichtigt ihn beim Verwalten von Datenverkehr.

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

-TrafficManagerProfile

Gibt das Traffic Manager-Profilobjekt an, für das der Endpunkt geändert werden soll.

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

-Type

Gibt den Endpunkttyp an. Gültige Werte sind:

  • CloudService

  • AzureWebsite

  • TrafficManager

  • Any

Wenn mehrere AzureWebsite-Endpunkte vorhanden sind, müssen sich die Endpunkte in verschiedenen Rechenzentren befinden.

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

-Weight

Gibt die Gewichtung des Endpunkts an, den das Cmdlet hinzufügt. Der gültige Wertbereich für diesen Parameter lautet [1.1000].

Dieser Parameter wird nur für RoundRobin-Lastenausgleichsrichtlinien verwendet.

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, das Informationen zum aktualisierten Profil enthält.