Freigeben über

Add-AzTrafficManagerEndpointConfig

Modul:
Az.TrafficManager Module

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

Syntax

Default (Standard) 

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. Übernehmen Sie ihre Änderungen am Profil für Traffic Manager mithilfe des Cmdlets Set-AzTrafficManagerProfile. Um einen Endpunkt zu erstellen und die Änderung in einem einzelnen Vorgang zu übernehmen, verwenden Sie das cmdlet New-AzTrafficManagerEndpoint.

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.

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:Enabled, Disabled
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CustomHeader

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

Parametereigenschaften

Typ:

List<T>[TrafficManagerCustomHeader]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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/).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EndpointName

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EndpointStatus

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

  • Enabled
  • Disabled

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

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:Enabled, Disabled
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

List<T>[String]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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'.

Parametereigenschaften

Typ:

Nullable<T>[UInt32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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'.

Parametereigenschaften

Typ:

Nullable<T>[UInt32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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'.

Parametereigenschaften

Typ:

Nullable<T>[UInt32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

Nullable<T>[UInt32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SubnetMapping

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

Parametereigenschaften

Typ:

List<T>[TrafficManagerIpAddressRange]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:TrafficManagerProfile
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Type

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

  • AzureEndpoints
  • ExternalEndpoints
  • NestedEndpoints

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

Nullable<T>[UInt32]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

TrafficManagerProfile

Ausgaben

TrafficManagerProfile