Export (0) Print
Expand All

Add-AzureTrafficManagerEndpoint

Updated: May 29, 2014

Add-AzureTrafficManagerEndpoint

Adds an endpoint to a Traffic Manager profile.

Syntax

Parameter Set: Default
Add-AzureTrafficManagerEndpoint [-TrafficManagerProfile] <IProfileWithDefinition> -DomainName <String> -Status <String> {Enabled | Disabled} -Type <String> {CloudService | AzureWebsite | Any} [-Location <String> ] [-Weight <Int32> ] [ <CommonParameters>]




Detailed Description

The Add-AzureTrafficManagerEndpoint cmdlet adds an endpoint to a Microsoft Azure Traffic Manager profile. After you add an endpoint, pass the result to the Set-AzureTrafficManagerProfile cmdlet by using the pipeline operator. That cmdlet connects to Azure to save your changes.

Parameters

-DomainName<String>

Specifies the domain name of the endpoint to add.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Location<String>

Specifies the location of the endpoint the cmdlet adds. This must be an Azure location.

This parameter must contain a value for endpoints of the type "Any" in a profile that has the load balancing method set to "Performance". You can find a list of possible values for this parameter under Name by calling List Locations. For more information, see List Locations at http://msdn.microsoft.com/en-us/library/gg441293.aspx.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Status<String>

Specifies the status of the monitoring endpoint. Valid values are:

-- Enabled
-- Disabled

If you specify a value of Enabled, Traffic Manager monitors the endpoint and the load-balancing method considers it when managing traffic.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TrafficManagerProfile<IProfileWithDefinition>

Specifies the Traffic Manager profile object to which to add the endpoint.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true(ByValue,ByPropertyName)

Accept Wildcard Characters?

false

-Type<String>

Specifies the type of endpoint. Valid values are:

-- CloudService
-- AzureWebsite
-- Any

If there is more than one AzureWebsite endpoint, the endpoints must be in different datacenters.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Weight<Int32>

Specifies the weight of the endpoint the cmdlet adds. The valid value range for this parameter is [1,1000].

This parameter is only used for RoundRobin load balancing policies.


Aliases

none

Required?

false

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.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition

    This cmdlet generates a Traffic Manager profile object, which contains information about the updated profile.


Examples

Example 1: Add an endpoint to a profile

The first command uses the Get-AzureTrafficManagerProfile cmdlet to get the profile named ContosoProfile, and then stores it in the $TrafficManagerProfile variable.

The second command adds an endpoint to Traffic Manager profile that is stored in $TrafficManagerProfile. The endpoint has the domain name Contoso02App.couldapp.net. The command also specifies whether it is enabled and its type. The command passes the profile object to the Set-AzureTrafficManagerProfile cmdlet to connect to Azure to save your changes.


PS C:\> $TrafficManagerProfile = Get-AzureTrafficManagerProfile -Name "ContosoProfile"
PS C:\> Add-AzureTrafficManagerEndpoint -TrafficManagerProfile $TrafficManagerProfile -DomainName "Contoso02App.cloudapp.net" -Status "Enabled" -Type "CloudService" | Set-AzureTrafficManagerProfile

Example 2: Add an endpoint that has a specified location and weight

This command adds an endpoint to a Traffic Manager profile. The endpoint has the domain name Contoso02App.couldapp.net. The command also specifies whether it is enabled and its type. The command also specifies the weight and location for the endpoint. The command passes the profile object to Set-AzureTrafficManagerProfile to connect to Azure to save your changes.


PS C:\> Add-AzureTrafficManagerEndpoint -TrafficManagerProfile ContosoTrafficManagerProfile -DomainName " Contoso02App.cloudapp.net" -Status Enabled -Type CloudService -Weight 2 -Location myLocation | Set-AzureTrafficManagerProfile

Related topics

Show:
© 2014 Microsoft