Freigeben über

Add-AzureTrafficManagerEndpoint

  • Referenz
Modul:
Azure

Fügt einem Traffic Manager-Profil einen Endpunkt hinzu.

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

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

Beschreibung

Das Add-AzureTrafficManagerEndpoint-Cmdlet fügt einem Microsoft Azure Traffic Manager-Profil einen Endpunkt hinzu. 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: Hinzufügen eines Endpunkts zu einem Profil

PS C:\>$TrafficManagerProfile = Get-AzureTrafficManagerProfile -Name "ContosoProfile"
PS C:\> Add-AzureTrafficManagerEndpoint -TrafficManagerProfile $TrafficManagerProfile -DomainName "Contoso02App.cloudapp.net" -Status "Enabled" -Type "CloudService" | 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 fügt einen Endpunkt zum Traffic Manager-Profil hinzu, das in $TrafficManagerProfile gespeichert ist. Der Endpunkt hat den Domänennamen Contoso02App.couldapp.net. Der Befehl gibt außerdem an, ob er aktiviert ist, und dessen Typ. Der Befehl übergibt das Profilobjekt an das Cmdlet Set-AzureTrafficManagerProfile , um eine Verbindung mit Azure herzustellen, um Ihre Änderungen zu speichern.

Beispiel 2: Hinzufügen eines Endpunkts mit einer angegebenen Position und Gewichtung

PS C:\>Add-AzureTrafficManagerEndpoint -TrafficManagerProfile ContosoTrafficManagerProfile -DomainName " Contoso02App.cloudapp.net" -Status Enabled -Type CloudService -Weight 2 -Location myLocation | Set-AzureTrafficManagerProfile

Mit diesem Befehl wird einem Traffic Manager-Profil ein Endpunkt hinzugefügt. Der Endpunkt hat den Domänennamen Contoso02App.couldapp.net. Der Befehl gibt außerdem an, ob er aktiviert ist, und dessen Typ. Der Befehl gibt auch die Gewichtung und Position für den Endpunkt an. Der Befehl übergibt das Profilobjekt an Set-AzureTrafficManagerProfile , um eine Verbindung mit Azure herzustellen, um Ihre Änderungen zu speichern.

Parameter

-DomainName

Gibt den Domänennamen des hinzuzufügenden 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/.

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

-TrafficManagerProfile

Gibt das Traffic Manager-Profilobjekt an, dem der Endpunkt hinzugefügt 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:True
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.