Compartir a través de

Set-AzureTrafficManagerEndpoint

  • Referencia
Módulo:
Azure

Actualiza las propiedades de un punto de conexión en un perfil de Traffic Manager.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

Set-AzureTrafficManagerEndpoint
   -DomainName <String>
   [-Location <String>]
   [-Type <String>]
   [-Status <String>]
   [-Weight <Int32>]
   [-MinChildEndpoints <Int32>]
   -TrafficManagerProfile <IProfileWithDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

El cmdlet Set-AzureTrafficManagerEndpoint actualiza las propiedades de un punto de conexión en un perfil de Microsoft Azure Traffic Manager. Si el punto de conexión no existe en el perfil actual, este cmdlet lo crea. Después de agregar un punto de conexión, pase el resultado al cmdlet Set-AzureTrafficManagerProfile mediante el operador de canalización. Ese cmdlet se conecta a Azure para guardar los cambios.

Ejemplos

Ejemplo 1: Actualización de un punto de conexión para un perfil

PS C:\>$TrafficManagerProfile = Get-AzureTrafficManagerProfile -Name "ContosoProfile"
PS C:\> Set-AzureTrafficManagerEndpoint -TrafficManagerProfile $TrafficManagerProfile -DomainName "ContosoApp02.cloudapp.net" -Status "Enabled" -Type "CloudService" -Weight 2 -Location myLocation | Set-AzureTrafficManagerProfile

El primer comando usa el cmdlet Get-AzureTrafficManagerProfile para obtener el perfil denominado ContosoProfile y, a continuación, lo almacena en la variable $TrafficManagerProfile.

El segundo comando actualiza el punto de conexión en el perfil de Traffic Manager almacenado en $TrafficManagerProfile. El punto de conexión tiene el nombre de dominio ContosoApp02.cloudapp.net. El comando también especifica el estado, el tipo, el peso y la ubicación del punto de conexión. El comando pasa el perfil modificado al cmdlet Set-AzureTrafficManagerProfile para conectarse a Azure para guardar los cambios.

Parámetros

-DomainName

Especifica el nombre de dominio del punto de conexión que se va a modificar.

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

-Location

Especifica la ubicación del punto de conexión que agrega el cmdlet. Debe ser una ubicación de Azure.

Este parámetro debe contener un valor para los puntos de conexión del tipo "Any" o del tipo "TrafficManager" en un perfil que tenga el método de equilibrio de carga establecido en "Performance". Los valores posibles son los nombres de región de Azure, como se muestra en https://azure.microsoft.com/regions/https://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

-MinChildEndpoints

Especifica el número mínimo de puntos de conexión que el perfil anidado debe tener en línea para que este punto de conexión se considere en línea.

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

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

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

-Status

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

  • habilitado
  • Disabled

Si especifica un valor de Habilitado, Traffic Manager supervisa el punto de conexión y el método de equilibrio de carga lo considera al administrar el tráfico.

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

-TrafficManagerProfile

Especifica el objeto de perfil de Traffic Manager para el que se va a modificar el punto de conexión.

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

-Type

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

  • CloudService

  • AzureWebsite

  • TrafficManager

  • Any

Si hay más de un punto de conexión de AzureWebsite, los puntos de conexión deben estar en centros de datos diferentes.

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

-Weight

Especifica el peso del punto de conexión que agrega el cmdlet. El intervalo de valores válido para este parámetro es [11000].

Este parámetro solo se usa para las directivas de equilibrio de carga roundRobin.

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

Salidas

Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition

Este cmdlet genera un objeto de perfil de Traffic Manager, que contiene información sobre el perfil actualizado.