Compartilhar via

Add-AzureTrafficManagerEndpoint

  • Referência
Módulo:
Azure

Adiciona um ponto de extremidade a 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

Add-AzureTrafficManagerEndpoint
   -DomainName <String>
   [-Location <String>]
   -Type <String>
   -Status <String>
   [-Weight <Int32>]
   [-MinChildEndpoints <Int32>]
   -TrafficManagerProfile <IProfileWithDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

O cmdlet Add-AzureTrafficManagerEndpoint adiciona um ponto de extremidade a um perfil do Gerenciador de Tráfego do Microsoft Azure. 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: Adicionar um ponto de extremidade a um perfil

PS C:\>$TrafficManagerProfile = Get-AzureTrafficManagerProfile -Name "ContosoProfile"
PS C:\> Add-AzureTrafficManagerEndpoint -TrafficManagerProfile $TrafficManagerProfile -DomainName "Contoso02App.cloudapp.net" -Status "Enabled" -Type "CloudService" | 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 adiciona um ponto de extremidade ao perfil do Gerenciador de Tráfego que é armazenado no $TrafficManagerProfile. O ponto de extremidade tem o nome de domínio Contoso02App.couldapp.net. O comando também especifica se ele está habilitado e seu tipo. O comando passa o objeto de perfil para o cmdlet Set-AzureTrafficManagerProfile para se conectar ao Azure e salvar suas alterações.

Exemplo 2: Adicionar um ponto de extremidade que tenha um local e peso especificados

PS C:\>Add-AzureTrafficManagerEndpoint -TrafficManagerProfile ContosoTrafficManagerProfile -DomainName " Contoso02App.cloudapp.net" -Status Enabled -Type CloudService -Weight 2 -Location myLocation | Set-AzureTrafficManagerProfile

Esse comando adiciona um ponto de extremidade a um perfil do Gerenciador de Tráfego. O ponto de extremidade tem o nome de domínio Contoso02App.couldapp.net. O comando também especifica se ele está habilitado e seu tipo. O comando também especifica o peso e o local do ponto de extremidade. O comando passa o objeto de perfil para Set-AzureTrafficManagerProfile para se conectar ao Azure para salvar suas alterações.

Parâmetros

-DomainName

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

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

-Location

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

Esse 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/.

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

-MinChildEndpoints

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
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

-Status

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

  • Enabled
  • Desabilitado

Se você especificar um valor de Habilitado, 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
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TrafficManagerProfile

Especifica o objeto de perfil do Gerenciador de Tráfego ao qual adicionar o ponto de extremidade.

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

-Type

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

  • CloudService

  • Site do Azure

  • TrafficManager

  • Qualquer

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

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

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

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, que contém informações sobre o perfil atualizado.