Add-AzureInternalLoadBalancer

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

Add-AzureInternalLoadBalancer

Adds an internal load balancer configuration to a cloud service.

Syntax

Parameter Set: ServiceAndSlot
Add-AzureInternalLoadBalancer [-InternalLoadBalancerName] <String> [-ServiceName] <String> [ <CommonParameters>]

Parameter Set: SubnetNameAndIP
Add-AzureInternalLoadBalancer [-InternalLoadBalancerName] <String> [-ServiceName] <String> [-SubnetName] <String> [-StaticVNetIPAddress] <IPAddress> [ <CommonParameters>]

Parameter Set: SubnetNameOnly
Add-AzureInternalLoadBalancer [-InternalLoadBalancerName] <String> [-ServiceName] <String> [-SubnetName] <String> [ <CommonParameters>]

Detailed Description

The Add-InternalLoadBalancer cmdlet creates an internal load balancer and adds it to a cloud service. Virtual network users can use the parameters of this cmdlet to specify the subnet or the IP address of the internal load balancer.

For more information about internal load balancing, see "Load Balancing for Azure Infrastructure Services" (http://azure.microsoft.com/en-us/documentation/articles/load-balance-virtual-machines) and "Internal load balancing" (http://msdn.microsoft.com/en-us/library/azure/dn690121.aspx,) in the MSDN library and "Internal Load Balancing" (http://azure.microsoft.com/blog/2014/05/20/internal-load-balancing/) in the Microsoft Azure Blog.

Parameters

-InternalLoadBalancerName<String>

Specifies a name for the internal load balancer. The name identifies the load balancer in endpoints. This parameter is required.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ServiceName<String>

Adds the new internal load balancer to the specified cloud service. Enter the name of a cloud service. This parameter is required.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-StaticVNetIPAddress<IPAddress>

Specified a static IP address in your VNet address space. This parameter is optional. By default, Add-AzureInternalLoadBalancer selects an IP address from the subnet specified by the SubnetName parameter.

In a cloud service, the load balanced IP is acquired from Azure's private IP address space. In a virtual network, the load balanced IP is acquired from a virtual subnet or a specified static VNet IP address.

Aliases

none

Required?

true

Position?

4

Default Value

An IP address from the specified subnet

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SubnetName<String>

Identifies the subnet from which the IP address for the internal load balancer is allocated. Enter a subnet name. If you omit the StaticVNetIPAddress parameter, the cmdlet selects an IP address from this subnet.

In a cloud service, the load balanced IP is acquired from Azure's private IP address space. In a virtual network, the load balanced IP is acquired from a virtual subnet or a specified static VNet IP address.

Aliases

none

Required?

true

Position?

3

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 (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.Common.ManagementOperationContext

Examples

-------------------------- EXAMPLE 1 --------------------------

Description

-----------

This command adds the MyILB internal load balancer to the deployment of MyWebsite1.

PS C:\> Add-AzureInternalLoadBalancer -ServiceName MyWebsite1 -InternalLoadBalancerName MyILB

-------------------------- EXAMPLE 2 --------------------------

Description

-----------

This command adds the MyILB internal load balancer to a deployment of a virtual network for MyWebsite1. It uses the Subnet parameter to specify the subnet of the virtual network from which the load balancer IP should be allocated.

PS C:\> Add-AzureInternalLoadBalancer -ServiceName MyWebsite1 -InternalLoadBalancerName MyILB -SubnetName FrontEndSubnet

-------------------------- EXAMPLE 3 --------------------------

Description

-----------

This command adds the MyILB internal load balancer to a deployment of a virtual network. It uses the Subnet parameter to specify the subnet of the virtual network from which the load balancer IP should be allocated and the StaticVNetIPAddress parameter to specify the exact IP address in that subnet that should be allocated to the internal load balancer.

PS C:\> Add-AzureInternalLoadBalancer -ServiceName MyWebsite1 -InternalLoadBalancerName MyILB -ServiceName svc1 -SubnetName FrontEndSubnet -StaticVNetIPAddress 192.168.4.7

Get-AzureInternalLoadBalancer

Remove-AzureInternalLoadBalancer

New-AzureInternalLoadBalancer