New-AzTrafficManagerEndpoint
Tworzy punkt końcowy w profilu usługi Traffic Manager.
Składnia
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>] Opis
Polecenie cmdlet New-AzTrafficManagerEndpoint tworzy punkt końcowy w profilu usługi Azure Traffic Manager.
To polecenie cmdlet zatwierdza każdy nowy punkt końcowy w usłudze Traffic Manager. Aby dodać wiele punktów końcowych do lokalnego obiektu profilu usługi Traffic Manager i zatwierdzić zmiany w jednej operacji, użyj polecenia cmdlet Add-AzTrafficManagerEndpointConfig.
Przykłady
Przykład 1. Tworzenie zewnętrznego punktu końcowego dla profilu
New-AzTrafficManagerEndpoint -EndpointStatus Enabled -Name "contoso" -ProfileName "ContosoProfile" -ResourceGroupName "ResourceGroup11" -Type ExternalEndpoints -EndpointLocation "North Europe" -Priority 1 -Target "www.contoso.com" -Weight 10To polecenie tworzy zewnętrzny punkt końcowy o nazwie contoso w profilu o nazwie ContosoProfile w grupie zasobów o nazwie ResourceGroup11.
Przykład 2. Tworzenie punktu końcowego platformy Azure dla profilu
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 10To polecenie tworzy punkt końcowy platformy Azure o nazwie contoso w profilu o nazwie ContosoProfile w grupie zasobów ResourceGroup11. Punkt końcowy platformy Azure wskazuje aplikację internetową platformy Azure, której identyfikator usługi Azure Resource Manager jest podawany przez ścieżkę identyfikatora URI w TargetResourceId. Polecenie nie określa parametru EndpointLocation, ponieważ zasób aplikacji internetowej dostarcza lokalizację.
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 |
-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. Aby uzyskać pełną listę akceptowanych wartości, zapoznaj się z dokumentacją usługi Traffic Manager.
| Typ: | List<T>[String] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-MinChildEndpoints
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: | 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 |
-Name
Określa nazwę punktu końcowego usługi Traffic Manager, który tworzy to polecenie cmdlet.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| 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 |
-ProfileName
Określa nazwę profilu usługi Traffic Manager, do którego to polecenie cmdlet dodaje punkt końcowy. Aby uzyskać profil, użyj poleceń cmdlet New-AzTrafficManagerProfile lub Get-AzTrafficManagerProfile.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ResourceGroupName
Określa nazwę grupy zasobów. To polecenie cmdlet tworzy punkt końcowy usługi Traffic Manager w grupie, która określa ten parametr.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| 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 |
-Type
Określa typ punktu końcowego, który to polecenie cmdlet dodaje do profilu usługi 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
None
