Set-AzureTrafficManagerProfile
Atualiza as propriedades de um perfil do Gerenciador de Tráfego.
Observação
Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.
Syntax
Set-AzureTrafficManagerProfile
[-Name <String>]
[-LoadBalancingMethod <String>]
[-MonitorPort <Int32>]
[-MonitorProtocol <String>]
[-MonitorRelativePath <String>]
[-Ttl <Int32>]
-TrafficManagerProfile <IProfileWithDefinition>
[-Profile <AzureSMProfile>]
[<CommonParameters>] Description
O cmdlet Set-AzureTrafficManagerProfile atualiza as propriedades de um perfil do Gerenciador de Tráfego do Microsoft Azure.
Para perfis para os quais você definiu o valor LoadBalancingMethod como "Failover", você pode determinar a ordem de failover dos pontos de extremidade adicionados ao seu perfil com o cmdlet Add-AzureTrafficManagerEndpoint. Para obter mais informações, consulte o Exemplo 3 abaixo.
Exemplos
Exemplo 1: Definir o TTL para um perfil do Gerenciador de Tráfego
PS C:\>Set-AzureTrafficManagerProfile -TrafficManagerProfile $MyTrafficManagerProfile -Ttl 60Este comando define o TTL como 60 segundos para o objeto de perfil do Gerenciador de Tráfego MyTrafficManagerProfile.
Exemplo 2: Definir vários valores para um perfil
PS C:\>Get-AzureTrafficManagerProfile -Name "MyProfile" | Set-AzureTrafficManagerProfile -LoadBalancingMethod "RoundRobin" -Ttl 30 -MonitorProtocol "Http" -MonitorPort 80 -MonitorRelativePath "/"Esse comando obtém um perfil do Gerenciador de Tráfego chamado MyProfile usando o cmdlet Get-AzureTrafficManagerProfile . O perfil usa o método de balanceamento de carga RoundRobin, um TTL de 30 segundos, o protocolo de monitor HTTP, a porta do monitor e o caminho relativo para um perfil do Gerenciador de Tráfego.
Exemplo 3: Reordenar pontos de extremidade para a ordem de failover desejada
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-AzureTrafficManagerProfileEste exemplo reordena os pontos de extremidade adicionados a MyProfile para a ordem de failover desejada.
O primeiro comando obtém o objeto de perfil do Gerenciador de Tráfego chamado MyProfile e armazena o objeto na variável $Profile.
O segundo comando reordena os pontos de extremidade da matriz de pontos de extremidade para a ordem em que o failover deve ocorrer.
O último comando atualiza o perfil do Gerenciador de Tráfego armazenado no $Profile com a nova ordem de ponto de extremidade.
Parâmetros
-LoadBalancingMethod
Especifica o método de balanceamento de carga a ser usado para distribuir a conexão. Os valores válidos são:
- Desempenho
- Failover
- RoundRobin
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MonitorPort
Especifica a porta usada para monitorar a integridade do ponto de extremidade. Os valores válidos são valores inteiros maiores que 0 e menores ou iguais a 65.535.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MonitorProtocol
Especifica o protocolo a ser usado para monitorar a integridade do ponto de extremidade. Os valores válidos são:
- Http
- Https
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MonitorRelativePath
Especifica o caminho relativo ao nome de domínio do ponto de extremidade a ser investigado quanto ao estado de integridade. O caminho deve atender às seguintes restrições:
- O caminho deve ter de 1 a 1000 caracteres.
- Deve começar com uma barra para a frente, /.
- Ele não deve conter elementos XML, <>.
- Não deve conter barras duplas, //.
- Ele não deve conter caracteres de escape HTML inválidos. Por exemplo, %XY.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Especifica o nome do perfil do Gerenciador de Tráfego a ser atualizado.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Profile
Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TrafficManagerProfile
Especifica o objeto de perfil do Gerenciador de Tráfego que você usa para definir o perfil.
| Type: | IProfileWithDefinition |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Ttl
Especifica o TTL (Tempo de Vida Útil do DNS) que informa aos resolvedores DNS locais por quanto tempo armazenar em cache as entradas DNS. Os valores válidos são um inteiro de 30 a 999.999.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Saídas
Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition
Esse cmdlet gera um objeto de perfil do Gerenciador de Tráfego.