Partilhar via

New-AzTrafficManagerEndpoint

  • Referência
Módulo:
Az.TrafficManager

Cria um ponto final num Perfil do Gestor 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.

Este cmdlet confirma cada novo ponto de extremidade no serviço Gerenciador de Tráfego. Para adicionar vários pontos de extremidade a um objeto de perfil local do Gerenciador de Tráfego 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

Este 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

Este 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 é dada pelo caminho do 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 sondagem da integridade do endpoint será desabilitada e os pontos de extremidade serão incluídos no método de roteamento de tráfego.

Tipo:String
Valores aceites:Enabled, Disabled
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CustomHeader

Lista de nomes de cabeçalho personalizados e pares de valores para solicitações de teste.

Tipo:List<T>[TrafficManagerCustomHeader]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EndpointLocation

Especifica o local do ponto de extremidade a ser usado no método de roteamento de tráfego de desempenho. Este 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 das regiões do Azure, consulte Regiõeshttp://azure.microsoft.com/regions/ do Azure (http://azure.microsoft.com/regions/).

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EndpointStatus

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

  • Ativados
  • Disabled

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

Tipo:String
Valores aceites:Enabled, Disabled
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-GeoMapping

A lista de regiões mapeadas para este ponto de extremidade ao usar o método de roteamento de tráfego 'Geográfico'. Consulte a documentação do Traffic Manager para obter uma lista completa dos valores aceites.

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MinChildEndpoints

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

Tipo:Nullable<T>[UInt32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 Final Aninhado no perfil pai seja considerado disponível. Aplicável apenas ao ponto de extremidade do tipo 'NestedEndpoints'.

Tipo:Nullable<T>[UInt32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 apenas ao ponto de extremidade do tipo 'NestedEndpoints'.

Tipo:Nullable<T>[UInt32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome do ponto de extremidade do Gerenciador de Tráfego que esse cmdlet cria.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 for Priority. Os valores válidos são inteiros de 1 a 1000. Valores mais baixos representam maior prioridade.

Se você especificar uma prioridade, deverá especificar prioridades em todos os pontos de extremidade no perfil, e nenhum dois pontos de extremidade 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]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ResourceGroupName

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SubnetMapping

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

Tipo:List<T>[TrafficManagerIpAddressRange]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
  • Pontos de extremidade externos
  • NestedEndpoints
Tipo:String
Valores aceites:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Saídas

TrafficManagerEndpoint