Set-AzureTrafficManagerProfile
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.
Syntaxis
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 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Name
Hiermee geeft u de naam van het Traffic Manager-profiel dat moet worden bijgewerkt.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-TrafficManagerProfile
Hiermee geeft u het Traffic Manager-profielobject op dat u gebruikt om het profiel in te stellen.
Type: | IProfileWithDefinition |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
Uitvoerwaarden
Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition
Met deze cmdlet wordt een Traffic Manager-profielobject gegenereerd.