Share via

New-AzTrafficManagerProfile

  • Referência
Módulo:
Az.TrafficManager

Cria um perfil do Gerenciador de Tráfego.

Syntax

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 Name e as configurações necessárias. Esse cmdlet retorna um objeto local que representa o novo perfil.

Este 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 DNS é contosoapp.trafficmanager.net.

Parâmetros

-CustomHeader

Lista de pares de nome e valor de cabeçalho personalizados para solicitações de teste.

Type:List<T>[TrafficManagerCustomHeader]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpectedStatusCodeRange

Lista de intervalos de código de status HTTP esperados para solicitações de teste.

Type:List<T>[TrafficManagerExpectedStatusCodeRange]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxReturn

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

Type:Nullable<T>[Int64]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Aliases:IntervalInSecondsForMonitor
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 (/).

Type:String
Aliases:PathForMonitor
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UInt32
Aliases:PortForMonitor
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MonitorProtocol

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

  • HTTP
  • HTTPS
Type:String
Aliases:ProtocolForMonitor
Accepted values:HTTP, HTTPS, TCP
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Aliases:TimeoutInSecondsForMonitor
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Aliases:ToleratedNumberOfFailuresForMonitor
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ProfileStatus

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

Type:String
Accepted values:Enabled, Disabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Tag

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

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

Type:Hashtable
Aliases:Tags
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Type:String
Accepted values:Performance, Weighted, Priority, Geographic, Subnet, MultiValue
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Ttl

Especifica o valor TTL (Tempo de Vida do DNS).

Type:UInt32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Saídas

TrafficManagerProfile