Delen via

Set-AzureTrafficManagerProfile

  • Referentie
Module:
Azure

Hiermee worden de eigenschappen van een Traffic Manager-profiel bijgewerkt.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntax

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

Description

De cmdlet Set-AzureTrafficManagerProfile werkt de eigenschappen van een Microsoft Azure Traffic Manager-profiel bij.

Voor profielen waarvoor u de waarde LoadBalancingMethod hebt ingesteld op Failover, kunt u de failovervolgorde bepalen van de eindpunten die u aan uw profiel hebt toegevoegd met de cmdlet Add-AzureTrafficManagerEndpoint. Zie voorbeeld 3 hieronder voor meer informatie.

Voorbeelden

Voorbeeld 1: De TTL instellen voor een Traffic Manager-profiel

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

Met deze opdracht wordt de TTL ingesteld op 60 seconden voor het Traffic Manager-profielobject MyTrafficManagerProfile.

Voorbeeld 2: Verschillende waarden instellen voor een profiel

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

Met deze opdracht wordt een Traffic Manager-profiel met de naam MyProfile opgevraagd met behulp van de cmdlet Get-AzureTrafficManagerProfile . Het profiel maakt gebruik van de RoundRobin-taakverdelingsmethode, een TTL van 30 seconden, het monitorprotocol HTTP, de monitorpoort en het relatieve pad voor een Traffic Manager-profiel.

Voorbeeld 3: Eindpunten opnieuw ordenen in gewenste failovervolgorde

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

In dit voorbeeld worden de eindpunten die aan MyProfile zijn toegevoegd, opnieuw gerangschikt in de gewenste failovervolgorde.

Met de eerste opdracht wordt het Traffic Manager-profielobject met de naam MyProfile opgehaald en wordt het object opgeslagen in de $Profile variabele.

Met de tweede opdracht worden de eindpunten van de eindpuntenmatrix opnieuw geordeerd naar de volgorde waarin failover moet plaatsvinden.

Met de laatste opdracht wordt het Traffic Manager-profiel bijgewerkt dat is opgeslagen in $Profile met de nieuwe eindpuntvolgorde.

Parameters

-LoadBalancingMethod

Hiermee geeft u de taakverdelingsmethode op die moet worden gebruikt om de verbinding te distribueren. Geldige waarden zijn:

  • Prestaties
  • Failover
  • RoundRobin
Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-MonitorPort

Hiermee geeft u de poort op die wordt gebruikt om de eindpuntstatus te bewaken. Geldige waarden zijn gehele getallen groter dan 0 en kleiner dan of gelijk aan 65.535.

Type:Int32
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-MonitorProtocol

Hiermee geeft u het protocol dat moet worden gebruikt voor het bewaken van de eindpuntstatus. Geldige waarden zijn:

  • HTTP
  • Https
Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-MonitorRelativePath

Hiermee geeft u het pad ten opzichte van de eindpuntdomeinnaam om te testen op de status. Het pad moet voldoen aan de volgende beperkingen:

  • Het pad moet tussen 1 en 1000 tekens zijn.
  • Het moet beginnen met een slash, /.
  • Het mag geen XML-elementen bevatten. <>
  • Het mag geen dubbele slashes bevatten, //.
  • Deze mag geen ongeldige HTML-escapetekens bevatten. Bijvoorbeeld %XY.
Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van het Traffic Manager-profiel dat moet worden bijgewerkt.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-TrafficManagerProfile

Hiermee geeft u het Traffic Manager-profielobject op dat u gebruikt om het profiel in te stellen.

Type:IProfileWithDefinition
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-Ttl

Hiermee geeft u de DNS Time-to-Live (TTL) op die de lokale DNS-resolvers informeert hoe lang DNS-vermeldingen in de cache moeten worden opgeslagen. Geldige waarden zijn een geheel getal van 30 tot en met 999.999.

Type:Int32
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

Uitvoerwaarden

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

Met deze cmdlet wordt een Traffic Manager-profielobject gegenereerd.