Add-AzTrafficManagerEndpointConfig

Agrega un punto de conexión a un objeto de perfil de Traffic Manager local.

Syntax

Add-AzTrafficManagerEndpointConfig
   -EndpointName <String>
   -TrafficManagerProfile <TrafficManagerProfile>
   -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 Add-AzTrafficManagerEndpointConfig agrega un punto de conexión a un objeto de perfil de Azure Traffic Manager local. Puede obtener un perfil mediante los cmdlets New-AzTrafficManagerProfile o Get-AzTrafficManagerProfile.

Este cmdlet funciona en el objeto de perfil local. Confirme los cambios en el perfil de Traffic Manager mediante el cmdlet Set-AzTrafficManagerProfile. Para crear un punto de conexión y confirmar el cambio en una sola operación, use el cmdlet New-AzTrafficManagerEndpoint.

Ejemplos

Ejemplo 1: Agregar un punto de conexión a un perfil

$TrafficManagerProfile = Get-AzTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11"
Add-AzTrafficManagerEndpointConfig -EndpointName "contoso" -EndpointStatus Enabled -Target "www.contoso.com" -TrafficManagerProfile $TrafficManagerProfile -Type ExternalEndpoints -EndpointLocation "North Europe" -Priority 1 -Weight 10
Set-AzTrafficManagerProfile -TrafficManagerProfile $TrafficManagerProfile

El primer comando obtiene un perfil de Azure Traffic Manager mediante el cmdlet Get-AzTrafficManagerProfile . El comando almacena el perfil local en la variable $TrafficManagerProfile.

El segundo comando agrega un punto de conexión denominado contoso al perfil almacenado en $TrafficManagerProfile. El comando incluye datos de configuración para el punto de conexión. Este comando solo cambia el objeto local.

El comando final actualiza el perfil de Traffic Manager en Azure para que coincida con el valor local en $TrafficManagerProfile.

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

-EndpointName

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

Type:String
Position:Named
Default value:None
Required:True
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

Número mínimo de puntos de conexión que deben estar disponibles en el perfil secundario para que el punto de conexión anidado del 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

-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

-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

-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

-TrafficManagerProfile

Especifica un objeto TrafficManagerProfile local. Este cmdlet modifica este objeto local. Para obtener un objeto TrafficManagerProfile , use el cmdlet Get-AzTrafficManagerProfile.

Type:TrafficManagerProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Type

Especifica el tipo de punto de conexión que este cmdlet agrega al perfil de Azure 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

TrafficManagerProfile

Salidas

TrafficManagerProfile