New-​Azure​Rm​Traffic​Manager​Profile

Creates a Traffic Manager profile.

Syntax

New-AzureRmTrafficManagerProfile
   [-MonitorIntervalInSeconds <Int32>]
   [-MonitorPath <String>]
   -MonitorPort <UInt32>
   -MonitorProtocol <String>
   [-MonitorTimeoutInSeconds <Int32>]
   [-MonitorToleratedNumberOfFailures <Int32>]
   -Name <String>
   [-ProfileStatus <String>]
   -RelativeDnsName <String>
   -ResourceGroupName <String>
   [-Tag <Hashtable>]
   -TrafficRoutingMethod <String>
   -Ttl <UInt32>
   [<CommonParameters>]

Description

The New-AzureRmTrafficManagerProfile cmdlet creates an Azure Traffic Manager profile. Specify the Name parameter and required settings. This cmdlet returns a local object that represents the new profile.

This cmdlet does not configure Traffic Manager endpoints. You can update the local profile object by using the Add-AzureRmTrafficManagerEndpointConfig cmdlet. Then upload changes to Traffic Manager by using the Set-AzureRmTrafficManagerProfile cmdlet. Alternatively, you can add endpoints by using the New-AzureRmTrafficManagerEndpoint cmdlet.

Examples

Example 1: Create a profile

PS C:\>New-AzureRmTrafficManagerProfile -Name "ContosoProfile" -ResourceGroupName "ResourceGroup11" -ProfileStatus Enabled -TrafficRoutingMethod Performance -RelativeDnsName "contosoapp" -TTL 30 -MonitorProtocol HTTP -MonitorPort 80 -MonitorPath "/default.aspx"

This command creates an Azure Traffic Manager profile named ContosoProfile in resource group ResourceGroup11. The DNS FQDN is contosoapp.trafficmanager.net.

Required Parameters

-MonitorPort

Specifies the TCP port that is used to monitor endpoint health. Valid values are integers from 1 through 65535.

Type:UInt32
Aliases:PortForMonitor
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MonitorProtocol

Specifies the protocol to use to monitor endpoint health. Valid values are:

  • HTTP
  • HTTPS
Type:String
Aliases:ProtocolForMonitor
Parameter Sets:HTTP, HTTPS, TCP
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Specifies a name for the Traffic Manager profile that this cmdlet creates.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RelativeDnsName

Specifies the relative DNS name that this Traffic Manager profile provides. Traffic Manager combines this value and the DNS domain name that Azure Traffic Manager uses to form the fully qualified domain name (FQDN) of the profile.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ResourceGroupName

Specifies the name of a resource group. This cmdlet creates a Traffic Manager profile in the group that this parameter specifies.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TrafficRoutingMethod

Specifies the traffic routing method. This method determines which endpoint Traffic Manager returns in response to incoming DNS queries. Valid values are:

  • Performance
  • Weighted
  • Priority
Type:String
Parameter Sets:Performance, Weighted, Priority, Geographic
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Ttl

Specifies the DNS Time to Live (TTL) value.

Type:UInt32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-MonitorIntervalInSeconds

The interval (in seconds) at which Traffic Manager will check the health of each endpoint in this profile. The default is 30.

Type:Int32
Aliases:IntervalInSecondsForMonitor
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MonitorPath

Specifies the path that is used to monitor endpoint health. Specify a value relative to the endpoint domain name. This value must begin with a slash (/).

Type:String
Aliases:PathForMonitor
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MonitorTimeoutInSeconds

The time (in seconds) that Traffic Manager allows endpoints in this profile to respond to the health check. The default is 10.

Type:Int32
Aliases:TimeoutInSecondsForMonitor
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MonitorToleratedNumberOfFailures

The number of consecutive failed health checks that Traffic Manager tolerates before declaring an endpoint in this profile Degraded after the next consecutive failed health check. The default is 3.

Type:Int32
Aliases:ToleratedNumberOfFailuresForMonitor
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ProfileStatus

Specifies the status of the profile. Valid values are: Enabled and Disabled.

Type:String
Parameter Sets:Enabled, Disabled
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Tag

Specifies tags as an array of hash tables.

Type:Hashtable
Aliases:Tags
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Microsoft.Azure.Commands.Network.TrafficManagerProfile

This cmdlet returns a new TrafficManagerProfile object.