Skip to content

Get-NBIPAMAvailableIP

Since

v1.0.4

SYNOPSIS

A convenience method for returning available IP addresses within a prefix

SYNTAX

Get-NBIPAMAvailableIP [-Prefix_ID] <UInt64> [[-Limit] <UInt16>] [-Raw] [-ProgressAction <ActionPreference>]
 [<CommonParameters>]

DESCRIPTION

By default, the number of IPs returned will be equivalent to PAGINATE_COUNT. An arbitrary limit (up to MAX_PAGE_SIZE, if set) may be passed, however results will not be paginated

EXAMPLES

EXAMPLE 1

Get-NBIPAMAvailableIP -Prefix_ID (Get-NBIPAMPrefix -Prefix 192.0.2.0/24).id

Get (Next) Available IP on the Prefix 192.0.2.0/24

EXAMPLE 2

Get-NBIPAMAvailableIP -Prefix_ID 2 -NumberOfIPs 3

Get 3 (Next) Available IP on the Prefix 192.0.2.0/24

PARAMETERS

-Prefix_ID

Database ID of the prefix to get available IPs from.

Type: UInt64
Parameter Sets: (All)
Aliases: Id

Required: True
Position: 1
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Limit

Maximum number of available IPs to return.

Type: UInt16
Parameter Sets: (All)
Aliases: NumberOfIPs

Required: False
Position: 2
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-Raw

Return the raw API response.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ProgressAction

{{ Fill ProgressAction Description }}

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

System.Management.Automation.PSObject

NOTES

AddedInVersion: v1.0.4

Common parameters

common request params
common pagination params