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 Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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/.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinChildEndpoints

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

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

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TrafficManagerProfile

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

Type:IProfileWithDefinition
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Ausgaben

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

Dieses Cmdlet generiert ein Traffic Manager-Profilobjekt, das Informationen zum aktualisierten Profil enthält.