Udostępnij za pośrednictwem

Add-AzTrafficManagerEndpointConfig

  • Odwołanie
Moduł:
Az.TrafficManager

Dodaje punkt końcowy do lokalnego obiektu profilu usługi Traffic Manager.

Składnia

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

Opis

Polecenie cmdlet Add-AzTrafficManagerEndpointConfig dodaje punkt końcowy do lokalnego obiektu profilu usługi Azure Traffic Manager. Profil można uzyskać przy użyciu poleceń cmdlet New-AzTrafficManagerProfile lub Get-AzTrafficManagerProfile.

To polecenie cmdlet działa na lokalnym obiekcie profilu. Zatwierdź zmiany w profilu usługi Traffic Manager przy użyciu polecenia cmdlet Set-AzTrafficManagerProfile. Aby utworzyć punkt końcowy i zatwierdzić zmianę w jednej operacji, użyj polecenia cmdlet New-AzTrafficManagerEndpoint.

Przykłady

Przykład 1. Dodawanie punktu końcowego do profilu

$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

Pierwsze polecenie pobiera profil usługi Azure Traffic Manager przy użyciu polecenia cmdlet Get-AzTrafficManagerProfile. Polecenie przechowuje profil lokalny w zmiennej $TrafficManagerProfile.

Drugie polecenie dodaje punkt końcowy o nazwie contoso do profilu przechowywanego w $TrafficManagerProfile. Polecenie zawiera dane konfiguracji punktu końcowego. To polecenie zmienia tylko obiekt lokalny.

Ostatnie polecenie aktualizuje profil usługi Traffic Manager na platformie Azure, aby był zgodny z wartością lokalną w $TrafficManagerProfile.

Parametry

-AlwaysServe

Jeśli opcja Always Serve jest włączona, sondowanie kondycji punktu końcowego zostanie wyłączone, a punkty końcowe zostaną uwzględnione w metodzie routingu ruchu.

Typ:String
Dopuszczalne wartości:Enabled, Disabled
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-CustomHeader

Lista niestandardowych par nagłówków i wartości dla żądań sondy.

Typ:List<T>[TrafficManagerCustomHeader]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EndpointLocation

Określa lokalizację punktu końcowego do użycia w metodzie Routing ruchu wydajności. Ten parametr ma zastosowanie tylko do punktów końcowych typu ExternalEndpoints lub NestedEndpoints. Należy określić ten parametr, gdy jest używana metoda routingu ruchu wydajności.

Określ nazwę regionu platformy Azure. Aby uzyskać pełną listę regionów świadczenia usługi Azure, zobacz Regiony świadczenia usługi Azurehttp://azure.microsoft.com/regions/ (http://azure.microsoft.com/regions/).

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EndpointName

Określa nazwę punktu końcowego usługi Traffic Manager, który dodaje to polecenie cmdlet.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EndpointStatus

Określa stan punktu końcowego. Prawidłowe wartości to:

  • Włączone
  • Niepełnosprawny

Jeśli stan to Włączone, punkt końcowy jest sondowany pod kątem kondycji punktu końcowego i jest uwzględniony w metodzie routingu ruchu.

Typ:String
Dopuszczalne wartości:Enabled, Disabled
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-GeoMapping

Lista regionów zamapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu geograficznego. Zapoznaj się z dokumentacją usługi Traffic Manager, aby uzyskać pełną listę akceptowanych wartości.

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MinChildEndpoints

Minimalna liczba punktów końcowych, które muszą być dostępne w profilu podrzędnym, aby punkt końcowy zagnieżdżony w profilu nadrzędnym był uznawany za dostępny. Dotyczy tylko punktu końcowego typu "NestedEndpoints".

Typ:Nullable<T>[UInt32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MinChildEndpointsIPv4

Minimalna liczba punktów końcowych IPv4 (typu rekordu DNS A), które muszą być dostępne w profilu podrzędnym, aby punkt końcowy zagnieżdżony w profilu nadrzędnym był uznawany za dostępny. Dotyczy tylko punktu końcowego typu "NestedEndpoints".

Typ:Nullable<T>[UInt32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MinChildEndpointsIPv6

Minimalna liczba punktów końcowych IPv6 (typu rekordu DNS AAAA), które muszą być dostępne w profilu podrzędnym, aby punkt końcowy zagnieżdżony w profilu nadrzędnym był uznawany za dostępny. Dotyczy tylko punktu końcowego typu "NestedEndpoints".

Typ:Nullable<T>[UInt32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Priority

Określa priorytet przypisywany przez usługę Traffic Manager do punktu końcowego. Ten parametr jest używany tylko wtedy, gdy profil usługi Traffic Manager jest skonfigurowany przy użyciu metody priorytetowego routingu ruchu. Prawidłowe wartości to liczby całkowite z zakresu od 1 do 1000. Niższe wartości reprezentują wyższy priorytet.

Jeśli określisz priorytet, musisz określić priorytety dla wszystkich punktów końcowych w profilu, a żadne dwa punkty końcowe nie mogą współdzielić tej samej wartości priorytetu. Jeśli nie określisz priorytetów, usługa Traffic Manager przypisze domyślne wartości priorytetów do punktów końcowych, począwszy od jednego (1), w kolejności, w której profil wyświetla listę punktów końcowych.

Typ:Nullable<T>[UInt32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SubnetMapping

Lista zakresów adresów lub podsieci zamapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu "Podsieć".

Typ:List<T>[TrafficManagerIpAddressRange]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Target

Określa w pełni kwalifikowaną nazwę DNS punktu końcowego. Usługa Traffic Manager zwraca tę wartość w odpowiedziACH DNS, gdy kieruje ruch do tego punktu końcowego. Określ ten parametr tylko dla typu punktu końcowego ExternalEndpoints. W przypadku innych typów punktów końcowych określ zamiast tego parametr TargetResourceId.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetResourceId

Określa identyfikator zasobu obiektu docelowego. Określ ten parametr tylko dla typów punktów końcowych AzureEndpoints i NestedEndpoints. Dla typu punktu końcowego ExternalEndpoints określ parametr Target.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TrafficManagerProfile

Określa lokalny obiekt TrafficManagerProfile. To polecenie cmdlet modyfikuje ten obiekt lokalny. Aby uzyskać obiekt TrafficManagerProfile, użyj polecenia cmdlet Get-AzTrafficManagerProfile.

Typ:TrafficManagerProfile
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Type

Określa typ punktu końcowego, który to polecenie cmdlet dodaje do profilu usługi Azure Traffic Manager. Prawidłowe wartości to:

  • AzureEndpoints
  • Punkty zewnętrzne
  • Zagnieżdżone punkty końcowe
Typ:String
Dopuszczalne wartości:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Weight

Określa wagę przypisywaną przez usługę Traffic Manager do punktu końcowego. Prawidłowe wartości to liczby całkowite z zakresu od 1 do 1000. Wartość domyślna to jedna (1). Ten parametr jest używany tylko wtedy, gdy profil usługi Traffic Manager jest skonfigurowany przy użyciu metody routingu ważonego ruchu.

Typ:Nullable<T>[UInt32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

TrafficManagerProfile

Dane wyjściowe

TrafficManagerProfile