Partilhar via

New-AzTrafficManagerEndpoint

Módulo:
Az.TrafficManager Module

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

Sintaxe

Default (Padrão) 

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

Descrição

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.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Valores aceites:Enabled, Disabled
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-CustomHeader

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

Propriedades dos parâmetros

Tipo:

List<T>[TrafficManagerCustomHeader]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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 dos parâmetros

Tipo:IAzureContextContainer
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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. 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/).

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-EndpointStatus

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

  • Ativado(a)
  • 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.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Valores aceites:Enabled, Disabled
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Tipo:

List<T>[String]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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 dos parâmetros

Tipo:

Nullable<T>[UInt32]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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 Final Aninhado no perfil pai seja considerado disponível. Aplicável apenas ao ponto de extremidade do tipo 'NestedEndpoints'.

Propriedades dos parâmetros

Tipo:

Nullable<T>[UInt32]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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 apenas ao ponto de extremidade do tipo 'NestedEndpoints'.

Propriedades dos parâmetros

Tipo:

Nullable<T>[UInt32]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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 dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por 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 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.

Propriedades dos parâmetros

Tipo:

Nullable<T>[UInt32]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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 dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Tipo:

List<T>[TrafficManagerIpAddressRange]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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 dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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 Target .

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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 dos parâmetros

Tipo:String
Valor padrão:None
Valores aceites:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por 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 dos parâmetros

Tipo:

Nullable<T>[UInt32]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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