< Back

Set-AzureRmTrafficManagerEndpoint

Tue Jan 29, 2019 10:11 pm

NAME Set-AzureRmTrafficManagerEndpoint



SYNOPSIS

Updates a Traffic Manager endpoint.





SYNTAX

Set-AzureRmTrafficManagerEndpoint [-DefaultProfile <IAzureContextContainer>] -TrafficManagerEndpoint <TrafficManagerEndpoint> [<CommonParameters>]





DESCRIPTION

The Set-AzureRmTrafficManagerEndpoint cmdlet updates an endpoint in Azure Traffic Manager. This cmdlet updates the settings from a local endpoint

object. You can specify the endpoint object either by using the TrafficManagerEndpoint parameter or by using the pipeline.



You can obtain a local object that represents an endpoint by using the Get-AzureRmTrafficManagerEndpoint cmdlet. Modify the object locally and

then use Set-AzureRmTrafficManagerEndpoint to commit your changes.





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



-TrafficManagerEndpoint <TrafficManagerEndpoint>

Specifies a local TrafficManagerEndpoint object. This cmdlet updates Traffic Manager to match this local object.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByValue)

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

Microsoft.Azure.Commands.Network.TrafficManagerEndpoint

This cmdlet accepts a TrafficManagerEndpoint object.





OUTPUTS

Microsoft.Azure.Commands.Network.TrafficManagerEndpoint

This cmdlet returns a TrafficManagerEndpoint object.





NOTES









Example 1: Update an endpoint



PS C:\\>$TrafficManagerEndpoint = Get-AzureRmTrafficManagerEndpoint -Name "endpoint1" -Type AzureEndpoints -ProfileName "ContosoProfile"

-ResourceGroupName "ResourceGroup11"

PS C:\\> $TrafficManagerEndpoint.Weight = 20

PS C:\\> Set-AzureRmTrafficManagerEndpoint -TrafficManagerEndpoint $TrafficManagerEndpoint



The first command gets an Azure Traffic Manager endpoint by using the Get-AzureRmTrafficManagerEndpoint cmdlet. The command stores the endpoint

locally in the $TrafficManagerEndpoint variable.



The second command changes that endpoint locally. This command changes the endpoint weight to 20.



The third command updates the endpoint in Traffic Manager to match the local value in $TrafficManagerEndpoint.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... erendpoint