< Back

New-NsxLoadBalancerPool

Sat Jan 18, 2020 9:17 pm

NAME New-NsxLoadBalancerPool



SYNOPSIS

Creates a new LoadBalancer Pool on the specified ESG.





SYNTAX

New-NsxLoadBalancerPool [-LoadBalancer] <XmlElement> -Name <String> [-Description <String>] [-Transparent]

-Algorithm <String> [-Monitor <XmlElement>] [-MemberSpec <XmlElement[]>] [-Connection <PSObject>]

[<CommonParameters>]





DESCRIPTION

An NSX Edge Service Gateway provides all NSX Edge services such as firewall,

NAT, DHCP, VPN, load balancing, and high availability.



The NSX Edge load balancer enables network traffic to follow multiple paths

to a specific destination. It distributes incoming service requests evenly

among multiple servers in such a way that the load distribution is

transparent to users. Load balancing thus helps in achieving optimal

resource utilization, maximizing throughput, minimizing response time, and

avoiding overload. NSX Edge provides load balancing up to Layer 7.



A pool manages load balancer distribution methods and has a service monitor

attached to it for health check parameters. Each Pool has one or more

members. Prior to creating or updating a pool to add a member, a member

spec describing the member needs to be created.



This cmdlet creates a new LoadBalancer Pool on the specified ESG.





PARAMETERS

-LoadBalancer <XmlElement>



Required? true

Position? 2

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-Name <String>



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Description <String>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Transparent [<SwitchParameter>]



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-Algorithm <String>



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Monitor <XmlElement>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-MemberSpec <XmlElement[]>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Connection <PSObject>

PowerNSX Connection object



Required? false

Position? named

Default value $defaultNSXConnection

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 (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



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



PS C:\\>Example1: Need to create member specs for each of the pool members first



PS C:\\> $WebMember1 = New-NsxLoadBalancerMemberSpec -name Web01

-IpAddress 192.168.200.11 -Port 80



PS C:\\> $WebMember2 = New-NsxLoadBalancerMemberSpec -name Web02

-IpAddress 192.168.200.12 -Port 80 -MonitorPort 8080

-MaximumConnections 100



PS C:\\> $WebPool = Get-NsxEdge Edge01 | New-NsxLoadBalancerPool -Name WebPool

-Description "WebServer Pool" -Transparent:$false -Algorithm round-robin

-Monitor $monitor -MemberSpec $WebMember1,$WebMember2











RELATED LINKS