Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

New-AzureTrafficManagerProfile

New-AzureTrafficManagerProfile

microsoft.azure.commands.trafficmanager.dll, microsoft.windowsazure.commands.trafficmanager.dll

Synopsis

Creates an Azure Traffic Manager profile.

Syntax

New-AzureTrafficManagerProfile [-Profile] [-MonitorPath] [-MonitorPort] [-MonitorProtocol] [-Name] [-RelativeDnsName] [-ResourceGroupName] [-TrafficRoutingMethod] [-Ttl] [<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

Input Type


Return Type

Microsoft.Azure.Commands.Network.TrafficManagerProfile

Notes

None

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