Add-AzureTrafficManagerEndpoint

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

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.

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/.

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:True
Accept pipeline input:False
Accept wildcard characters:False

-TrafficManagerProfile

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

  • Beliebig

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

Type:String
Position:Named
Default value:None
Required:True
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.