New-AzureTrafficManagerProfile

  • Referencia
Módulo:
Azure

Crea 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

New-AzureTrafficManagerProfile
   -Name <String>
   -DomainName <String>
   -LoadBalancingMethod <String>
   -MonitorPort <Int32>
   -MonitorProtocol <String>
   -MonitorRelativePath <String>
   -Ttl <Int32>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

El cmdlet New-AzureTrafficManagerProfile crea un perfil de Microsoft Azure Traffic Manager.

Después de crear un perfil en el que establezca el valor LoadBalancingMethod en "Conmutación por error", puede determinar el orden de conmutación por error de los puntos de conexión que agregue al perfil con el cmdlet Add-AzureTrafficManagerEndpoint. Para obtener más información, vea el ejemplo 2 siguiente.

Ejemplos

Ejemplo 1: Creación de un perfil de Traffic Manager

PS C:\>New-AzureTrafficManagerProfile -Name "MyProfile" -DomainName "My.profile.trafficmanager.net" -LoadBalancingMethod "RoundRobin" -Ttl 30 -MonitorProtocol "Http" -MonitorPort 80 -MonitorRelativePath "/"

Este comando crea un perfil de Traffic Manager denominado MyProfile en el dominio de Traffic Manager especificado con un método de equilibrio de carga Round Robin, un TTL de 30 segundos, protocolo de supervisión HTTP, puerto de supervisión 80 y con la ruta de acceso especificada.

Ejemplo 2: 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

-DomainName

Especifica el nombre de dominio del perfil de Traffic Manager. Debe ser un subdominio de trafficmanager.net.

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

-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:True
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:True
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:True
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:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

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

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

-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 enteros de 30 a 999 999.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:True
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.