Dela via


Add-AzTrafficManagerEndpointConfig

Lägger till en slutpunkt i ett lokalt Traffic Manager-profilobjekt.

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

Description

Cmdleten Add-AzTrafficManagerEndpointConfig lägger till en slutpunkt i ett lokalt Azure Traffic Manager-profilobjekt. Du kan hämta en profil med hjälp av cmdletarna New-AzTrafficManagerProfile eller Get-AzTrafficManagerProfile.

Den här cmdleten fungerar på det lokala profilobjektet. Checka in dina ändringar i profilen för Traffic Manager med hjälp av cmdleten Set-AzTrafficManagerProfile. Om du vill skapa en slutpunkt och genomföra ändringen i en enda åtgärd använder du cmdleten New-AzTrafficManagerEndpoint.

Exempel

Exempel 1: Lägga till en slutpunkt i en 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

Det första kommandot hämtar en Azure Traffic Manager-profil med hjälp av cmdleten Get-AzTrafficManagerProfile . Kommandot lagrar den lokala profilen i variabeln $TrafficManagerProfile.

Det andra kommandot lägger till en slutpunkt med namnet contoso till profilen som lagras i $TrafficManagerProfile. Kommandot innehåller konfigurationsdata för slutpunkten. Det här kommandot ändrar endast det lokala objektet.

Det sista kommandot uppdaterar Traffic Manager-profilen i Azure så att den matchar det lokala värdet i $TrafficManagerProfile.

Parametrar

-AlwaysServe

Om Always Serve är aktiverat inaktiveras avsökning för slutpunktshälsa och slutpunkter inkluderas i trafikroutningsmetoden.

Typ:String
Godkända värden:Enabled, Disabled
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CustomHeader

Lista över anpassade rubriknamn och värdepar för avsökningsbegäranden.

Typ:List<T>[TrafficManagerCustomHeader]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EndpointLocation

Anger platsen för slutpunkten som ska användas i trafikdirigeringsmetoden Prestanda. Den här parametern gäller endast för slutpunkter av typen ExternalEndpoints eller NestedEndpoints. Du måste ange den här parametern när trafikdirigeringsmetoden Prestanda används.

Ange ett Namn på Azure-region. En fullständig lista över Azure-regioner finns i Azure-regionerhttp://azure.microsoft.com/regions/ (http://azure.microsoft.com/regions/).

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EndpointName

Anger namnet på den Traffic Manager-slutpunkt som den här cmdleten lägger till.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EndpointStatus

Anger slutpunktens status. Giltiga värden är:

  • Aktiverat
  • Inaktiverat

Om statusen är Aktiverad avsöks slutpunkten för slutpunktshälsa och ingår i trafikroutningsmetoden.

Typ:String
Godkända värden:Enabled, Disabled
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-GeoMapping

Listan över regioner som mappas till den här slutpunkten när du använder trafikroutningsmetoden "Geografisk". En fullständig lista över godkända värden finns i Traffic Manager-dokumentationen.

Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MinChildEndpoints

Det minsta antalet slutpunkter som måste vara tillgängliga i den underordnade profilen för att den kapslade slutpunkten i den överordnade profilen ska anses vara tillgänglig. Gäller endast för slutpunkten av typen "NestedEndpoints".

Typ:Nullable<T>[UInt32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MinChildEndpointsIPv4

Det minsta antalet IPv4-slutpunkter (DNS-posttyp A) som måste vara tillgängliga i den underordnade profilen för att den kapslade slutpunkten i den överordnade profilen ska anses vara tillgänglig. Gäller endast för slutpunkten av typen "NestedEndpoints".

Typ:Nullable<T>[UInt32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MinChildEndpointsIPv6

Det minsta antalet IPv6-slutpunkter (DNS-posttyp AAAA) som måste vara tillgängliga i den underordnade profilen för att den kapslade slutpunkten i den överordnade profilen ska anses vara tillgänglig. Gäller endast för slutpunkten av typen "NestedEndpoints".

Typ:Nullable<T>[UInt32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Priority

Anger den prioritet som Traffic Manager tilldelar slutpunkten. Den här parametern används endast om Traffic Manager-profilen har konfigurerats med trafikdirigeringsmetoden för prioritet. Giltiga värden är heltal mellan 1 och 1 000. Lägre värden representerar högre prioritet.

Om du anger en prioritet måste du ange prioriteter för alla slutpunkter i profilen och inga två slutpunkter kan dela samma prioritetsvärde. Om du inte anger prioriteringar tilldelar Traffic Manager standardprioritetsvärden till slutpunkterna, från och med en (1), i den ordning profilen visar slutpunkterna.

Typ:Nullable<T>[UInt32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SubnetMapping

Listan över adressintervall eller undernät som mappats till den här slutpunkten när du använder trafikroutningsmetoden "Undernät".

Typ:List<T>[TrafficManagerIpAddressRange]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Target

Anger slutpunktens fullständigt kvalificerade DNS-namn. Traffic Manager returnerar det här värdet i DNS-svar när det dirigerar trafik till den här slutpunkten. Ange endast den här parametern för slutpunktstypen ExternalEndpoints. För andra slutpunktstyper anger du parametern TargetResourceId i stället.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TargetResourceId

Anger resurs-ID för målet. Ange endast den här parametern för slutpunktstyperna AzureEndpoints och NestedEndpoints. För slutpunktstypen ExternalEndpoints anger du parametern Target i stället.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TrafficManagerProfile

Anger ett lokalt TrafficManagerProfile-objekt . Den här cmdleten ändrar det här lokala objektet. Om du vill hämta ett TrafficManagerProfile-objekt använder du cmdleten Get-AzTrafficManagerProfile.

Typ:TrafficManagerProfile
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Type

Anger vilken typ av slutpunkt som den här cmdleten lägger till i Azure Traffic Manager-profilen. Giltiga värden är:

  • AzureEndpoints
  • ExternalEndpoints
  • NestedEndpoints
Typ:String
Godkända värden:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Weight

Anger den vikt som Traffic Manager tilldelar slutpunkten. Giltiga värden är heltal mellan 1 och 1 000. Standardvärdet är ett (1). Den här parametern används endast om Traffic Manager-profilen har konfigurerats med metoden Viktad trafikroutning.

Typ:Nullable<T>[UInt32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

TrafficManagerProfile

Utdata

TrafficManagerProfile