---
title: "Get-VBRCapacityExtent"
description: "This cmdlet returns the capacity extent of scale-out backup repositories. The capacity extent is an object storage repository that is added to the scale-out backup repository and constitutes a capacity tier."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/get-vbrcapacityextent.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Scale-Out Backup Repositories > Capacity Tier > Get-VBRCapacityExtent"
dateModified: "2026-08-19"
---

# Get-VBRCapacityExtent

## Short Description
Returns the capacity extents.

**Platform**: VMware, Hyper-V

**Product Edition**: Standard, Enterprise, Enterprise Plus, Veeam Universal License

## Syntax
```
Get-VBRCapacityExtent -Repository <VBRScaleOutBackupRepository[]> [<CommonParameters>]
```

## Detailed Description
This cmdlet returns the capacity extent of scale-out backup repositories. The capacity extent is an object storage repository that is added to the scale-out backup repository and constitutes a capacity tier.

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Repository</span></p>
        </td>
        <td>
          <p>Specifies an array of scale-out backup repositories. The cmdlet will return the capacity extent added to this repository.</p><p>Accepts the <a href="vbrscaleoutbackuprepository.md"><code>VBRScaleOutBackupRepository</code></a><code>[]</code> object. To get the object, run the <a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrscaleoutbackuprepository.md"><code>VBRScaleOutBackupRepository[]</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
[`VBRCapacityExtent[]`](vbrcapacityextent.md)

## Examples

::: example
### Getting Capacity Extents Added to Scale-Out Backup Repository

This example shows how to get the capacity extents added to the scale-out backup repository.

```
$repository = Get-VBRBackupRepository -ScaleOut
Get-VBRCapacityExtent -Repository $repository
```

Perform the following steps:

1. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Provide the `ScaleOut` parameter. Save the result to the `$repository` variable.
2. Run the `Get-VBRCapacityExtent` cmdlet. Set the `$repository` variable as the `Repository` parameter value.

:::

## Related Commands

[`Get-VBRBackupRepository`](get-vbrbackuprepository.md)