Freigeben über


Add-AzTrafficManagerEndpointConfig

Fügt einem lokalen Traffic Manager-Profilobjekt einen Endpunkt hinzu.

Syntax

Add-AzTrafficManagerEndpointConfig
   -EndpointName <String>
   -TrafficManagerProfile <TrafficManagerProfile>
   -Type <String>
   [-TargetResourceId <String>]
   [-Target <String>]
   -EndpointStatus <String>
   [-Weight <UInt32>]
   [-Priority <UInt32>]
   [-EndpointLocation <String>]
   [-AlwaysServe <String>]
   [-MinChildEndpoints <UInt32>]
   [-MinChildEndpointsIPv4 <UInt32>]
   [-MinChildEndpointsIPv6 <UInt32>]
   [-GeoMapping <System.Collections.Generic.List`1[System.String]>]
   [-SubnetMapping <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerIpAddressRange]>]
   [-CustomHeader <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerCustomHeader]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Add-AzTrafficManagerEndpointConfig-Cmdlet fügt einem lokalen Azure Traffic Manager-Profilobjekt einen Endpunkt hinzu. Sie können ein Profil mithilfe der Cmdlets New-AzTrafficManagerProfile oder Get-AzTrafficManagerProfile abrufen.

Dieses Cmdlet wird für das lokale Profilobjekt ausgeführt. Führen Sie mithilfe des Cmdlets Set-AzTrafficManagerProfile einen Commit für die Änderungen am Profil für Traffic Manager durch. Verwenden Sie das Cmdlet New-AzTrafficManagerEndpoint, um einen Endpunkt zu erstellen und die Änderung in einem einzigen Vorgang zu übernehmen.

Beispiele

Beispiel 1: Hinzufügen eines Endpunkts zu einem Profil

$TrafficManagerProfile = Get-AzTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11"
Add-AzTrafficManagerEndpointConfig -EndpointName "contoso" -EndpointStatus Enabled -Target "www.contoso.com" -TrafficManagerProfile $TrafficManagerProfile -Type ExternalEndpoints -EndpointLocation "North Europe" -Priority 1 -Weight 10
Set-AzTrafficManagerProfile -TrafficManagerProfile $TrafficManagerProfile

Der erste Befehl ruft ein Azure Traffic Manager-Profil mithilfe des Cmdlets "Get-AzTrafficManagerProfile " ab. Der Befehl speichert das lokale Profil in der variablen $TrafficManagerProfile.

Der zweite Befehl fügt dem in $TrafficManagerProfile gespeicherten Profil einen Endpunkt namens "contoso" hinzu. Der Befehl enthält Konfigurationsdaten für den Endpunkt. Dieser Befehl ändert nur das lokale Objekt.

Der letzte Befehl aktualisiert das Traffic Manager-Profil in Azure so, dass er mit dem lokalen Wert in $TrafficManagerProfile übereinstimmt.

Parameter

-AlwaysServe

Wenn Always Serve aktiviert ist, wird die Ermittlung der Endpunktintegrität deaktiviert, und Endpunkte werden in die Datenverkehrsroutingmethode einbezogen.

Typ:String
Zulässige Werte:Enabled, Disabled
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CustomHeader

Liste der benutzerdefinierten Headernamen- und Wertpaare für Prüfpunktanforderungen.

Typ:List<T>[TrafficManagerCustomHeader]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EndpointLocation

Gibt den Speicherort des Endpunkts an, der in der Performance-Datenverkehrsroutingmethode verwendet werden soll. Dieser Parameter gilt nur für Endpunkte des Typs "ExternalEndpoints" oder "NestedEndpoints". Sie müssen diesen Parameter angeben, wenn die Performance-Datenverkehrsroutingmethode verwendet wird.

Geben Sie einen Azure-Regionsnamen an. Eine vollständige Liste der Azure-Regionen finden Sie unter Azure-Regionenhttp://azure.microsoft.com/regions/ (http://azure.microsoft.com/regions/).

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

-EndpointName

Gibt den Namen des Traffic Manager-Endpunkts an, den dieses Cmdlet hinzufügt.

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

-EndpointStatus

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

  • Aktiviert
  • Disabled

Wenn der Status "Aktiviert" ist, wird der Endpunkt auf die Endpunktintegrität untersucht und in der Datenverkehrsroutingmethode enthalten.

Typ:String
Zulässige Werte:Enabled, Disabled
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GeoMapping

Die Liste der Regionen, die diesem Endpunkt zugeordnet sind, wenn die Routingmethode "Geografischer Datenverkehr" verwendet wird. Eine vollständige Liste der akzeptierten Werte finden Sie in der Traffic Manager-Dokumentation.

Typ:List<T>[String]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MinChildEndpoints

Die Mindestanzahl der Endpunkte, die im untergeordneten Profil verfügbar sein müssen, damit der geschachtelte Endpunkt im übergeordneten Profil als verfügbar betrachtet werden kann. Gilt nur für den Endpunkt vom Typ 'NestedEndpoints'.

Typ:Nullable<T>[UInt32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MinChildEndpointsIPv4

Die Mindestanzahl der IPv4-Endpunkte (DNS-Eintragstyp A), die im untergeordneten Profil verfügbar sein müssen, damit der geschachtelte Endpunkt im übergeordneten Profil als verfügbar betrachtet wird. Gilt nur für den Endpunkt vom Typ 'NestedEndpoints'.

Typ:Nullable<T>[UInt32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MinChildEndpointsIPv6

Die Mindestanzahl der IPv6-Endpunkte (DNS-Eintragstyp AAAA), die im untergeordneten Profil verfügbar sein müssen, damit der geschachtelte Endpunkt im übergeordneten Profil als verfügbar betrachtet wird. Gilt nur für den Endpunkt vom Typ 'NestedEndpoints'.

Typ:Nullable<T>[UInt32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Priority

Gibt die Priorität an, die Der Datenverkehrs-Manager dem Endpunkt zuweist. Dieser Parameter wird nur verwendet, wenn das Datenverkehrs-Manager-Profil mit der für die Priorität-Datenverkehrsroutingmethode konfiguriert ist. Gültige Werte sind ganze Zahlen zwischen 1 und 1000. Niedrigere Werte stellen eine höhere Priorität dar.

Wenn Sie eine Priorität angeben, müssen Sie Prioritäten für alle Endpunkte im Profil angeben, und keine zwei Endpunkte können denselben Prioritätswert gemeinsam nutzen. Wenn Sie keine Prioritäten angeben, weist Traffic Manager den Endpunkten Standardwerte zu, beginnend mit einem (1), in der Reihenfolge, in der das Profil die Endpunkte auflistet.

Typ:Nullable<T>[UInt32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SubnetMapping

Die Liste der Adressbereiche oder Subnetze, die diesem Endpunkt bei Verwendung der Routingmethode "Subnetz" zugeordnet sind.

Typ:List<T>[TrafficManagerIpAddressRange]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Target

Gibt den vollqualifizierten DNS-Namen des Endpunkts an. Der Datenverkehrs-Manager gibt diesen Wert in DNS-Antworten zurück, wenn dieser Datenverkehr an diesen Endpunkt leitet. Geben Sie diesen Parameter nur für den Endpunkttyp "ExternalEndpoints" an. Geben Sie für andere Endpunkttypen stattdessen den Parameter TargetResourceId an.

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

-TargetResourceId

Gibt die Ressourcen-ID des Ziels an. Geben Sie diesen Parameter nur für die Endpunkttypen AzureEndpoints und NestedEndpoints an. Geben Sie für den Endpunkttyp "ExternalEndpoints" stattdessen den Parameter "Target " an.

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

-TrafficManagerProfile

Gibt ein lokales TrafficManagerProfile -Objekt an. Dieses Cmdlet ändert dieses lokale Objekt. Verwenden Sie zum Abrufen eines TrafficManagerProfile-Objekts das Cmdlet Get-AzTrafficManagerProfile.

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

-Type

Gibt den Endpunkttyp an, den dieses Cmdlet dem Azure Traffic Manager-Profil hinzufügt. Gültige Werte sind:

  • AzureEndpoints
  • ExternalEndpoints
  • NestedEndpoints
Typ:String
Zulässige Werte:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Weight

Gibt die Gewichtung an, die der Datenverkehrs-Manager dem Endpunkt zuweist. Gültige Werte sind ganze Zahlen zwischen 1 und 1000. Der Standardwert ist ein Wert (1). Dieser Parameter wird nur verwendet, wenn das Traffic Manager-Profil mit der Gewichteten Datenverkehrsroutingmethode konfiguriert ist.

Typ:Nullable<T>[UInt32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

TrafficManagerProfile

Ausgaben

TrafficManagerProfile