Compartilhar via

New-AzTrafficManagerEndpoint

Módulo:
Az.TrafficManager Module

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

Sintaxe

Default (Default) 

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 para o 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

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 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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:Enabled, Disabled
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CustomHeader

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

Propriedades do parâmetro

Tipo:

List<T>[TrafficManagerCustomHeader]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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õeshttp://azure.microsoft.com/regions/ do Azure (http://azure.microsoft.com/regions/).

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EndpointStatus

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

  • Enabled
  • Disabled

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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:Enabled, Disabled
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

List<T>[String]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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/).

Propriedades do parâmetro

Tipo:

Nullable<T>[UInt32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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'.

Propriedades do parâmetro

Tipo:

Nullable<T>[UInt32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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'.

Propriedades do parâmetro

Tipo:

Nullable<T>[UInt32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

Nullable<T>[UInt32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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'.

Propriedades do parâmetro

Tipo:

List<T>[TrafficManagerIpAddressRange]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 .

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 De destino.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

Nullable<T>[UInt32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Saídas

TrafficManagerEndpoint