< Back
New-AzureRmTrafficManagerProfile
Post
NAME New-AzureRmTrafficManagerProfile
SYNOPSIS
Creates a Traffic Manager profile.
SYNTAX
New-AzureRmTrafficManagerProfile [-DefaultProfile <IAzureContextContainer>] [-MonitorIntervalInSeconds <Int32>] [-MonitorPath <String>]
-MonitorPort <UInt32> -MonitorProtocol {HTTP | HTTPS | TCP} [-MonitorTimeoutInSeconds <Int32>] [-MonitorToleratedNumberOfFailures <Int32>] -Name
<String> [-ProfileStatus {Enabled | Disabled}] -RelativeDnsName <String> -ResourceGroupName <String> [-Tag <Hashtable>] -TrafficRoutingMethod
{Performance | Weighted | Priority | Geographic} -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.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-MonitorIntervalInSeconds <Int32>
The interval (in seconds) at which Traffic Manager will check the health of each endpoint in this profile. The default is 30.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-MonitorPath <String>
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 (/).
Required? false
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.
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
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-MonitorTimeoutInSeconds <Int32>
The time (in seconds) that Traffic Manager allows endpoints in this profile to respond to the health check. The default is 10.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-MonitorToleratedNumberOfFailures <Int32>
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.
Required? false
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.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ProfileStatus <String>
Specifies the status of the profile. Valid values are: Enabled and Disabled.
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.
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.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Tag <Hashtable>
Key-value pairs in the form of a hash table set as tags on the server. For example:
@{key0="value0";key1=$null;key2="value2"}
Required? false
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
- Geographic
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Ttl <UInt32>
Specifies the DNS Time to Live (TTL) value.
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, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
This cmdlet does not accept any input.
OUTPUTS
Microsoft.Azure.Commands.Network.TrafficManagerProfile
This cmdlet returns a new TrafficManagerProfile object.
NOTES
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.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... gerprofile
Add-AzureRmTrafficManagerEndpointConfig
Disable-AzureRmTrafficManagerProfile
Enable-AzureRmTrafficManagerProfile
Get-AzureRmTrafficManagerProfile
Remove-AzureRmTrafficManagerProfile
Set-AzureRmTrafficManagerProfile
SYNOPSIS
Creates a Traffic Manager profile.
SYNTAX
New-AzureRmTrafficManagerProfile [-DefaultProfile <IAzureContextContainer>] [-MonitorIntervalInSeconds <Int32>] [-MonitorPath <String>]
-MonitorPort <UInt32> -MonitorProtocol {HTTP | HTTPS | TCP} [-MonitorTimeoutInSeconds <Int32>] [-MonitorToleratedNumberOfFailures <Int32>] -Name
<String> [-ProfileStatus {Enabled | Disabled}] -RelativeDnsName <String> -ResourceGroupName <String> [-Tag <Hashtable>] -TrafficRoutingMethod
{Performance | Weighted | Priority | Geographic} -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.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-MonitorIntervalInSeconds <Int32>
The interval (in seconds) at which Traffic Manager will check the health of each endpoint in this profile. The default is 30.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-MonitorPath <String>
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 (/).
Required? false
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.
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
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-MonitorTimeoutInSeconds <Int32>
The time (in seconds) that Traffic Manager allows endpoints in this profile to respond to the health check. The default is 10.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-MonitorToleratedNumberOfFailures <Int32>
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.
Required? false
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.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ProfileStatus <String>
Specifies the status of the profile. Valid values are: Enabled and Disabled.
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.
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.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Tag <Hashtable>
Key-value pairs in the form of a hash table set as tags on the server. For example:
@{key0="value0";key1=$null;key2="value2"}
Required? false
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
- Geographic
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Ttl <UInt32>
Specifies the DNS Time to Live (TTL) value.
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, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
This cmdlet does not accept any input.
OUTPUTS
Microsoft.Azure.Commands.Network.TrafficManagerProfile
This cmdlet returns a new TrafficManagerProfile object.
NOTES
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.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... gerprofile
Add-AzureRmTrafficManagerEndpointConfig
Disable-AzureRmTrafficManagerProfile
Enable-AzureRmTrafficManagerProfile
Get-AzureRmTrafficManagerProfile
Remove-AzureRmTrafficManagerProfile
Set-AzureRmTrafficManagerProfile