New-AzTrafficManagerEndpoint

  • Referenz
Modul:
Az.TrafficManager

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.

Type:String
Accepted values:Enabled, Disabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomHeader

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

Type:List<T>[TrafficManagerCustomHeader]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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/).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Accepted values:Enabled, Disabled
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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/).

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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'.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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'.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SubnetMapping

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

Type:List<T>[TrafficManagerIpAddressRange]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Type

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

  • AzureEndpoints
  • ExternalEndpoints
  • NestedEndpoints
Type:String
Accepted values:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

TrafficManagerEndpoint