Freigeben über


New-AzTrafficManagerEndpoint

Erstellt einen Endpunkt in einem Traffic Manager-Profil.

Syntax

New-AzTrafficManagerEndpoint
   -Name <String>
   -ProfileName <String>
   -ResourceGroupName <String>
   -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 Cmdlet New-AzTrafficManagerEndpoint erstellt einen Endpunkt in einem Azure Traffic Manager-Profil.

Mit diesem Cmdlet wird jeder neue Endpunkt an den Traffic Manager-Dienst übergeben. Verwenden Sie das Add-AzTrafficManagerEndpointConfig-Cmdlet, um einem lokalen Traffic Manager-Profilobjekt mehrere Endpunkte hinzuzufügen und Änderungen in einem einzelnen Vorgang zu übernehmen.

Beispiele

Beispiel 1: Erstellen eines externen Endpunkts für ein Profil

New-AzTrafficManagerEndpoint -EndpointStatus Enabled -Name "contoso" -ProfileName "ContosoProfile" -ResourceGroupName "ResourceGroup11" -Type ExternalEndpoints -EndpointLocation "North Europe" -Priority 1 -Target "www.contoso.com" -Weight 10

Mit diesem Befehl wird ein externer Endpunkt namens "contoso" im Profil "ContosoProfile" in der Ressourcengruppe "ResourceGroup11" erstellt.

Beispiel 2: Erstellen eines Azure-Endpunkts für ein Profil

New-AzTrafficManagerEndpoint -EndpointStatus Enabled -Name "contoso" -ProfileName "ContosoProfile" -ResourceGroupName "ResourceGroup11" -Type AzureEndpoints -Priority 1 -TargetResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Default-Web-CentralUS/providers/Microsoft.Web/sites/contoso-web-app" -Weight 10

Mit diesem Befehl wird ein Azure-Endpunkt namens "contoso" im Profil "ContosoProfile" in der Ressourcengruppe "ResourceGroup11" erstellt. Der Azure-Endpunkt verweist auf die Azure Web App, deren Azure Resource Manager-ID vom URI-Pfad in TargetResourceId angegeben wird. Der Befehl gibt den EndpointLocation-Parameter nicht an, da die Web App-Ressource den Speicherort bereitstellt.

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

-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

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: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

-Name

Gibt den Namen des Traffic Manager-Endpunkts an, den dieses Cmdlet erstellt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
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

-ProfileName

Gibt den Namen eines Traffic Manager-Profils an, dem dieses Cmdlet einen Endpunkt hinzufügt. Verwenden Sie zum Abrufen eines Profils die Cmdlets New-AzTrafficManagerProfile oder Get-AzTrafficManagerProfile.

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

-ResourceGroupName

Gibt den Namen einer Ressourcengruppe an. Dieses Cmdlet erstellt einen Traffic Manager-Endpunkt in der Gruppe, die dieser Parameter angibt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
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

-Type

Gibt den Endpunkttyp an, den dieses Cmdlet dem 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

None

Ausgaben

TrafficManagerEndpoint