Compartilhar via

Add-AzTrafficManagerEndpointConfig

  • Referência
Módulo:
Az.TrafficManager

Adiciona um ponto de extremidade a um objeto de perfil local do Gerenciador de Tráfego.

Sintaxe

Add-AzTrafficManagerEndpointConfig
   -EndpointName <String>
   -TrafficManagerProfile <TrafficManagerProfile>
   -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 Add-AzTrafficManagerEndpointConfig adiciona um ponto de extremidade a um objeto de perfil local do Gerenciador de Tráfego do Azure. Você pode obter um perfil usando os cmdlets New-AzTrafficManagerProfile ou Get-AzTrafficManagerProfile.

Esse cmdlet opera no objeto de perfil local. Confirme suas alterações no perfil do Gerenciador de Tráfego usando o cmdlet Set-AzTrafficManagerProfile. Para criar um ponto de extremidade e confirmar a alteração em uma única operação, use o cmdlet New-AzTrafficManagerEndpoint.

Exemplos

Exemplo 1: adicionar um ponto de extremidade a um perfil

$TrafficManagerProfile = Get-AzTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11"
Add-AzTrafficManagerEndpointConfig -EndpointName "contoso" -EndpointStatus Enabled -Target "www.contoso.com" -TrafficManagerProfile $TrafficManagerProfile -Type ExternalEndpoints -EndpointLocation "North Europe" -Priority 1 -Weight 10
Set-AzTrafficManagerProfile -TrafficManagerProfile $TrafficManagerProfile

O primeiro comando obtém um perfil do Gerenciador de Tráfego do Azure usando o cmdlet Get-AzTrafficManagerProfile . O comando armazena o perfil local na variável $TrafficManagerProfile.

O segundo comando adiciona um ponto de extremidade chamado contoso ao perfil armazenado em $TrafficManagerProfile. O comando inclui dados de configuração para o ponto de extremidade. Esse comando altera apenas o objeto local.

O comando final atualiza o perfil do Gerenciador de Tráfego no Azure para corresponder ao valor local em $TrafficManagerProfile.

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 das regiões do Azure, consulte Regiões do Azurehttp://azure.microsoft.com/regions/ (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

-EndpointName

Especifica o nome do ponto de extremidade do Gerenciador de Tráfego que este cmdlet adiciona.

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

-EndpointStatus

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

  • Habilitado
  • Desactivado

Se o status estiver 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 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

O número mínimo de pontos de extremidade 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

-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

-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 pontos de extremidade no perfil e nenhum ponto de extremidade poderá 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

-SubnetMapping

A lista de intervalos de endereços ou sub-redes mapeadas 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 Destino.

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

-TrafficManagerProfile

Especifica um objeto TrafficManagerProfile local. Este cmdlet modifica esse objeto local. Para obter um objeto TrafficManagerProfile, use o cmdlet Get-AzTrafficManagerProfile.

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

-Type

Especifica o tipo de ponto de extremidade que esse cmdlet adiciona ao perfil do Gerenciador de Tráfego do Azure. 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

TrafficManagerProfile

Saídas

TrafficManagerProfile