Udostępnij za pośrednictwem

Set-AzureTrafficManagerProfile

  • Odwołanie
Moduł:
Azure

Aktualizuje właściwości profilu usługi Traffic Manager.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

Set-AzureTrafficManagerProfile
   [-Name <String>]
   [-LoadBalancingMethod <String>]
   [-MonitorPort <Int32>]
   [-MonitorProtocol <String>]
   [-MonitorRelativePath <String>]
   [-Ttl <Int32>]
   -TrafficManagerProfile <IProfileWithDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzureTrafficManagerProfile aktualizuje właściwości profilu usługi Microsoft Azure Traffic Manager.

W przypadku profilów, dla których ustawiono wartość LoadBalancingMethod na "Tryb failover", możesz określić kolejność trybu failover punktów końcowych dodanych do profilu za pomocą polecenia cmdlet Add-AzureTrafficManagerEndpoint. Aby uzyskać więcej informacji, zobacz przykład 3 poniżej.

Przykłady

Przykład 1. Ustawianie czasu wygaśnięcia dla profilu usługi Traffic Manager

PS C:\>Set-AzureTrafficManagerProfile -TrafficManagerProfile $MyTrafficManagerProfile -Ttl 60

To polecenie ustawia czas wygaśnięcia na 60 sekund dla obiektu profilu usługi Traffic Manager MyTrafficManagerProfile.

Przykład 2. Ustawianie kilku wartości dla profilu

PS C:\>Get-AzureTrafficManagerProfile -Name "MyProfile" | Set-AzureTrafficManagerProfile -LoadBalancingMethod "RoundRobin" -Ttl 30 -MonitorProtocol "Http" -MonitorPort 80 -MonitorRelativePath "/"

To polecenie pobiera profil usługi Traffic Manager o nazwie MyProfile przy użyciu polecenia cmdlet Get-AzureTrafficManagerProfile . Profil używa metody równoważenia obciążenia RoundRobin, czasu wygaśnięcia 30 sekund, protokołu monitora HTTP, portu monitora i ścieżki względnej dla profilu usługi Traffic Manager.

Przykład 3. Zmiana kolejności punktów końcowych na żądaną kolejność trybu failover

PS C:\>$Profile = Get-AzureTrafficManagerProfile -Name "MyProfile"
PS C:\> $Profile.Endpoints[0],$Profile.Endpoints[1] = $Profile.Endpoints[1],$Profile.Endpoints[0]
PS C:\> $Profile = Set-AzureTrafficManagerProfile

Ten przykład zmienia kolejność punktów końcowych dodanych do pliku MyProfile do żądanej kolejności trybu failover.

Pierwsze polecenie pobiera obiekt profilu usługi Traffic Manager o nazwie MyProfile i przechowuje obiekt w zmiennej $Profile.

Drugie polecenie ponownie porządkuje punkty końcowe z tablicy punktów końcowych na kolejność, w której powinno nastąpić przejście w tryb failover.

Ostatnie polecenie aktualizuje profil usługi Traffic Manager przechowywany w $Profile przy użyciu nowej kolejności punktów końcowych.

Parametry

-LoadBalancingMethod

Określa metodę równoważenia obciążenia, która ma być używana do dystrybucji połączenia. Prawidłowe wartości to:

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

-MonitorPort

Określa port używany do monitorowania kondycji punktu końcowego. Prawidłowe wartości to wartości całkowite większe niż 0 i mniejsze niż lub równe 65 535.

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

-MonitorProtocol

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

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

-MonitorRelativePath

Określa ścieżkę względem nazwy domeny punktu końcowego do sondowania stanu kondycji. Ścieżka musi spełniać następujące ograniczenia:

  • Ścieżka musi zawierać od 1 do 1000 znaków.
  • Musi zaczynać się od ukośnika do przodu, /.
  • Nie może zawierać żadnych elementów XML, <>.
  • Nie może zawierać podwójnych ukośników, //.
  • Nie może zawierać nieprawidłowych znaków ucieczki HTML. Na przykład %XY.
Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę profilu usługi Traffic Manager do zaktualizowania.

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

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

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

-TrafficManagerProfile

Określa obiekt profilu usługi Traffic Manager używany do ustawiania profilu.

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

-Ttl

Określa czas wygaśnięcia (TTL) DNS, który informuje lokalne rozpoznawanie nazw DNS, jak długo buforować wpisy DNS. Prawidłowe wartości to liczba całkowita z zakresu od 30 do 999 999 999.

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

Dane wyjściowe

Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition

To polecenie cmdlet generuje obiekt profilu usługi Traffic Manager.