Set-AzureTrafficManagerEndpoint

  • Referência
Módulo:
Azure

Atualiza as propriedades de um ponto de extremidade em 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-AzureTrafficManagerEndpoint
   -DomainName <String>
   [-Location <String>]
   [-Type <String>]
   [-Status <String>]
   [-Weight <Int32>]
   [-MinChildEndpoints <Int32>]
   -TrafficManagerProfile <IProfileWithDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureTrafficManagerEndpoint atualiza as propriedades de um ponto de extremidade em um perfil do Gerenciador de Tráfego do Microsoft Azure. Se o ponto de extremidade não existir no perfil atual, esse cmdlet o criará. Depois de adicionar um ponto de extremidade, passe o resultado para o cmdlet Set-AzureTrafficManagerProfile usando o operador de pipeline. Esse cmdlet se conecta ao Azure para salvar suas alterações.

Exemplos

Exemplo 1: Atualizar um ponto de extremidade para um perfil

PS C:\>$TrafficManagerProfile = Get-AzureTrafficManagerProfile -Name "ContosoProfile"
PS C:\> Set-AzureTrafficManagerEndpoint -TrafficManagerProfile $TrafficManagerProfile -DomainName "ContosoApp02.cloudapp.net" -Status "Enabled" -Type "CloudService" -Weight 2 -Location myLocation | Set-AzureTrafficManagerProfile

O primeiro comando usa o cmdlet Get-AzureTrafficManagerProfile para obter o perfil chamado ContosoProfile e, em seguida, armazena-o na variável $TrafficManagerProfile.

O segundo comando atualiza o ponto de extremidade no perfil do Gerenciador de Tráfego armazenado no $TrafficManagerProfile. O ponto de extremidade tem o nome de domínio ContosoApp02.cloudapp.net. O comando também especifica o status, o tipo, a espessura e o local do ponto de extremidade. O comando passa o perfil modificado para o cmdlet Set-AzureTrafficManagerProfile para se conectar ao Azure e salvar suas alterações.

Parâmetros

-DomainName

Especifica o nome de domínio do ponto de extremidade a ser modificado.

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

-Location

Especifica o local do ponto de extremidade que o cmdlet adiciona. Este deve ser um local do Azure.

Este parâmetro deve conter um valor para pontos de extremidade do tipo "Any" ou do tipo "TrafficManager" em um perfil que tenha o método de balanceamento de carga definido como "Performance". Os valores possíveis são os nomes de região do Azure, conforme listado em https://azure.microsoft.com/regions/https://azure.microsoft.com/regions/.

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

-MinChildEndpoints

Especifica o número mínimo de pontos de extremidade que o perfil aninhado deve ter online para que esse ponto de extremidade seja considerado online.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
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

-Status

Especifica o status do ponto de extremidade de monitoramento. Os valores válidos são:

  • Ativados
  • Disabled

Se você especificar um valor de Enabled, o Gerenciador de Tráfego monitorará o ponto de extremidade e o método de balanceamento de carga o considerará ao gerenciar o tráfego.

Tipo:String
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 para o qual modificar o ponto de extremidade.

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

-Type

Especifica o tipo de ponto de extremidade. Os valores válidos são:

  • Serviço na nuvem

  • AzureWebsite

  • TrafficManager

  • Qualquer

Se houver mais de um ponto de extremidade AzureWebsite, os pontos de extremidade devem estar em datacenters diferentes.

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

-Weight

Especifica o peso do ponto de extremidade que o cmdlet adiciona. O intervalo de valores válido para este parâmetro é [1,1000].

Este parâmetro é usado apenas para políticas de balanceamento de carga RoundRobin.

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

Esse cmdlet gera um objeto de perfil do Gerenciador de Tráfego, que contém informações sobre o perfil atualizado.