Help Center
Choose product document...
Veeam Backup & Replication 9.5 Update 4
Veeam Explorers PowerShell Reference

Start-VBOExchangeItemRestoreSession

Short Description

Starts restore sessions for exploring backed up items and performing mailbox restore operations.

Applies to

Product Edition: Community, Standard, Enterprise, Enterprise Plus

Syntax

This cmdlet provides the following parameter sets.

  • To explore or restore mailbox backups from the latest restore point:

Start-VBOExchangeItemRestoreSession -LatestState [-Job <IVBOJob>] [-Organization <IVBOOrganization>] [-ShowDeleted] [-ShowAllVersions]  [<CommonParameters>]

  • To explore or restore mailbox backups from the specified restore point:

Start-VBOExchangeItemRestoreSession -RestorePoint <IVBORestorePoint> [-Job <IVBOJob>] [-Organization <IVBOOrganization>] [-ShowDeleted] [-ShowAllVersions]  [<CommonParameters>]

  • To explore or restore mailbox backups from the latest restore point remotely:

Start-VBOExchangeItemRestoreSession -Server <string> -Credential <pscredential> [-Port <int>] [-SkipCertificateCheck] [-ShowDeleted] [-ShowAllVersions]  [<CommonParameters>]

Detailed Description

This cmdlet establishes a connection to the Veeam Backup for Microsoft Office 365 server and retrieves organization mailbox data from backups. You can specify a restore point to view organization mailbox data at the state of this restore point.

During a restore session you can explore backed up mailbox items using the following cmdlets:

To perform restore operations, use the following cmdlets:

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Latest
State

Indicates that the cmdlet will retrieve data from a mailbox database at the state of the latest restore point.

True

Named

False

False

Job

Specifies a backup job. The cmdlet will start a restore session for backups created by the specified job.

False

Named

True (ByValue)

False

Organization

Specifies an Exchange organization. The cmdlet will start a restore session for backups associated with the specified organization.

False

Named

True (ByValue)

False

Show
Deleted

Indicates that the cmdlet will add backups of mailbox items that were deleted to the restore session.

False

Named

False

False

Show
AllVersions

Indicates that the cmdlet will add all versions of backed up mailbox items to a restore session.

False

Named

False

False

Restore
Point

Specifies a restore point. The cmdlet will retrieve data from a mailbox database at the state of the specified restore point.

True

Named

True (ByValue)

False

Server

Specifies the Veeam Backup for Microsoft Office 365 server to which you want to connect.

True

Named

False

False

Credential

Specifies credentials that you want to use for authenticating with the Veeam Backup for Microsoft Office 365 server.

True

Named

False

False

Port

Specifies a port number. The cmdlet will use this port to connect to the Veeam Backup for Microsoft Office 365 server.

False

Named

False

False

SkipCertificate
Check

Indicates that the cmdlet will not perform the SSL certificate check.

False

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example 1

This example shows how to start a restore session with the following settings:

  • The cmdlet will use the mailbox database at the state of the latest restore point.
  • The cmdlet will start a restore session only for backups associated with the ABC organization.

You must perform the following steps:

  1. Run Get-VBOOrganization to get an Exchange organization whose backups you want to explore or restore during the restore session. Save the result to the $organization variable.
  2. Run Start-VBOExchangeItemRestoreSession with the $organization variable. Use LatestState parameter to bring the mailbox database to the state of the latest restore point.

PS C:\PS> $organization = Get-VBOOrganization -Name "ABC"

PS C:\PS> Start-VBOExchangeItemRestoreSession -LatestState -Organization $organization

Example 2

This example shows how to start a restore session with the following settings:

  • The cmdlet will use 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.

You must perform the following steps:

  1. Run Get-VBORestorePoint and select a restore point by its creation time. Save the result to the $restorepoint variable.
  2. Run Get-VBOJob to get a backup job associated with backups that you want to explore or restore during the restore session.
  3. Run Start-VBOExchangeItemRestoreSession with the $restorepoint and $job variables.

PS C:\PS> $restorepoint = Get-VBORestorePoint | Select-Object -Property BackupTime | select -First 2

PS C:\PS> $job = Get-VBOJob -Name "Sales Reports"

PS C:\PS> Start-VBOExchangeItemRestoreSession -RestorePoint $restorepoint -Job $job

Example 3

This example shows how to start a remote restore session for a mailbox database at the state of the latest restore point.

  1. Run Get-Credential to create a credential object. Type Windows credentials to connect to the Veeam Backup for Microsoft Office 365 server. Save the result to the $creds variable
  2. Run Start-VBOExchangeItemRestoreSession with the $creds variable.

PS C:\PS> $creds = Get-Credential

PS C:\PS> Start-VBOExchangeItemRestoreSession -Server vbo365server.support.local -Credential $creds

Example 4

This example shows how to perform a restore scenario:

  • 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 a restore session

You must perform the following steps:

  1. Start the remote restore session for the mailbox database at the state of the latest restore point:
  1. Run Get-Credential to create a credential object with Windows credentials to connect to the Veeam Backup for Microsoft Office 365 server. Save the result to the $vbosrvcreds variable
  2. Run Start-VBOExchangeItemRestoreSession with the $vbosrvcreds variable.
  1. Perform an item restore:
  1. Get a mailbox that contains an item that you want to restore and save it to the $mailbox variable:
  1. Run Get-VBOExchangeItemRestoreSession to get the restore session. Save the result to the $session variable.
  2. Run Get-VEXDatabase with the $session variable to get the mailbox database. Save the result to the $database variable.
  3. Run Get-VEXMailbox with the $database variable and the Name parameter to get the specific mailbox from the mailbox database. Save the result to the $mailbox variable.
  1. Run Get-Credential to create a credential object with account credentials to connect to the Microsoft Exchange server. Save the result to the $exsrvcreds variable.
  2. Run Restore-VEXitem with the $mailbox and $exsrvcreds variables to restore the mailbox to the Microsoft Exchange server.
  1. Stop the restore session:
  1. Run Stop-VBOExchangeItemRestoreSession. Use the $session variable that you obtained in the Step 1.

PS C:\PS> $vbosrvcreds = Get-Credential

PS C:\PS> Start-VBOExchangeItemRestoreSession -Server vbo365server.support.local -Credential $vbosrvcreds

PS C:\PS> $session = Get-VBOExchangeItemRestoreSession

PS C:\PS> $database = Get-VEXDatabase -Session $session

PS C:\PS> $mailbox = Get-VEXMailbox -Database $database -Name "sales"

PS C:\PS> $exsrvcreds = Get-Credential

PS C:\PS> Restore-VEXItem -Mailbox $mailbox -Server outlook.office365.com -Credential $exsrvcreds -RestoreChangedItem

PS C:\PS> Stop-VBOExchangeItemRestoreSession -Session $session

Related Commands

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Agent Management Guide

Veeam Explorers User Guide

Backup and Restore of SQL Server Databases

Veeam Plug-ins for Enterprise Applications

PowerShell Reference

Veeam Explorers PowerShell Reference

RESTful API Reference

Required Permissions

Veeam Availability for Nutanix AHV

Veeam Backup for Microsoft Office 365 Documentation

Veeam ONE Documentation

Veeam Agent for Windows Documentation

Veeam Agent for Linux Documentation

Veeam Management Pack Documentation