Add-AzTrafficManagerEndpointConfig

Módulo:
Az.TrafficManager Module

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

Sintaxis

Default (valor predeterminado) 

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 realizados 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.

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 Azure. Para obtener una lista completa de las regiones de Azure, consulte Azure Regionshttp://azure.microsoft.com/regions/ (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

-EndpointName

Especifica el nombre del punto de conexión de Traffic Manager que agrega 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

-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

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".

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

-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

-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

-TrafficManagerProfile

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

Propiedades de parámetro

Tipo:TrafficManagerProfile
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:True
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 Azure 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

TrafficManagerProfile

Salidas

TrafficManagerProfile