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 (http://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" 

Get-AzureTrafficManagerProfile

Remove-AzureTrafficManagerProfile

Set-AzureTrafficManagerProfile

Add-AzureTrafficManagerEndpointConfig