< Back
New-NsxLoadBalancerPool
Post
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
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