Share via


Set-AzureLoadBalancedEndpoint

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Set-AzureLoadBalancedEndpoint

Updates all of the endpoints in a load-balanced set.

Parameter Set: DefaultProbe
Set-AzureLoadBalancedEndpoint [-ServiceName] <String> -LBSetName <String> [-ACL <NetworkAclObject> ] [-DirectServerReturn <Boolean> ] [-LocalPort <Int32> ] [-Protocol <String> ] [-PublicPort <Int32> ] [ <CommonParameters>]

Parameter Set: HTTPProbe
Set-AzureLoadBalancedEndpoint [-ServiceName] <String> -LBSetName <String> -ProbePath <String> -ProbeProtocolHTTP [-ACL <NetworkAclObject> ] [-DirectServerReturn <Boolean> ] [-LocalPort <Int32> ] [-ProbeIntervalInSeconds <Int32> ] [-ProbePort <Int32> ] [-ProbeTimeoutInSeconds <Int32> ] [-Protocol <String> ] [-PublicPort <Int32> ] [ <CommonParameters>]

Parameter Set: TCPProbe
Set-AzureLoadBalancedEndpoint [-ServiceName] <String> -LBSetName <String> -ProbeProtocolTCP [-ACL <NetworkAclObject> ] [-DirectServerReturn <Boolean> ] [-LocalPort <Int32> ] [-ProbeIntervalInSeconds <Int32> ] [-ProbePort <Int32> ] [-ProbeTimeoutInSeconds <Int32> ] [-Protocol <String> ] [-PublicPort <Int32> ] [ <CommonParameters>]

This topic describes the cmdlet in the .6.19 version of the Windows Azure PowerShell module. To find out the version of the module you're using, from the Windows Azure PowerShell console, type (get-module azure).version.

This cmdlet updates all of the endpoints in a given load-balanced set within a Windows Azure Service.

-ACL<NetworkAclObject>

Specifies an ACL to apply to the endpoint on update.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DirectServerReturn<Boolean>

Enables or disables Direct Server Return.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-LBSetName<String>

Specifies the name of the load-balanced set to update.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-LocalPort<Int32>

Specifies the local (private) port to be used for the endpoint. Applications running in the virtual machine listen to this port to service input requests over the endpoint.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ProbeIntervalInSeconds<Int32>

Specifies the probe polling interval in seconds.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ProbePath<String>

Specifies the relative path to the HTTP probe.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ProbePort<Int32>

Specifies the port for the load balancer probe to use. If not specified, Windows Azure assigns the endpoint’s local port.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ProbeProtocolHTTP

Specifies that a HTTP probe should be used.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ProbeProtocolTCP

Specifies that a TCP probe should be used.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ProbeTimeoutInSeconds<Int32>

Specifies the probe polling timeout in seconds.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Protocol<String>

Specifies the protocol to be used on the endpoint, either “TCP” or “UDP”.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PublicPort<Int32>

Specifies the public port for the endpoint to use. If not specified, Windows Azure assigns an available free port

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ServiceName<String>

Specifies the name of the service to which the load-balanced set applies.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see  about_CommonParameters (https://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.

Example

This example updates all endpoints in the load-balanced set "LBSet1" to use the TCP protocol and private port 80, and sets the load balancer probe to use the TCP protocol on port 8080.

PS C:\> Set-AzureLoadBalancedEndpoint -ServiceName "MyService" -LBSetName "LBSet1" -Protocol tcp -LocalPort 80 -ProbeProtocolTCP -ProbePort 8080

Get-AzureEndpoint

Set-AzureEndpoint