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

Start-VBRSharePointItemRestoreSession

Short Description

Starts restore sessions for Microsoft SharePoint.

Applies to: Veeam Backup & Replication

Product Edition: Community, Standard, Enterprise, Enterprise Plus

Syntax

This cmdlet provides the following parameter sets.

  • To start a restore session from the particular restore point of the Microsoft SharePoint database:

Start-VBRSharePointItemRestoreSession [-RestorePoint] <IVBRApplicationRestorePoint> [-StagingServerName <string>] [-StagingInstanceName <string>] [-StagingServerPort <int>] [-GuestCredential <pscredential>] [-SqlCredential <pscredential>] [-UseWindowsAuthentification]  [<CommonParameters>]

  • To start a restore session from the particular Microsoft SharePoint site collection:

Start-VBRSharePointItemRestoreSession [-SiteCollection] <IVBRSiteCollection> [-StagingServerName <string>][-StagingInstanceName <string>] [-StagingServerPort <int>] [-GuestCredential <pscredential>] [-SqlCredential <pscredential>] [-UseWindowsAuthentification]  [<CommonParameters>]

Detailed Description

This cmdlet allows you to start restore sessions and recover Microsoft SharePoint databases. You can run restore sessions with the following scenarios:

  • Restore session of all site collections and Microsoft SharePoint databases from the particular restore point.
  • Restore session of the particular Microsoft SharePoint site collection. In this case, the mount service will mount the database with this site collection to a staging Microsoft SQL Server.

Start-VBRSharePointItemRestoreSession Important!

You can use this cmdlet with the SiteCollection parameter to restore the particular site collection only in case Microsoft SharePoint and Microsoft SQL Server are installed on the same machine.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

RestorePoint

Specifies a restore point. The cmdlet will get a Microsoft SharePoint database from the specified restore point.

True

0

True (ByValue)

 

SiteCollection

Specifies a site that you want to get. The cmdlet will restore items from the specified site.

True

0

True (ByValue)

 

StagingServerName

Specifies a name of the staging Microsoft SQL server. The cmdlet will mount the restore point of a VM with the Microsoft Sharepoint database to the specified server.

False

Named

False

 

StagingInstanceName

Specifies a name of a Microsoft SQL instance. The cmdlet will create the content database within this instance.

False

Named

False

 

StagingServerPort

Specifies a port number.The cmdlet will use this port to connect to the staging Microsoft SQL server.

False

Named

False

 

GuestCredential

Specifies user account credentials to connect to the staging Microsoft SQL server. The user account must have Full control permissions.

False

Named

False

 

SqlCredential

Specifies credentials to authenticate against the Microsoft SQL server.

False

Named

False

 

UseWindowsAuthentification

Indicates that the cmdlet will use Windows authentication.

False

Named

False

 

<CommonParameters>

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

Return Type

VBRSharePointRestoreSession

Example 1

This example shows how to start a restore session for all site collections and Microsoft SharePoint databases from the particular restore point.

  1. Run Get-VBRApplicationRestorePoint to get a restore point. Save the result to the $restorepoint variable.
  2. Run Start-VBRSharePointItemRestoreSession with the $restorepoint variable.

PS C:\PS> $restorepoint = Get-VBRApplicationRestorePoint -Sharepoint

PS C:\PS> Start-VBRSharePointItemRestoreSession -RestorePoint $restorepoint[0]

Example 2

This example shows how to start a restore session from a Microsoft SQL backup that contains the necessary Microsoft SharePoint database

  1. Run Get-VBRApplicationRestorePoint with the SQL parameter to get a restore point of the Microsoft SQL backup. Save the result to the $restorepoint variable.
  2. Run Start-VBRSharePointItemRestoreSession with the $restorepoint variable.

PS C:\PS> $restorepoint = Get-VBRApplicationRestorePoint -SQL

PS C:\PS> Start-VBRSharePointItemRestoreSession -RestorePoint $restorepoint[0]

Example 3

This example shows how to start a restore session for a Microsoft SharePoint site collection.

  1. Run Get-VBRApplicationRestorePoint to get a restore point. Save the result to the $restorepoint variable.
  2. Run Get-VBRSiteCollection to get the site collection. Save the result to the $restorepoint variable.
  3. Run Start-VBRSharePointItemRestoreSession with the $sitecollection variable.

PS C:\PS> $restorepoint = Get-VBRApplicationRestorePoint -SharePoint -Name "Sharepoint server"

PS C:\PS> $sitecollection = Get-VBRSiteCollection -RestorePoint $restorepoint

PS C:\PS> Start-VBRSharePointItemRestoreSession -SiteCollection $sitecollection[0]

Example 4

This example shows how to start a restore session for all site collections and Microsoft SharePoint databases from the particular restore point. The cmdlet will use a staging server and will create the content database within the VEEAMSQL2016 instance.

  1. Run Get-VBRApplicationRestorePoint to get the restore point. Save the result to the $restorepoint variable.
  2. Run Get-Credential to create a credential object that you want to use for authenticating with the staging server and an SQL instance. Save the result to the $creds variable.
  3. Run Start-VBRSharePointItemRestoreSession with the $restorepoint and $creds variables. Use the UseWindowsAuthentification parameter to apply the Windows authentication option.

PS C:\PS> $restorepoint = Get-VBRApplicationRestorePoint -Sharepoint

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

PS C:\PS> Start-VBRSharePointItemRestoreSession -RestorePoint $sapp -StagingServerName "LOCALHOST" -StagingInstanceName "VEEAMSQL2016" -GuestCredential $creds -SqlCredential $creds -UseWindowsAuthentification

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