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.

```yaml 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.

```yaml 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.

```yaml 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 }}

```yaml 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