Compartir a través de

New-AzTrafficManagerEndpoint

Módulo:
Az.TrafficManager Module

Crea un punto de conexión en un perfil de Traffic Manager.

Sintaxis

Default (valor predeterminado) 

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

El cmdlet New-AzTrafficManagerEndpoint crea un punto de conexión en un perfil de Azure Traffic Manager.

Este cmdlet confirma cada nuevo punto de conexión en el servicio Traffic Manager. Para agregar varios puntos de conexión a un objeto de perfil de Traffic Manager local y confirmar los cambios en una sola operación, use el cmdlet Add-AzTrafficManagerEndpointConfig.

Ejemplos

Ejemplo 1: Creación de un punto de conexión externo para un 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 crea un punto de conexión externo denominado contoso en el perfil denominado ContosoProfile en el grupo de recursos denominado ResourceGroup11.

Ejemplo 2: Creación de un punto de conexión de Azure para un 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 crea un punto de conexión de Azure denominado contoso en el perfil denominado ContosoProfile en el grupo de recursos ResourceGroup11. El punto de conexión de Azure apunta a la aplicación web de Azure cuyo identificador de Azure Resource Manager recibe la ruta de acceso del URI en TargetResourceId. El comando no especifica el parámetro EndpointLocation porque el recurso de aplicación web proporciona la ubicación.

Parámetros

-AlwaysServe

Si Always Serve está habilitado, el sondeo para el estado del punto de conexión se deshabilitará y los puntos de conexión se incluirán en el método de enrutamiento del tráfico.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:Enabled, Disabled
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CustomHeader

Lista de pares de nombre y valor de encabezado personalizados para solicitudes de sondeo.

Propiedades de parámetro

Tipo:

List<T>[TrafficManagerCustomHeader]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-EndpointLocation

Especifica la ubicación del punto de conexión que se va a usar en el método de enrutamiento del tráfico de rendimiento. Este parámetro solo es aplicable a los puntos de conexión del tipo ExternalEndpoints o NestedEndpoints. Debe especificar este parámetro cuando se use el método de enrutamiento de tráfico de rendimiento.

Especifique un nombre de región de Azure. Para obtener una lista completa de las regiones de Azure, consulte Regioneshttp://azure.microsoft.com/regions/ de Azure (http://azure.microsoft.com/regions/).

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-EndpointStatus

Especifica el estado del punto de conexión. Los valores válidos son:

  • Enabled
  • Disabled

Si el estado es Habilitado, el punto de conexión se sondea para el estado del punto de conexión y se incluye en el método de enrutamiento del tráfico.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:Enabled, Disabled
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-GeoMapping

La lista de regiones asignadas a este punto de conexión al usar el método de enrutamiento de tráfico "Geográfico". Consulte la documentación de Traffic Manager para obtener una lista completa de los valores aceptados.

Propiedades de parámetro

Tipo:

List<T>[String]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MinChildEndpoints

Especifique un nombre de región de Azure. Para obtener una lista completa de las regiones de Azure, consulte Regioneshttp://azure.microsoft.com/regions/ de Azure (http://azure.microsoft.com/regions/).

Propiedades de parámetro

Tipo:

Nullable<T>[UInt32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MinChildEndpointsIPv4

Número mínimo de puntos de conexión IPv4 (tipo de registro DNS A) que deben estar disponibles en el perfil secundario para que el punto de conexión anidado en el perfil primario se considere disponible. Solo se aplica al punto de conexión del tipo "NestedEndpoints".

Propiedades de parámetro

Tipo:

Nullable<T>[UInt32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MinChildEndpointsIPv6

Número mínimo de puntos de conexión IPv6 (AAAA de tipo de registro DNS) que deben estar disponibles en el perfil secundario para que el punto de conexión anidado en el perfil primario se considere disponible. Solo se aplica al punto de conexión del tipo "NestedEndpoints".

Propiedades de parámetro

Tipo:

Nullable<T>[UInt32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifica el nombre del punto de conexión de Traffic Manager que crea este cmdlet.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Priority

Especifica la prioridad que Traffic Manager asigna al punto de conexión. Este parámetro solo se usa si el perfil de Traffic Manager está configurado con para el método de enrutamiento de tráfico prioritario. Los valores válidos son enteros de 1 a 1000. Los valores inferiores representan mayor prioridad.

Si especifica una prioridad, debe especificar prioridades en todos los puntos de conexión del perfil y no dos puntos de conexión pueden compartir el mismo valor de prioridad. Si no especifica prioridades, Traffic Manager asigna valores de prioridad predeterminados a los puntos de conexión, empezando por uno (1), en el orden en que el perfil enumera los puntos de conexión.

Propiedades de parámetro

Tipo:

Nullable<T>[UInt32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ProfileName

Especifica el nombre de un perfil de Traffic Manager al que este cmdlet agrega un punto de conexión. Para obtener un perfil, use los cmdlets New-AzTrafficManagerProfile o Get-AzTrafficManagerProfile.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResourceGroupName

Especifica el nombre de un grupo de recursos. Este cmdlet crea un punto de conexión de Traffic Manager en el grupo que especifica este parámetro.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SubnetMapping

La lista de intervalos de direcciones o subredes asignados a este punto de conexión cuando se usa el método de enrutamiento de tráfico "Subred".

Propiedades de parámetro

Tipo:

List<T>[TrafficManagerIpAddressRange]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Target

Especifica el nombre DNS completo del punto de conexión. Traffic Manager devuelve este valor en las respuestas DNS cuando dirige el tráfico a este punto de conexión. Especifique este parámetro solo para el tipo de punto de conexión ExternalEndpoints. Para otros tipos de punto de conexión, especifique el parámetro TargetResourceId en su lugar.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TargetResourceId

Especifica el identificador de recurso del destino. Especifique este parámetro solo para los tipos de punto de conexión AzureEndpoints y NestedEndpoints. Para el tipo de punto de conexión ExternalEndpoints, especifique el parámetro Target en su lugar.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Type

Especifica el tipo de punto de conexión que este cmdlet agrega al perfil de Traffic Manager. Los valores válidos son:

  • AzureEndpoints
  • ExternalEndpoints
  • NestedEndpoints

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Weight

Especifica el peso que Traffic Manager asigna al punto de conexión. Los valores válidos son enteros de 1 a 1000. El valor predeterminado es uno (1). Este parámetro solo se usa si el perfil de Traffic Manager está configurado con el método de enrutamiento de tráfico ponderado.

Propiedades de parámetro

Tipo:

Nullable<T>[UInt32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

None

Salidas

TrafficManagerEndpoint