Compartilhar via

Set-AzureTrafficManagerProfile

  • Referência
Módulo:
Azure

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

Observação

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

O módulo do Az PowerShell é o módulo recomendado do PowerShell 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

Esse 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 os 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 ao 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 do 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
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MonitorProtocol

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

  • Http
  • Https
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MonitorRelativePath

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

  • O caminho deve ter de 1 a 1000 caracteres.
  • Ele deve começar com uma barra, /.
  • Ele não deve conter elementos XML, <>.
  • Ele não deve conter barras duplas, //.
  • Ele não deve conter caracteres de escape HTML inválidos. Por exemplo, %XY.
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Profile

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

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TrafficManagerProfile

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

Tipo:IProfileWithDefinition
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Ttl

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

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

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