---
title: "Enable-VBRRepositoryExtentMaintenanceMode"
description: "This cmdlet enables Maintenance mode for a selected performance extent or extents of scale-out backup repositories. With one command, you can switch to Maintenance mode multiple performance extents: the extents can be of mixed policies and belong..."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/enable-vbrrepositoryextentmaintenancemode.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Scale-Out Backup Repositories > Performance Tier > Enable-VBRRepositoryExtentMaintenanceMode"
dateModified: "2026-08-19"
---

# Enable-VBRRepositoryExtentMaintenanceMode

## Short Description
Enables Maintenance mode for a performance extent or capacity extent of a scale-out backup repository.

**Platform**: VMware, Hyper-V

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

## Syntax
```
Enable-VBRRepositoryExtentMaintenanceMode -Extent <VBRRepositoryExtent[]> [-RunAsync] [<CommonParameters>]
```

## Detailed Description
This cmdlet enables Maintenance mode for a selected performance extent or extents of scale-out backup repositories.

With one command, you can switch to Maintenance mode multiple performance extents: the extents can be of mixed policies and belong to several scale-out repositories.

## 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">Extent</span></p>
        </td>
        <td>
          <p>Specifies the array of scale-out repository extents. The cmdlet will enable the Maintenance mode for these extents.</p><p>Accepts extents with different policies and of different scale-out repositories.</p><p>Accepts the ID, the String (name of the backup repository that is used as extent), or the <a href="vbrrepositoryextent.md"><code>VBRRepositoryExtent</code></a> [] object.</p><p>To get the performance extent, run the <a href="get-vbrrepositoryextent.md"><code>Get-VBRRepositoryExtent</code></a> cmdlet.</p><p>To get the capacity extent, run the <a href="get-vbrcapacityextent.md"><code>Get-VBRCapacityExtent</code></a> cmdlet.</p><p>To get the archive extent, run the <a href="get-vbrarchiveextent.md"><code>Get-VBRArchiveExtent</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrrepositoryextent.md"><code>VBRRepositoryExtent[]</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RunAsync</span></p>
        </td>
        <td>
          <p>Defines that the command returns immediately without waiting for the task to complete.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</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
[`VBRSession`](vbrsession.md)

## Examples

::: example
### Enabling Maintenance Mode for Performance Extents

This example shows how to enable the Maintenance mode for the performance extents.

```
$scaleoutrepository = Get-VBRBackupRepository -ScaleOut -Name "Amazon S3"
$extent = Get-VBRRepositoryExtent -Repository $scaleoutrepository
Enable-VBRRepositoryExtentMaintenanceMode -Extent $extent[2]
```

Perform the following steps:

1. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value and provide the `ScaleOut` parameter. Save the result to the `$scaleoutrepository` variable.
2. Run the [`Get-VBRRepositoryExtent`](get-vbrrepositoryextent.md) cmdlet. Set the `$scaleoutrepository` variable as the `Repository` parameter value.Save the result to the `$extent` variable.

   The [`Get-VBRRepositoryExtent`](get-vbrrepositoryextent.md) cmdlet will return an array of extents. Mind the ordinal number of the necessary extent (in our example, it is the third extent in the array).

3. Run the `Enable-VBRRepositoryExtentMaintenanceMode` cmdlet. Set the `$extent` variable as the `Extent` parameter value.

:::

## Related Commands

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