Set-AzureTrafficManagerProfile
Aktualisiert die Eigenschaften eines Traffic Manager-Profils.
Hinweis
Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.
Syntax
Set-AzureTrafficManagerProfile
[-Name <String>]
[-LoadBalancingMethod <String>]
[-MonitorPort <Int32>]
[-MonitorProtocol <String>]
[-MonitorRelativePath <String>]
[-Ttl <Int32>]
-TrafficManagerProfile <IProfileWithDefinition>
[-Profile <AzureSMProfile>]
[<CommonParameters>] Beschreibung
Das Cmdlet Set-AzureTrafficManagerProfile aktualisiert die Eigenschaften eines Microsoft Azure Traffic Manager-Profils.
Für Profile, für die Sie den LoadBalancingMethod-Wert auf "Failover" festgelegt haben, können Sie die Failoverreihenfolge der Endpunkte bestimmen, die Sie Ihrem Profil mit dem Add-AzureTrafficManagerEndpoint-Cmdlet hinzugefügt haben. Weitere Informationen finden Sie in Beispiel 3 unten.
Beispiele
Beispiel 1: Festlegen der TTL für ein Traffic Manager-Profil
PS C:\>Set-AzureTrafficManagerProfile -TrafficManagerProfile $MyTrafficManagerProfile -Ttl 60Mit diesem Befehl wird die TTL auf 60 Sekunden für das Traffic Manager-Profilobjekt MyTrafficManagerProfile festgelegt.
Beispiel 2: Festlegen mehrerer Werte für ein Profil
PS C:\>Get-AzureTrafficManagerProfile -Name "MyProfile" | Set-AzureTrafficManagerProfile -LoadBalancingMethod "RoundRobin" -Ttl 30 -MonitorProtocol "Http" -MonitorPort 80 -MonitorRelativePath "/"Mit diesem Befehl wird ein Traffic Manager-Profil namens "MyProfile" mithilfe des Cmdlets "Get-AzureTrafficManagerProfile " abgerufen. Das Profil verwendet die RoundRobin-Lastenausgleichsmethode, eine TTL von 30 Sekunden, das Monitorprotokoll HTTP, den Monitorport und den relativen Pfad für ein Traffic Manager-Profil.
Beispiel 3: Neuanordnen von Endpunkten an die gewünschte Failoverreihenfolge
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-AzureTrafficManagerProfileIn diesem Beispiel werden die Endpunkte neu angeordnet, die myProfile zur gewünschten Failoverreihenfolge hinzugefügt wurden.
Der erste Befehl ruft das Traffic Manager-Profilobjekt mit dem Namen MyProfile ab und speichert das Objekt in der variablen $Profile.
Der zweite Befehl sortiert die Endpunkte aus dem Endpunktarray erneut in die Reihenfolge, in der Failover ausgeführt werden soll.
Der letzte Befehl aktualisiert das in $Profile gespeicherte Traffic Manager-Profil mit der neuen Endpunktreihenfolge.
Parameter
-LoadBalancingMethod
Gibt die Lastenausgleichsmethode an, die zum Verteilen der Verbindung verwendet werden soll. Gültige Werte sind:
- Leistung
- Failover
- RoundRobin
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MonitorPort
Gibt den Port an, der zum Überwachen der Endpunktintegrität verwendet wird. Gültige Werte sind ganzzahlige Werte, die größer als 0 und kleiner als oder gleich 65.535 sind.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MonitorProtocol
Gibt das Protokoll an, mit dem die Endpunktintegrität überwacht werden soll. Gültige Werte sind:
- Http
- HTTPS
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MonitorRelativePath
Gibt den Pfad relativ zum Endpunktdomänennamen an, um den Integritätszustand zu untersuchen. Der Pfad muss die folgenden Einschränkungen erfüllen:
- Der Pfad muss zwischen 1 und 1000 Zeichen bestehen.
- Er muss mit einem Schrägstrich /beginnen.
- Sie darf keine XML-Elemente enthalten. <>
- Er darf keine Doppelstriche enthalten, //.
- Sie darf keine ungültigen HTML-Escapezeichen enthalten. Beispiel: %XY.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Gibt den Namen des zu aktualisierenden Traffic Manager-Profils an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TrafficManagerProfile
Gibt das Traffic Manager-Profilobjekt an, das Sie zum Festlegen des Profils verwenden.
| Type: | IProfileWithDefinition |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Ttl
Gibt die DNS-Time-to-Live (TTL) an, die die lokalen DNS-Resolver darüber informiert, wie lange DNS-Einträge zwischengespeichert werden sollen. Gültige Werte sind eine ganze Zahl zwischen 30 und 999.999.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Ausgaben
Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition
Dieses Cmdlet generiert ein Traffic Manager-Profilobjekt.