New-NsxIpPool

NAME New-NsxIpPool



SYNOPSIS

Creates a new IP Pool.





SYNTAX

New-NsxIpPool [-Name] <String> -Gateway <IPAddress> -SubnetPrefixLength <String> [-DnsServer1 <IPAddress>]

[-DnsServer2 <IPAddress>] [-DnsSuffix <String>] -StartAddress <IPAddress> -EndAddress <IPAddress> [-Connection

<PSObject>] [<CommonParameters>]





DESCRIPTION

An IP Pool is a simple IPAM construct in NSX that simplifies automated IP

address asignment for multiple NSX technologies including VTEP interfaces

NSX Controllers.



The New-NsxIpPool cmdlet creates a new IP Pool on the connected NSX manager.





PARAMETERS

-Name <String>

Name of IP Pool



Required? true

Position? 2

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Gateway <IPAddress>

Gateway address



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-SubnetPrefixLength <String>

Prefix length of network address (1-31)



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-DnsServer1 <IPAddress>

IP Address of first DNS Server



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-DnsServer2 <IPAddress>

IP Address of second DNS Server



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-DnsSuffix <String>

DNS Domain Name



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-StartAddress <IPAddress>

First Valid Address in the pool



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-EndAddress <IPAddress>

Last Valid Address in the pool



Required? true

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:\\>New-NsxIpPool -name Controller_Pool -Gateway "192.168.103.1"



-SubnetPrefixLength "24" -DnsServer1 "192.168.100.4" -DnsSuffix "lab.local"

-StartAddress "192.168.103.101" -EndAddress "192.168.103.115"



This example creates a pool called Controller_Pool. It uses the IP range

192.168.103.101-115, has a defined gateway of 192.168.103.1 and has DNS

settings configured.











RELATED LINKS