---
title: "Get-VBORepositoryMaintenanceSession"
description: "This cmdlet returns maintenance sessions that are started for backup repositories. During maintenance session, Veeam Backup for Microsoft 365 suspends operations on the backup repositories, and you can perform service operations on the storage..."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/get-vborepositorymaintenancesession.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > JET-based Backup Repositories and Object Storage Repositories > Get-VBORepositoryMaintenanceSession"
dateModified: "2026-08-21"
---

# Get-VBORepositoryMaintenanceSession

## Short Description
Returns maintenance sessions started for backup repositories.

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>GetByFilter (Default)</code></p>

```
Get-VBORepositoryMaintenanceSession [-Repository <VBORepository>] [-State <VBOControllerSessionState>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>GetById</code></p>

```
Get-VBORepositoryMaintenanceSession -Id <Guid> [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet returns maintenance sessions that are started for backup repositories.

During maintenance session, Veeam Backup for Microsoft 365 suspends operations on the backup repositories, and you can perform service operations on the storage where these repositories reside.

## 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">Id</span></p>
        </td>
        <td>
          <p>Specifies an ID of the maintenance session. The cmdlet will return details of this session.</p>
        </td>
        <td style="width:10%;">
          <p><code>Guid</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Repository</span></p>
        </td>
        <td>
          <p>Specifies a backup repository. The cmdlet will return maintenance sessions that are started for the specified backup repository.</p><p>Accepts the <a href="vborepository.md"><code>VBORepository</code></a> object.</p><p>To get this object, run the <a href="get-vborepository.md"><code>Get-VBORepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vborepository.md"><code>VBORepository</code></a></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">State</span></p>
        </td>
        <td>
          <p>Specifies a session state. The cmdlet will return maintenance sessions that are in the specified state:</p><ul><li><code>Initialized</code></li><li><code>Preparing</code></li><li><code>Running</code></li><li><code>Finishing</code></li><li><code>Finished</code></li><li><code>Canceling</code></li><li><code>Canceled</code></li><li><code>Failing</code></li><li><code>Failed</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBOControllerSessionState</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 the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Output Object
The cmdlet returns the [`VBORepositoryMaintenanceSession`](vborepositorymaintenancesession.md) object that contains details on a maintenance session when Veeam Backup for Microsoft 365 suspends operations on a backup repository.

## Examples

::: example
### Example 1: Getting Maintenance Sessions Started for Specific Backup Repository

This example shows how to get maintenance sessions started for the *Repository 09* backup repository and that are in the *Finished* state.

```
$repository = Get-VBORepository -Name "Repository 09"
Get-VBORepositoryMaintenanceSession -Repository $repository -State Finished
```

Perform the following steps:

1. Run the [`Get-VBORepository`](get-vborepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
2. Run the `Get-VBORepositoryMaintenanceSession` cmdlet. Set the `$repository` variable as the `Repository` parameter value. Specify the `State` parameter value.

:::

::: example
### Example 2: Getting Maintenance Session by ID

This command returns a maintenance session with the ID `4a1f8c3e-7d92-4b60-9f15-0c2e6b84d371`.

```
Get-VBORepositoryMaintenanceSession -Id 4a1f8c3e-7d92-4b60-9f15-0c2e6b84d371
```

:::

## Related Commands

[`Get-VBORepository`](get-vborepository.md)