---
title: "Start-VBOExchangeItemRestoreSession"
description: "Starts restore sessions to explore backed-up Microsoft Exchange items and to perform operations with these items. Product: Veeam Backup for Microsoft 365 Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License This "
canonical: "https://helpcenter.veeam.com/docs/vbo365/explorers_powershell/start-vboexchangeitemrestoresession.html"
breadcrumb: "Veeam Explorers PowerShell Reference > Veeam Explorers PowerShell Reference > Veeam Explorer for Microsoft Exchange > Start-VBOExchangeItemRestoreSession"
dateModified: "2026-08-20"
---

# Start-VBOExchangeItemRestoreSession

## Short Description
Starts restore sessions to explore backed-up Microsoft Exchange items and to perform operations with these items.

**Product**: Veeam Backup for Microsoft 365

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

## Syntax

This cmdlet provides the following parameter sets:

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

```
Start-VBOExchangeItemRestoreSession [-LatestState] [-Job <IVBOJob>] [-Organization <IVBOOrganization>]
 [-ShowDeleted] [-ShowAllVersions] [-Reason <String>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestorePoint</code></p>

```
Start-VBOExchangeItemRestoreSession -RestorePoint <IVBORestorePoint> [-Job <IVBOJob>]
 [-Organization <IVBOOrganization>] [-ShowDeleted] [-ShowAllVersions] [-Reason <String>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Remote</code></p>

```
Start-VBOExchangeItemRestoreSession -Server <String> -Credential <PSCredential> [-Port <Int32>]
 [-SkipCertificateCheck] [-ShowDeleted] [-ShowAllVersions] [-Reason <String>] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet establishes a connection to the Veeam Backup for Microsoft 365 server and retrieves Exchange items backed up on this server. Within the restore session, you can get backed-up Exchange objects using the following cmdlets:

- [`Get-VEXDatabase`](get-vexdatabase.md)
- [`Get-VEXMailbox`](get-vexmailbox.md)
- [`Get-VEXFolder`](get-vexfolder.md)
- [`Get-VEXItem`](get-vexitem.md)

After you get backed-up Exchange objects, you can perform the following operations with these objects:

- [`Export-VEXItem`](export-vexitem.md)
- [`Restore-VEXItem`](restore-vexitem.md)
- [`Send-VEXItem`](send-vexitem.md)

## 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">Credential</span></p>
        </td>
        <td>
          <p>Specifies credentials that will be used for authenticating to the Veeam Backup for Microsoft 365 server.</p><p>Accepts the <code>PSCredential</code> object. To get this object, run the [`Get-Credential`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential) cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>PSCredential</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">Job</span></p>
        </td>
        <td>
          <p>Specifies a backup job to start a new restore session. You will be able to use the session to perform operations with items backed up by this job.</p><p>Accepts the <code>IVBOJob</code> object. To get this object, run the <a href="https://helpcenter.veeam.com/docs/vbo365/powershell/get-vbojob.html?ver=8"><code>Get-VBOJob</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>IVBOJob</code></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">LatestState</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will retrieve data from a mailbox database at the state of the latest restore point.</p><p>Default: <em>False</em></p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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">Organization</span></p>
        </td>
        <td>
          <p>Specifies an organization to start a new restore session. You will be able to use the session to perform operations with items backed up for this organization.</p><p>Accepts the <code>IVBOOrganization</code> object. To get this object, run the <a href="https://helpcenter.veeam.com/docs/vbo365/powershell/get-vboorganization.html?ver=8"><code>Get-VBOOrganization</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>IVBOOrganization</code></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">Port</span></p>
        </td>
        <td>
          <p>Specifies a port number that will be used to connect to the Veeam Backup for Microsoft 365 server.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Reason</span></p>
        </td>
        <td>
          <p>Specifies a reason to perform restore operation.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RestorePoint</span></p>
        </td>
        <td>
          <p>Specifies a restore point to start a new restore session. You will be able to use the session to perform operations with items that this restore point contains.</p><p>Accepts the <code>IVBORestorePoint</code> object. To get this object, run the <a href="https://helpcenter.veeam.com/docs/vbo365/powershell/get-vborestorepoint.html?ver=8"><code>Get-VBORestorePoint</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>IVBORestorePoint</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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">Server</span></p>
        </td>
        <td>
          <p>Specifies DNS name or IP address of the Veeam Backup for Microsoft 365 server that backed up items that you want to restore.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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">ShowAllVersions</span></p>
        </td>
        <td>
          <p>Defines that all versions of backed-up items will be included in the current session. If you provide this parameter, you will be able to perform operations with these items.</p><p><strong>Note</strong>: If you provide this parameter, the amount of data returned by cmdlets within the current session may significantly increase.</p><p>Default: <em>False</em></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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ShowDeleted</span></p>
        </td>
        <td>
          <p>Defines that deleted items will be included in the current session. If you provide this parameter, you will be able to perform operations with these items.</p><p><strong>Note</strong>: If you provide this parameter, the amount of data returned by cmdlets within the current session may significantly increase.</p><p>Default: <em>False</em></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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SkipCertificateCheck</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will not perform a TLS certificate check.</p><p>Default: <em>False</em></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 the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Output Object
The cmdlet returns the [`VBOExchangeRestoreSession`](vboexchangerestoresession.md) object that contains settings of the restore session started to perform operations with backed-up Microsoft Exchange items.

## Examples

::: example
### Example 1. Starting Restore Session from Latest Restore Point

This example shows how to start a restore session to perform operations with Microsoft Exchange objects. The restore session will start with the following settings:

- The cmdlet will retrieve data from a mailbox database from the state of the latest restore point.
- The cmdlet will start a restore session only for backups associated with the *ABC* organization.

```
$organization = Get-VBOOrganization -Name "ABC"
Start-VBOExchangeItemRestoreSession -LatestState -Organization $organization
```

Perform the following steps:

1. Run the [`Get-VBOOrganization`](https://helpcenter.veeam.com/docs/vbo365/powershell/get-vboorganization.html?ver=8) cmdlet. Specify the `Name` parameter value. Save the result to the `$organization` variable.
2. Run the `Start-VBOExchangeItemRestoreSession` cmdlet. Provide the `LatestState` parameter. Set the `$organization` variable as the `Organization` parameter value.

:::

::: example
### Example 2. Starting Restore Session from Specific Restore Point

This example shows how to start a restore session to perform operations with Microsoft Exchange objects. The restore session will start with the following settings:

- The cmdlet will retrieve a mailbox database at the state of the selected restore point.
- The cmdlet will start a restore session only for backups that were created by the `Sales Reports` backup job.

```
$restorepoint = Get-VBORestorePoint
$job = Get-VBOJob -Name "Sales Reports"
Start-VBOExchangeItemRestoreSession -RestorePoint $restorepoint[2] -Job $job
```

Perform the following steps:

1. Run the [`Get-VBORestorePoint`](https://helpcenter.veeam.com/docs/vbo365/powershell/get-vborestorepoint.html?ver=8) cmdlet. Save the result to the `$restorepoint` variable.

   The cmdlet will return an array of active restore sessions. Note the ordinal number of the necessary restore session. In this example, it is the third restore session in the array.

2. Run the [`Get-VBOJob`](https://helpcenter.veeam.com/docs/vbo365/powershell/get-vbojob.html?ver=8) cmdlet. Specify the `Name` parameter value. Save the result to the `$job` variable.
3. Run the `Start-VBOExchangeItemRestoreSession` cmdlet. Set the `$restorepoint` variable as the `RestorePoint` parameter value and select the necessary restore point. In this example, it is the third restore point in the array. Set the `$job` variable as the `Job` parameter value.

:::

::: example
### Example 3. Starting Restore Session from Latest Restore Point Remotely

This example shows how to start a remote restore session to perform operations with Microsoft Exchange objects. The cmdlet will connect to the `vbo365server.support.local` server to retrieve a mailbox database at the state of the latest restore point.

```
$credentials = Get-Credential
Start-VBOExchangeItemRestoreSession -Server vbo365server.support.local -Credential $credentials
```

Perform the following steps:

1. Run the [`Get-Credential`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential) cmdlet to create a credential object. Enter credentials that will be used to connect to the Veeam Backup for Microsoft 365 server. Save the result to the `$credentials` variable.
2. Run the `Start-VBOExchangeItemRestoreSession` cmdlet. Specify the `Server` parameter value. Set the `$credentials` variable as the `Credential` parameter value.

:::

::: example
### Example 4. Performing Restore Scenario

This example shows how to perform a restore scenario. The restore scenario includes the following steps:

- Start a remote restore session for a mailbox database at the state of the latest restore point.
- Perform an item restore from an organization mailbox.
- Stop the restore session.

```
$vbosrvcreds = Get-Credential
$session = Start-VBOExchangeItemRestoreSession -Server vbo365server.support.local -Credential $vbosrvcreds
$database = Get-VEXDatabase -Session $session
$mailbox = Get-VEXMailbox -Database $database[0] -Name "sales"
$exsrvcreds = Get-Credential
Restore-VEXItem -Mailbox $mailbox -Server outlook.office365.com -Credential $exsrvcreds -RestoreChangedItem
Stop-VBOExchangeItemRestoreSession -Session $session
```

Perform the following steps:

1. Start the remote restore session for the mailbox database at the state of the latest restore point:

   1. Run the [`Get-Credential`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential) cmdlet to create a credential object. Enter credentials that will be used to connect to the Veeam Backup for Microsoft 365 server. Save the result to the `$vbosrvcreds` variable.
   2. Run the `Start-VBOExchangeItemRestoreSession` cmdlet. Specify the `Server` parameter value. Set the `$vbosrvcreds` variable as the `Credential` parameter value. Save the results to the `$session` variable.

2. Perform an item restore:

   1. Get a mailbox item that you want to restore:

      1. Run the [`Get-VEXDatabase`](get-vexdatabase.md) cmdlet. Set the `$session` variable as the `Session` parameter value. Save the result to the `$database` variable.
      2. Run the [`Get-VEXMailbox`](get-vexmailbox.md) cmdlet. Set the `$database` variable as the `Database` parameter value and select the necessary database. In this example, it is the first database in the array. Specify the `Name` parameter value. Save the result to the `$mailbox` variable.

   2. Run the [`Get-Credential`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential) cmdlet. Save the result to the `$exsrvcreds` variable.
   3. Run the [`Restore-VEXitem`](restore-vexitem.md) cmdlet. Set the `$mailbox` variable as the `Mailbox` parameter value. Specify the `Server` parameter value. Set the `$exsrvcreds` variable as the `Credential` parameter value. Provide the `RestoreChangedItem` parameter.

3. Run the [`Stop-VBOExchangeItemRestoreSession`](stop-vboexchangeitemrestoresession.md) cmdlet. Set the `$session` variable as the `Session` parameter value.

:::

## Related Commands

- [`Get-VBOOrganization`](https://helpcenter.veeam.com/docs/vbo365/powershell/get-vboorganization.html?ver=8)
- [`Get-VBORestorePoint`](https://helpcenter.veeam.com/docs/vbo365/powershell/get-vborestorepoint.html?ver=8)
- [`Get-VBOJob`](https://helpcenter.veeam.com/docs/vbo365/powershell/get-vbojob.html?ver=8)
- [``Get-Credential``](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential)
- [`Get-VBOExchangeItemRestoreSession`](get-vboexchangeitemrestoresession.md)
- [`Get-VEXDatabase`](get-vexdatabase.md)
- [`Get-VEXMailbox`](get-vexmailbox.md)
- [`Restore-VEXitem`](restore-vexitem.md)
- [`Stop-VBOExchangeItemRestoreSession`](stop-vboexchangeitemrestoresession.md)