---
title: "Add-VolumeRange"
slug: "scripting-add-volumerange"
updated: 2025-07-15T19:03:28Z
published: 2025-07-15T19:03:28Z
canonical: "help.agilityblue.com/scripting-add-volumerange"
---

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

# Add-VolumeRange

## Summary

Creates a new volume range.

```powershell
Add-VolumeRange
    -Entry
    -IncludeVolume
```

Returns a [volume range](https://apidocs.agilityblue.com/#be5f5383-f972-44cf-b541-17b74e79bb16) object.

## Parameters

| Parameter | Type | Required? | Notes |
| --- | --- | --- | --- |
| Entry | [Volume range](https://apidocs.agilityblue.com/#be5f5383-f972-44cf-b541-17b74e79bb16) object | Yes |  |
| IncludeVolume | Switch | No, Defaults to `false` | Adds the parent `Volume` property to the output. |

## Examples

### Create a new volume range

```powershell
# Create a new volume range

# Create an object with the necessary fields to create the volume range
# A volume range requires a parent volume id, beg no, and end no fields.

$entry = @{
    VolumeId    = 10
    BegNo       = "A000001"
    EndNo       = "A999999"
}

# Create the volume range. The created entry will be returned back.
$data = Add-VolumeRange -Entry $entry

# Output some information to help indicate that the volume range was created
Write-Output "Volume range $($data.VolumeRangeId) ($($data.BegNo) - $($data.EndNo)) was created on volume $($data.VolumeId)"

# For debug purposes, convert the data to output as JSON so we can see all the fields
Write-Output ""
Write-Output "JSON Results:"

$jsonOutput = $data | ConvertTo-Json -Depth 10

# Output the data
Write-Output $jsonOutput
```

Execution results:

```plaintext
Volume range 22 (A000001 - A999999) was created on volume 10

JSON Results:
{
  "VolumeRangeId": 22,
  "VolumeId": 10,
  "BegNo": "A000001",
  "EndNo": "A999999",
  "CreatedByFullName": "Max Miller",
  "CreatedById": "510e109b-6ff5-4442-9670-cd5e3cd82a7a",
  "CreatedOn": "2025-07-15T19:01:59.3193846+00:00",
  "CreatedBy": null,
  "LastUpdatedByFullName": "Max Miller",
  "LastUpdatedById": "510e109b-6ff5-4442-9670-cd5e3cd82a7a",
  "LastUpdatedOn": "2025-07-15T19:01:59.3193846+00:00",
  "LastUpdatedBy": null,
  "Volume": null
}
```