---
title: "Get-NectarUnallocatedNumber"
slug: "get-nectarunallocatednumber"
updated: 2023-05-15T17:41:31Z
published: 2023-05-15T17:41:31Z
canonical: "support.nectarcorp.com/get-nectarunallocatednumber"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.nectarcorp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get-NectarUnallocatedNumber

Returns the next available number in a given location/range.

## Syntax

```
Get-NectarUnallocatedNumber
  -LocationName  <String>
  -RangeName  <String>
  -TenantName  <String>
```

## Examples

### Example 1

```
Get-NectarUnallocatedNumber -RangeName Jericho
```

Returns the next available number in the Jericho range.

## Parameters

**-LocationName <String>** The service location to return a number for

| Parameter | Value |
| --- | --- |
| Required | false |
| Position | 1 |
| Required | false |
| Default Value | None |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |

**-RangeName <String>** The range to return a number for

| Parameter | Value |
| --- | --- |
| Required | false |
| Position | 2 |
| Required | false |
| Default Value | None |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |

**-TenantName <String>** The name of the Nectar DXP tenant. Used in multi-tenant configurations.

| Parameter | Value |
| --- | --- |
| Required | false |
| Position | 3 |
| Required | false |
| Default Value | None |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |