Compartir a través de

New-AzTrafficManagerEndpoint

  • Referencia
Módulo:
Az.TrafficManager

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

Sintaxis

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.

Tipo:String
Valores aceptados:Enabled, Disabled
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CustomHeader

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

Tipo:List<T>[TrafficManagerCustomHeader]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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/).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EndpointStatus

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

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

Tipo:String
Valores aceptados:Enabled, Disabled
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:List<T>[String]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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/).

Tipo:Nullable<T>[UInt32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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".

Tipo:Nullable<T>[UInt32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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".

Tipo:Nullable<T>[UInt32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Nullable<T>[UInt32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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".

Tipo:List<T>[TrafficManagerIpAddressRange]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
Tipo:String
Valores aceptados:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 1 (uno). Este parámetro solo se usa si el perfil de Traffic Manager está configurado con el método de enrutamiento de tráfico ponderado.

Tipo:Nullable<T>[UInt32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

TrafficManagerEndpoint