New-AzTrafficManagerProfile

  • Referência
Módulo:
Az.TrafficManager

Cria um perfil do Gerenciador de Tráfego.

Sintaxe

New-AzTrafficManagerProfile
   -Name <String>
   -ResourceGroupName <String>
   [-ProfileStatus <String>]
   -RelativeDnsName <String>
   -Ttl <UInt32>
   -TrafficRoutingMethod <String>
   -MonitorProtocol <String>
   -MonitorPort <UInt32>
   [-MonitorPath <String>]
   [-MonitorIntervalInSeconds <Int32>]
   [-MonitorTimeoutInSeconds <Int32>]
   [-MonitorToleratedNumberOfFailures <Int32>]
   [-MaxReturn <Int64>]
   [-Tag <Hashtable>]
   [-CustomHeader <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerCustomHeader]>]
   [-ExpectedStatusCodeRange <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerExpectedStatusCodeRange]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet New-AzTrafficManagerProfile cria um perfil do Gerenciador de Tráfego do Azure. Especifique o parâmetro Nome e as configurações necessárias. Esse cmdlet retorna um objeto local que representa o novo perfil.

Esse cmdlet não configura pontos de extremidade do Gerenciador de Tráfego. Você pode atualizar o objeto de perfil local usando o cmdlet Add-AzTrafficManagerEndpointConfig. Em seguida, carregue as alterações no Gerenciador de Tráfego usando o cmdlet Set-AzTrafficManagerProfile. Como alternativa, você pode adicionar pontos de extremidade usando o cmdlet New-AzTrafficManagerEndpoint.

Exemplos

Exemplo 1: Criar um perfil

New-AzTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11" -ProfileStatus Enabled -TrafficRoutingMethod Performance -RelativeDnsName "contosoapp" -TTL 30 -MonitorProtocol HTTP -MonitorPort 80 -MonitorPath "/default.aspx"

Esse comando cria um perfil do Gerenciador de Tráfego do Azure chamado ContosoProfile no grupo de recursos ResourceGroup11. O FQDN do DNS é contosoapp.trafficmanager.net.

Parâmetros

-CustomHeader

Lista de pares de nome e valor de cabeçalho personalizados para solicitações de investigação.

Tipo:List<T>[TrafficManagerCustomHeader]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExpectedStatusCodeRange

Lista de intervalos de código de status HTTP esperados para solicitações de investigação.

Tipo:List<T>[TrafficManagerExpectedStatusCodeRange]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MaxReturn

O número máximo de respostas retornadas para perfis com um método de roteamento MultiValue.

Tipo:Nullable<T>[Int64]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MonitorIntervalInSeconds

O intervalo (em segundos) no qual o Gerenciador de Tráfego verificará a integridade de cada ponto de extremidade nesse perfil. O padrão é 30.

Tipo:Nullable<T>[Int32]
Aliases:IntervalInSecondsForMonitor
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MonitorPath

Especifica o caminho usado para monitorar a integridade do ponto de extremidade. Especifique um valor relativo ao nome de domínio do ponto de extremidade. Esse valor deve começar com uma barra (/).

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

-MonitorPort

Especifica a porta TCP usada para monitorar a integridade do ponto de extremidade. Os valores válidos são inteiros de 1 a 65535.

Tipo:UInt32
Aliases:PortForMonitor
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
Aliases:ProtocolForMonitor
Valores aceitos:HTTP, HTTPS, TCP
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MonitorTimeoutInSeconds

O tempo (em segundos) que o Gerenciador de Tráfego permite que os pontos de extremidade nesse perfil respondam à verificação de integridade. O padrão é 10.

Tipo:Nullable<T>[Int32]
Aliases:TimeoutInSecondsForMonitor
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MonitorToleratedNumberOfFailures

O número de verificações de integridade com falha consecutivas que o Gerenciador de Tráfego tolera antes de declarar um ponto de extremidade neste perfil Degradado após a próxima verificação de integridade com falha consecutiva. O padrão é 3.

Tipo:Nullable<T>[Int32]
Aliases:ToleratedNumberOfFailuresForMonitor
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica um nome para o perfil do Gerenciador de Tráfego que esse cmdlet cria.

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

-ProfileStatus

Especifica o status do perfil. Os valores válidos são: Habilitado e Desabilitado.

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

-RelativeDnsName

Especifica o nome DNS relativo que esse perfil do Gerenciador de Tráfego fornece. O Gerenciador de Tráfego combina esse valor e o nome de domínio DNS que o Gerenciador de Tráfego do Azure usa para formar o FQDN (nome de domínio totalmente qualificado) do perfil.

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

-ResourceGroupName

Especifica o nome de um grupo de recursos. Esse cmdlet cria um perfil do Gerenciador de Tráfego no grupo especificado por esse parâmetro.

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

-Tag

Pares de chave-valor na forma de uma tabela de hash definida como tags no servidor. Por exemplo:

@{key0="valor0"; chave1=$null; chave2="valor2"}

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

-TrafficRoutingMethod

Especifica o método de roteamento de tráfego. Esse método determina qual ponto de extremidade o Gerenciador de Tráfego retorna em resposta a consultas DNS de entrada. Os valores válidos são:

  • Desempenho
  • Ponderado
  • Prioridade
  • Geográfico
Tipo:String
Valores aceitos:Performance, Weighted, Priority, Geographic, Subnet, MultiValue
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Ttl

Especifica o valor de vida útil (TTL) do DNS.

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

Entradas

None

Saídas

TrafficManagerProfile