New-AzureTrafficManagerProfile

  • Referência
Módulo:
Azure

Cria um perfil do Gerenciador de Tráfego.

Observação

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 herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

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

Sintaxe

New-AzureTrafficManagerProfile
   -Name <String>
   -DomainName <String>
   -LoadBalancingMethod <String>
   -MonitorPort <Int32>
   -MonitorProtocol <String>
   -MonitorRelativePath <String>
   -Ttl <Int32>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

O cmdlet New-AzureTrafficManagerProfile cria um perfil do Gerenciador de Tráfego do Microsoft Azure.

Depois de criar um perfil em que você define 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 2 abaixo.

Exemplos

Exemplo 1: Criar um perfil do Gerenciador de Tráfego

PS C:\>New-AzureTrafficManagerProfile -Name "MyProfile" -DomainName "My.profile.trafficmanager.net" -LoadBalancingMethod "RoundRobin" -Ttl 30 -MonitorProtocol "Http" -MonitorPort 80 -MonitorRelativePath "/"

Esse comando cria um perfil do Gerenciador de Tráfego chamado MyProfile no domínio especificado do Gerenciador de Tráfego com um método de balanceamento de carga Round Robin, um TTL de 30 segundos, protocolo de monitoramento HTTP, porta de monitoramento 80 e com o caminho especificado.

Exemplo 2: 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 no $Profile com a nova ordem de ponto de extremidade.

Parâmetros

-DomainName

Especifica o nome de domínio do perfil do Gerenciador de Tráfego. Este deve ser um subdomínio de trafficmanager.net.

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

-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:True
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:True
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:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

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

-Name

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

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

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

-Ttl

Especifica o TTL (Tempo de Vida Remoto) do DNS que informa aos resolvedores DNS locais por quanto tempo armazenar em cache as entradas DNS. Os valores válidos são inteiros de 30 a 999.999.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:True
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.