New-AzTrafficManagerEndpoint

  • Referencia
Módulo:
Az.TrafficManager

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

Syntax

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.

Type:String
Accepted values:Enabled, Disabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomHeader

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

Type:List<T>[TrafficManagerCustomHeader]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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/).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Accepted values:Enabled, Disabled
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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/).

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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".

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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".

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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".

Type:List<T>[TrafficManagerIpAddressRange]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Type:String
Accepted values:AzureEndpoints, ExternalEndpoints, NestedEndpoints
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Salidas

TrafficManagerEndpoint