Partilhar via

Set-AzureTrafficManagerProfile

  • Referência
Módulo:
Azure

Atualiza as propriedades de um perfil do Gerenciador de Tráfego.

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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 60

Este comando define o TTL para 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 "/"

Este 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 HTTP do monitor, 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-AzureTrafficManagerProfile

Este 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 em $Profile com a nova ordem de ponto final.

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
  • Ativação pós-falha
  • RoundRobin
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MonitorProtocol

Especifica o protocolo a ser usado para monitorar a integridade do ponto de extremidade. Os valores válidos são:

  • Http
  • Disponível em:
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MonitorRelativePath

Especifica o caminho relativo ao nome de domínio do ponto de extremidade a ser investigado para o estado de integridade. O caminho deve atender às seguintes restrições:

  • O caminho deve ser 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.
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome do perfil do Gerenciador de Tráfego a ser atualizado.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TrafficManagerProfile

Especifica o objeto de perfil do Gerenciador de Tráfego que você usa para definir o perfil.

Tipo:IProfileWithDefinition
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Ttl

Especifica o tempo de vida útil (TTL) do DNS que informa aos resolvedores de DNS local por quanto tempo armazenar em cache as entradas DNS. Os valores válidos são um número inteiro de 30 a 999.999.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Saídas

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

Este cmdlet gera um objeto de perfil do Gerenciador de Tráfego.