Udostępnij przez


New-AzTrafficManagerProfile

Tworzy profil usługi Traffic Manager.

Składnia

Default (domyślnie)

New-AzTrafficManagerProfile
    -Name <String>
    -ResourceGroupName <String>
    [-ProfileStatus <String>]
    -RelativeDnsName <String>
    -Ttl <UInt32>
    -TrafficRoutingMethod <String>
    -MonitorProtocol <String>
    -MonitorPort <UInt32>
    [-MonitorPath <String>]
    [-MonitorIntervalInSeconds <Int32>]
    [-MonitorTimeoutInSeconds <Int32>]
    [-MonitorToleratedNumberOfFailures <Int32>]
    [-MaxReturn <Int64>]
    [-Tag <Hashtable>]
    [-CustomHeader <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerCustomHeader]>]
    [-ExpectedStatusCodeRange <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerExpectedStatusCodeRange]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Opis

Polecenie cmdlet New-AzTrafficManagerProfile tworzy profil usługi Azure Traffic Manager. Określ parametr Name i wymagane ustawienia. To polecenie cmdlet zwraca obiekt lokalny reprezentujący nowy profil.

To polecenie cmdlet nie konfiguruje punktów końcowych usługi Traffic Manager. Obiekt profilu lokalnego można zaktualizować przy użyciu polecenia cmdlet Add-AzTrafficManagerEndpointConfig. Następnie przekaż zmiany do usługi Traffic Manager przy użyciu polecenia cmdlet Set-AzTrafficManagerProfile. Alternatywnie można dodawać punkty końcowe przy użyciu polecenia cmdlet New-AzTrafficManagerEndpoint.

Przykłady

Przykład 1. Tworzenie profilu

New-AzTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11" -ProfileStatus Enabled -TrafficRoutingMethod Performance -RelativeDnsName "contosoapp" -TTL 30 -MonitorProtocol HTTP -MonitorPort 80 -MonitorPath "/default.aspx"

To polecenie tworzy profil usługi Azure Traffic Manager o nazwie ContosoProfile w grupie zasobów ResourceGroup11. Nazwa FQDN DNS jest contosoapp.trafficmanager.net.

Parametry

-CustomHeader

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

Właściwości parametru

Typ:

List<T>[TrafficManagerCustomHeader]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ExpectedStatusCodeRange

Lista oczekiwanych zakresów kodów stanu HTTP dla żądań sondowania.

Właściwości parametru

Typ:

List<T>[TrafficManagerExpectedStatusCodeRange]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MaxReturn

Maksymalna liczba odpowiedzi zwracanych dla profilów z metodą routingu MultiValue.

Właściwości parametru

Typ:

Nullable<T>[Int64]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MonitorIntervalInSeconds

Interwał (w sekundach), w którym usługa Traffic Manager sprawdzi kondycję każdego punktu końcowego w tym profilu. Wartość domyślna to 30.

Właściwości parametru

Typ:

Nullable<T>[Int32]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:IntervalInSecondsForMonitor

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MonitorPath

Określa ścieżkę używaną do monitorowania kondycji punktu końcowego. Określ wartość względem nazwy domeny punktu końcowego. Ta wartość musi zaczynać się od ukośnika (/).

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:PathForMonitor

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MonitorPort

Określa port TCP używany do monitorowania kondycji punktu końcowego. Prawidłowe wartości to liczby całkowite z zakresu od 1 do 65535.

Właściwości parametru

Typ:UInt32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:PortForMonitor

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MonitorProtocol

Określa protokół używany do monitorowania kondycji punktu końcowego. Prawidłowe wartości to:

  • HTTP
  • HTTPS

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:HTTP, HTTPS, TCP
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:ProtocolForMonitor

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MonitorTimeoutInSeconds

Czas (w sekundach), przez który usługa Traffic Manager zezwala punktom końcowym w tym profilu na reagowanie na kontrolę kondycji. Wartość domyślna to 10.

Właściwości parametru

Typ:

Nullable<T>[Int32]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:TimeoutInSecondsForMonitor

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MonitorToleratedNumberOfFailures

Liczba kolejnych zakończonych niepowodzeniem kontroli kondycji tolerowanych przez usługę Traffic Manager przed zadeklarowaniem punktu końcowego w tym profilu Obniżona wydajność po następnym kolejnym nieudanym sprawdzeniu kondycji. Wartość domyślna to 3.

Właściwości parametru

Typ:

Nullable<T>[Int32]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:TolerowanenumberOfFailuresForMonitor

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Określa nazwę profilu usługi Traffic Manager, który tworzy to polecenie cmdlet.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ProfileStatus

Określa stan profilu. Prawidłowe wartości to: Włączone i Wyłączone.

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:Enabled, Disabled
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-RelativeDnsName

Określa względną nazwę DNS podaną przez ten profil usługi Traffic Manager. Usługa Traffic Manager łączy tę wartość i nazwę domeny DNS używaną przez usługę Azure Traffic Manager do utworzenia w pełni kwalifikowanej nazwy domeny (FQDN) profilu.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ResourceGroupName

Określa nazwę grupy zasobów. To polecenie cmdlet tworzy profil usługi Traffic Manager w grupie, która określa ten parametr.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Tag

Pary klucz-wartość w postaci tabeli skrótów ustawione jako tagi na serwerze. Przykład:

@{key0="value0"; key1=$null; key2="value2"}

Właściwości parametru

Typ:Hashtable
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Etykiety

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-TrafficRoutingMethod

Określa metodę routingu ruchu. Ta metoda określa, który punkt końcowy usługi Traffic Manager zwraca w odpowiedzi na przychodzące zapytania DNS. Prawidłowe wartości to:

  • Performance
  • Weighted
  • Priority
  • Geograficzny

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:Performance, Weighted, Priority, Geographic, Subnet, MultiValue
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Ttl

Określa wartość czasu wygaśnięcia (TTL) DNS.

Właściwości parametru

Typ:UInt32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

None

Dane wyjściowe

TrafficManagerProfile