New-AzureTrafficManagerProfile

New-AzureTrafficManagerProfile

Creates an Azure Traffic Manager profile.

Syntax

Parameter Set: Default
New-AzureTrafficManagerProfile -MonitorPath <String> -MonitorPort <UInt32> -MonitorProtocol <String> {HTTP | HTTPS} -Name <String> -RelativeDnsName <String> -ResourceGroupName <String> -TrafficRoutingMethod <String> {Performance | Weighted | Priority} -Ttl <UInt32> [-Profile <AzureProfile> ] [ <CommonParameters>]

Detailed Description

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

This cmdlet does not configure Traffic Manager endpoints. Update the local profile object by using the Add-AzureTrafficManagerEndpointConfig cmdlet. Then upload changes to Traffic Manager by using the Set-AzureTrafficManagerProfile cmdlet.

Parameters

-MonitorPath<String>

Specifies the path used to monitor endpoint health. Specify a value relative to the endpoint domain name.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-MonitorPort<UInt32>

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

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-MonitorProtocol<String>

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

-- HTTP
-- HTTPS

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Name<String>

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

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Profile<AzureProfile>

Specifies an Azure profile.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-RelativeDnsName<String>

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.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ResourceGroupName<String>

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

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-TrafficRoutingMethod<String>

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

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Ttl<UInt32>

Specifies a Time to Live (TTL) value.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

• Microsoft.Azure.Commands.Network.TrafficManagerProfile

  This cmdlet returns a new TrafficManagerProfile object.

Examples

Example 1: Create a profile

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

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

Related topics

Get-AzureTrafficManagerProfile

Remove-AzureTrafficManagerProfile

Set-AzureTrafficManagerProfile

Add-AzureTrafficManagerEndpointConfig