Compartilhar via

New-AzTrafficManagerEndpoint

  • Referência
Módulo:
Az.TrafficManager

Cria um ponto de extremidade em um perfil do Gerenciador de Tráfego.

Sintaxe

New-AzTrafficManagerEndpoint
   -Name <String>
   -ProfileName <String>
   -ResourceGroupName <String>
   -Type <String>
   [-TargetResourceId <String>]
   [-Target <String>]
   -EndpointStatus <String>
   [-Weight <UInt32>]
   [-Priority <UInt32>]
   [-EndpointLocation <String>]
   [-AlwaysServe <String>]
   [-MinChildEndpoints <UInt32>]
   [-MinChildEndpointsIPv4 <UInt32>]
   [-MinChildEndpointsIPv6 <UInt32>]
   [-GeoMapping <System.Collections.Generic.List`1[System.String]>]
   [-SubnetMapping <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerIpAddressRange]>]
   [-CustomHeader <System.Collections.Generic.List`1[Microsoft.Azure.Commands.TrafficManager.Models.TrafficManagerCustomHeader]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet New-AzTrafficManagerEndpoint cria um ponto de extremidade em um perfil do Gerenciador de Tráfego do Azure.

Esse cmdlet confirma cada novo ponto de extremidade no serviço do Gerenciador de Tráfego. Para adicionar vários pontos de extremidade a um objeto de perfil do Gerenciador de Tráfego local e confirmar alterações em uma única operação, use o cmdlet Add-AzTrafficManagerEndpointConfig.

Exemplos

Exemplo 1: Criar um ponto de extremidade externo para um perfil

New-AzTrafficManagerEndpoint -EndpointStatus Enabled -Name "contoso" -ProfileName "ContosoProfile" -ResourceGroupName "ResourceGroup11" -Type ExternalEndpoints -EndpointLocation "North Europe" -Priority 1 -Target "www.contoso.com" -Weight 10

Esse comando cria um ponto de extremidade externo chamado contoso no perfil chamado ContosoProfile no grupo de recursos chamado ResourceGroup11.

Exemplo 2: Criar um ponto de extremidade do Azure para um perfil

New-AzTrafficManagerEndpoint -EndpointStatus Enabled -Name "contoso" -ProfileName "ContosoProfile" -ResourceGroupName "ResourceGroup11" -Type AzureEndpoints -Priority 1 -TargetResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Default-Web-CentralUS/providers/Microsoft.Web/sites/contoso-web-app" -Weight 10

Esse comando cria um ponto de extremidade do Azure chamado contoso no perfil chamado ContosoProfile no grupo de recursos ResourceGroup11. O ponto de extremidade do Azure aponta para o Aplicativo Web do Azure cuja ID do Azure Resource Manager é fornecida pelo caminho de URI em TargetResourceId. O comando não especifica o parâmetro EndpointLocation porque o recurso do Aplicativo Web fornece o local.

Parâmetros

-AlwaysServe

Se o Always Serve estiver habilitado, a investigação da integridade do ponto de extremidade será desabilitada e os pontos de extremidade serão incluídos no método de roteamento de tráfego.

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

-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

-EndpointLocation

Especifica o local do ponto de extremidade a ser usado no método de roteamento de tráfego de desempenho. Esse parâmetro só é aplicável a pontos de extremidade do tipo ExternalEndpoints ou NestedEndpoints. Você deve especificar esse parâmetro quando o método de roteamento de tráfego de desempenho for usado.

Especifique um nome de região do Azure. Para obter uma lista completa de regiões do Azure, consulte Regiõeshttp://azure.microsoft.com/regions/ do Azure (http://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

-EndpointStatus

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

  • Enabled
  • Desabilitado

Se o status for Enabled, o endpoint será investigado quanto à integridade do endpoint e será incluído no método de roteamento de tráfego.

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

-GeoMapping

A lista de regiões mapeadas para esse ponto de extremidade ao usar o método de roteamento de tráfego 'Geográfico'. Consulte a documentação do Gerenciador de Tráfego para obter uma lista completa de valores aceitos.

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

-MinChildEndpoints

Especifique um nome de região do Azure. Para obter uma lista completa de regiões do Azure, consulte Regiõeshttp://azure.microsoft.com/regions/ do Azure (http://azure.microsoft.com/regions/).

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

-MinChildEndpointsIPv4

O número mínimo de pontos de extremidade IPv4 (tipo de registro DNS A) que devem estar disponíveis no perfil filho para que o ponto de extremidade aninhado no perfil pai seja considerado disponível. Aplicável somente ao ponto de extremidade do tipo 'NestedEndpoints'.

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

-MinChildEndpointsIPv6

O número mínimo de pontos de extremidade IPv6 (tipo de registro DNS AAAA) que devem estar disponíveis no perfil filho para que o ponto de extremidade aninhado no perfil pai seja considerado disponível. Aplicável somente ao ponto de extremidade do tipo 'NestedEndpoints'.

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

-Name

Especifica o nome do ponto de extremidade 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

-Priority

Especifica a prioridade que o Gerenciador de Tráfego atribui ao ponto de extremidade. Esse parâmetro será usado somente se o perfil do Gerenciador de Tráfego estiver configurado com o método de roteamento de tráfego para Prioridade. Os valores válidos são inteiros de 1 a 1000. Valores mais baixos representam prioridade mais alta.

Se você especificar uma prioridade, deverá especificar prioridades em todos os endpoints no perfil, e dois endpoints não poderão compartilhar o mesmo valor de prioridade. Se você não especificar prioridades, o Gerenciador de Tráfego atribuirá valores de prioridade padrão aos pontos de extremidade, começando com um (1), na ordem em que o perfil lista os pontos de extremidade.

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

-ProfileName

Especifica o nome de um perfil do Gerenciador de Tráfego ao qual esse cmdlet adiciona um ponto de extremidade. Para obter um perfil, use os cmdlets New-AzTrafficManagerProfile ou Get-AzTrafficManagerProfile.

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 ponto de extremidade 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

-SubnetMapping

A lista de intervalos de endereços ou sub-redes mapeados para esse ponto de extremidade ao usar o método de roteamento de tráfego 'Sub-rede'.

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

-Target

Especifica o nome DNS totalmente qualificado do ponto de extremidade. O Gerenciador de Tráfego retorna esse valor em respostas DNS quando direciona o tráfego para esse ponto de extremidade. Especifique esse parâmetro somente para o tipo de ponto de extremidade ExternalEndpoints. Para outros tipos de ponto de extremidade, especifique o parâmetro TargetResourceId .

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

-TargetResourceId

Especifica a ID do recurso do destino. Especifique esse parâmetro somente para os tipos de ponto de extremidade AzureEndpoints e NestedEndpoints. Para o tipo de ponto de extremidade ExternalEndpoints, especifique o parâmetro Target .

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

-Type

Especifica o tipo de ponto de extremidade que esse cmdlet adiciona ao perfil do Gerenciador de Tráfego. Os valores válidos são:

  • AzureEndpoints
  • ExternalEndpoints
  • NestedEndpoints
Tipo:String
Valores aceitos:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Weight

Especifica o peso que o Gerenciador de Tráfego atribui ao ponto de extremidade. Os valores válidos são inteiros de 1 a 1000. O valor padrão é um (1). Esse parâmetro será usado somente se o perfil do Gerenciador de Tráfego estiver configurado com o método de roteamento de tráfego ponderado.

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

Entradas

None

Saídas

TrafficManagerEndpoint