Compartir a través de

Set-AzureTrafficManagerProfile

  • Referencia
Módulo:
Azure

Actualiza las propiedades de 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-AzureTrafficManagerProfile
   [-Name <String>]
   [-LoadBalancingMethod <String>]
   [-MonitorPort <Int32>]
   [-MonitorProtocol <String>]
   [-MonitorRelativePath <String>]
   [-Ttl <Int32>]
   -TrafficManagerProfile <IProfileWithDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

El cmdlet Set-AzureTrafficManagerProfile actualiza las propiedades de un perfil de Microsoft Azure Traffic Manager.

Para los perfiles para los que ha establecido el valor LoadBalancingMethod en "Conmutación por error", puede determinar el orden de conmutación por error de los puntos de conexión que ha agregado al perfil con el cmdlet Add-AzureTrafficManagerEndpoint. Para obtener más información, vea el ejemplo 3 siguiente.

Ejemplos

Ejemplo 1: Establecimiento del TTL para un perfil de Traffic Manager

PS C:\>Set-AzureTrafficManagerProfile -TrafficManagerProfile $MyTrafficManagerProfile -Ttl 60

Este comando establece el TTL en 60 segundos para el objeto de perfil de Traffic Manager MyTrafficManagerProfile.

Ejemplo 2: Establecer varios valores para un perfil

PS C:\>Get-AzureTrafficManagerProfile -Name "MyProfile" | Set-AzureTrafficManagerProfile -LoadBalancingMethod "RoundRobin" -Ttl 30 -MonitorProtocol "Http" -MonitorPort 80 -MonitorRelativePath "/"

Este comando obtiene un perfil de Traffic Manager denominado MyProfile mediante el cmdlet Get-AzureTrafficManagerProfile . El perfil usa el método de equilibrio de carga RoundRobin, un TTL de 30 segundos, el protocolo de supervisión HTTP, el puerto de supervisión y la ruta de acceso relativa de un perfil de Traffic Manager.

Ejemplo 3: Reordenar los puntos de conexión al orden de conmutación por error deseado

PS C:\>$Profile = Get-AzureTrafficManagerProfile -Name "MyProfile"
PS C:\> $Profile.Endpoints[0],$Profile.Endpoints[1] = $Profile.Endpoints[1],$Profile.Endpoints[0]
PS C:\> $Profile = Set-AzureTrafficManagerProfile

En este ejemplo se reordenan los puntos de conexión agregados a MyProfile al orden de conmutación por error deseado.

El primer comando obtiene el objeto de perfil de Traffic Manager denominado MyProfile y almacena el objeto en la variable $Profile.

El segundo comando ordena de nuevo los puntos de conexión de la matriz de puntos de conexión al orden en el que se debe producir la conmutación por error.

El último comando actualiza el perfil de Traffic Manager almacenado en $Profile con el nuevo orden de punto de conexión.

Parámetros

-LoadBalancingMethod

Especifica el método de equilibrio de carga que se va a usar para distribuir la conexión. Los valores válidos son:

  • Rendimiento
  • Conmutación por error
  • RoundRobin
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MonitorPort

Especifica el puerto usado para supervisar el estado del punto de conexión. Los valores válidos son valores enteros mayores que 0 y menores o iguales que 65 535.

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

-MonitorProtocol

Especifica el protocolo que se va a usar para supervisar el estado de los puntos de conexión. Los valores válidos son:

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

-MonitorRelativePath

Especifica la ruta de acceso relativa al nombre de dominio del punto de conexión que se va a sondear para el estado de mantenimiento. La ruta de acceso debe cumplir las restricciones siguientes:

  • La ruta de acceso debe tener entre 1 y 1000 caracteres.
  • Debe comenzar con una barra diagonal, /.
  • No debe contener elementos XML, <>.
  • No debe contener barras diagonales dobles, //.
  • No debe contener caracteres de escape HTML no válidos. Por ejemplo, %XY.
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre del perfil de Traffic Manager que se va a actualizar.

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

-TrafficManagerProfile

Especifica el objeto de perfil de Traffic Manager que se usa para establecer el perfil.

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

-Ttl

Especifica el período de vida (TTL) de DNS que informa a los solucionadores DNS locales cuánto tiempo se almacenan en caché las entradas DNS. Los valores válidos son un entero comprendido entre 30 y 999 999.

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.