Restore-VESPItem

In this article

    Short Description

    Restores SharePoint items.

    Applies to: Veeam Backup & Replication, Veeam Backup for Microsoft Office 365

    Product Edition: Enterprise, Enterprise Plus, Veeam Universal License

    Syntax

    This cmdlet provides parameter sets that allow you to:

    • Restore a SharePoint site.

    Restore-VESPItem [-Site] <VESPSite> [[-SiteURL] <string>] [-RestoreSubsites] [-SiteAlias <string>] [-Credential <pscredential>] [-RestorePermissions] [-SkipPermissionNotificationSending] [-RestoreChangedItems] [-RestoreDeletedItems] [-RestoreListViews]  [<CommonParameters>]

    • Restore a SharePoint site using Multi-factor authentication with an Azure AD application ID.

    Restore-VESPItem [-Site] <VESPSite> [[-SiteURL] <string>] -ApplicationId <guid> [-RestoreSubsites] [-SiteAlias <string>] [-RestorePermissions] [-SkipPermissionNotificationSending] [-RestoreChangedItems] [-RestoreDeletedItems] [-RestoreListViews]  [<CommonParameters>]

    • Restore a SharePoint site using Multi-factor authentication with an Azure AD application.

    Restore-VESPItem [-Site] <VESPSite> [[-SiteURL] <string>] -ApplicationId <guid> -ApplicationCertificatePath <string> -ImpersonationAccountName <string> [-RestoreSubsites] [-SiteAlias <string>] -ApplicationCertificatePassword <securestring> [-RestorePermissions] [-SkipPermissionNotificationSending] [-RestoreChangedItems] [-RestoreDeletedItems] [-RestoreListViews]  [<CommonParameters>]

    • Restore a SharePoint list.

    Restore-VESPItem [-List] <VESPList> [[-SiteURL] <string>] [-TargetList <string>] [-SiteAlias <string>][-Credential <pscredential>] [-RestorePermissions] [-SkipPermissionNotificationSending] [-RestoreChangedItems][-RestoreDeletedItems] [-RestoreListViews]  [<CommonParameters>]

    • Restore a SharePoint list using Multi-factor authentication with an Azure AD application ID.

    Restore-VESPItem [-List] <VESPList> [[-SiteURL] <string>] -ApplicationId <guid> [-TargetList <string>] [-SiteAlias <string>] [-RestorePermissions] [-SkipPermissionNotificationSending] [-RestoreChangedItems] [-RestoreDeletedItems] [-RestoreListViews]  [<CommonParameters>]

    • Restore a SharePoint list using Multi-factor authentication with an Azure AD application.

    Restore-VESPItem [-List] <VESPList> [[-SiteURL] <string>] -ApplicationId <guid> -ApplicationCertificatePath <string> [-TargetList <string>] [-SiteAlias <string>] -ApplicationCertificatePassword <securestring> [-RestorePermissions] [-SkipPermissionNotificationSending] [-RestoreChangedItems] [-RestoreDeletedItems][-RestoreListViews]  [<CommonParameters>]

    • Restore a SharePoint document library.

    Restore-VESPItem [-DocumentLibrary] <VESPDocumentLibrary> [[-SiteURL] <string>] [-TargetList <string>] [-SiteAlias <string>] [-Credential <pscredential>] [-RestorePermissions] [-SkipPermissionNotificationSending] [-RestoreChangedItems] [-RestoreDeletedItems] [-RestoreListViews]  [<CommonParameters>]

    • [Veeam Backup for Microsoft Office 365 only] Restore a SharePoint document library using Multi-factor authentication with an Azure AD application ID.

    Restore-VESPItem [-DocumentLibrary] <VESPDocumentLibrary> [[-SiteURL] <string>] -ApplicationId <guid> [-TargetList <string>] [-SiteAlias <string>] [-RestorePermissions] [-SkipPermissionNotificationSending] [-RestoreChangedItems] [-RestoreDeletedItems] [-RestoreListViews]  [<CommonParameters>]

    • [Veeam Backup for Microsoft Office 365 only] Restore a SharePoint document library using Multi-factor authentication with an Azure AD application.

    Restore-VESPItem [-DocumentLibrary] <VESPDocumentLibrary> [[-SiteURL] <string>] -ApplicationId <guid> -ApplicationCertificatePath <string> [-TargetList <string>] [-SiteAlias <string>] -ApplicationCertificatePassword <securestring> [-RestorePermissions] [-SkipPermissionNotificationSending] [-RestoreChangedItems] [-RestoreDeletedItems] [-RestoreListViews]  [<CommonParameters>]

    • Restore a SharePoint item.

    Restore-VESPItem [-Item] <VESPItem[]> [[-SiteURL] <string>] [-TargetList <string>] [-SiteAlias <string>] [-Credential <pscredential>] [-RestorePermissions] [-SkipPermissionNotificationSending] [-RestoreChangedItems] [-RestoreDeletedItems]  [<CommonParameters>]

    • [Veeam Backup for Microsoft Office 365 only] Restore a SharePoint item using Multi-factor authentication with an Azure AD application ID.

    Restore-VESPItem [-Item] <VESPItem[]> [[-SiteURL] <string>] -ApplicationId <guid> [-TargetList <string>] [-SiteAlias <string>] [-RestorePermissions] [-SkipPermissionNotificationSending] [-RestoreChangedItems] [-RestoreDeletedItems]  [<CommonParameters>]

    • [Veeam Backup for Microsoft Office 365 only] Restore a SharePoint item using Multi-factor authentication with an Azure AD application.

    Restore-VESPItem [-Item] <VESPItem[]> [[-SiteURL] <string>] -ApplicationId <guid> -ApplicationCertificatePath <string> [-TargetList <string>] [-SiteAlias <string>] -ApplicationCertificatePassword <securestring> [-RestorePermissions] [-SkipPermissionNotificationSending] [-RestoreChangedItems] [-RestoreDeletedItems] [<CommonParameters>]

    • Restore a SharePoint document.

    Restore-VESPItem [-Document] <VESPDocument[]> [[-SiteURL] <string>] [-TargetList <string>] [-SiteAlias <string>] [-Credential <pscredential>] [-RestorePermissions] [-SkipPermissionNotificationSending] [-RestoreChangedItems] [-RestoreDeletedItems]  [<CommonParameters>]

    • [Veeam Backup for Microsoft Office 365 only] Restore a SharePoint document using Multi-factor authentication with an Azure AD application ID.

    Restore-VESPItem [-Document] <VESPDocument[]> [[-SiteURL] <string>] -ApplicationId <guid> [-TargetList <string>] [-SiteAlias <string>] [-RestorePermissions] [-SkipPermissionNotificationSending] [-RestoreChangedItems] [-RestoreDeletedItems]  [<CommonParameters>]

    • [Veeam Backup for Microsoft Office 365 only] Restore a SharePoint document using Multi-factor authentication with an Azure AD application.

    Restore-VESPItem [-Document] <VESPDocument[]> [[-SiteURL] <string>] -ApplicationId <guid> -ApplicationCertificatePath <string> [-TargetList <string>] [-SiteAlias <string>] -ApplicationCertificatePassword <securestring> [-RestorePermissions] [-SkipPermissionNotificationSending] [-RestoreChangedItems][-RestoreDeletedItems]  [<CommonParameters>]

    Detailed Description

    This cmdlet allows you to restore SharePoint sites and the following objects that are related to this site:

    • SharePoint sites
    • SharePoint lists
    • SharePoint document libraries
    • SharePoint items
    • SharePoint documents

    You can restore SharePoint sites with one of the following authentication methods:

    • Authentication methods that utilize legacy protocols.
    • Multi-factor authentication. To restore data the cmdlet utilizes an Azure AD application.

    Restore-VESPItem Note:

    To perform restore operations, you must first start a restore session. For more information on how to start a restore session, see Start-VBOSharePointItemRestoreSession or Start-VBRSharePointItemRestoreSession.

    Parameters

    Parameter

    Description

    Type

    Required

    Position

    Accept Pipeline Input

    Site

    Specifies a name of the SharePoint site. This cmdlet will restore SharePoint items from the specified SharePoint site.

    Accepts the VESPSite object. To get this object, run the Get-VESPSite cmdlet.

    True

    0

    True (ByValue)

    List

    Specifies a name of the SharePoint list. This cmdlet will restore SharePoint items from the specified list.

    Accepts the VESPList object. To get this object, run the Get-VESPList cmdlet.

    True

    0

    True (ByValue)

    DocumentLibrary

    Specifies a name of the SharePoint document library. This cmdlet will restore SharePoints item from a specified document library.

    Accepts the VESPDocumentLibrary object. To get this object, run the Get-VESPDocumentLibrary cmdlet.

    True

    0

    True (ByValue)

    Item

    Specifies an array of names for SharePoint items. This cmdlet will restore SharePoint items with the specified names.

    Accepts the VESPItem[] object. To get this object, run the Get-VESPItem cmdlet.

    True

    Named

    True (ByValue)

    Document

    Specifies an array of names for SharePoint documents. This cmdlet will restore SharePoint items from documents with the specified names.

    Accepts the VESPDocument[] object. To get this object, run the Get-VESPDocument cmdlet.

    True

    0

    True (ByValue)

    ApplicationId

    To restore data using Multi-factor authentication.

    Specifies an ID of an Azure AD application. The cmdlet will use this application ID to set up a secure connection to a Microsoft organization.

    Note: This parameter is available for restore from backups created by Veeam Backup for Microsoft Office 365 version 4c and later.

    Guid

    True

    Named

    False

    ApplicationCertificatePath

    To restore data using Multi-factor authentication.

    Specifies a path to the folder where the certificate is located. The cmdlet will import the certificate that is located in this path to set up an encrypted connection to a Microsoft organization.

    Note: This parameter is available for restore from backups created by Veeam Backup for Microsoft Office 365 version 4c and later.

    String

    True

    Named

    False

    ApplicationCertificatePassword

    To restore data using Multi-factor authentication.

    Specifies the certificate password. The cmdlet will use this password to confirm the certificate that you want to import to an Azure AD application. This parameter is obligatory.

    Note: This parameter is available for restore from backups created by Veeam Backup for Microsoft Office 365 version 4c and later.

    String

    True

    Named

    False

    ImpersonationAccountName

    To restore data using Multi-factor authentication.

    Specifies a user name of the account that will be used as a SharePoint site owner account to restore a SharePoint site. Use this parameter together with the ApplicationCertificatePassword parameter.

    Note: This parameter is available for restore from backups created by Veeam Backup for Microsoft Office 365 version 4c and later.

    String

    True

    Named

    False

    SiteURL

    Specifies the SharePoint site URL. This cmdlet will restore SharePoint item to a SharePoint site with the specified URL. If you do not provide this parameter, the cmdlet will restore a SharePoint site to the original site.

    Note: This parameter does not work for restore from backups created by Veeam Backup for Microsoft Office 365.

    String

    True

    1

    False

    RestoreSubsites

    Indicates that the cmdlet will restore child sites.

    SwitchParameter

    False

    Named

    False

    SiteAlias

    Specifies the SharePoint alias site URL. This cmdlet will restore SharePoint item with the specified alias site URL.

    Note: This parameter does not work for restore from backups created by Veeam Backup & Replication.

    String

    False

    Named

    False

    TargetList

    Specifies a name of the SharePoint list. The cmdlet will restore items to this list.

    Note: If you do not provide this parameter, the cmdlet will restore the SharePoint list to the original location.

    String

    False

    Named

    False

    Credential

    Specifies account credentials that you want to use to connect to the SharePoint server.

    If omitted, the cmdlet will use a currently logged in user Windows account credentials for connecting to the SharePoint server.

    PSCredential

    False

    Named

    False

    RestorePermissions

    Defines that the cmdlet will restore permissions.

    SwitchParameter

    False

    Named

    False

    SkipPermissionNotificationSending

    Defines that the cmdlet will not send permission notification.

    SwitchParameter

    False

    Named

    False

    RestoreChangedItems

    Defines that the cmdlet will restore changed items.

    SwitchParameter

    False

    Named

    False

    RestoreDeletedItems

    Defines that the cmdlet will restore deleted items.

    SwitchParameter

    False

    Named

    False

    RestoreListViews

    Defines that the cmdlet will restore the SharePoint list views.

    SwitchParameter

    False

    Named

    False

    <CommonParameters>

    This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About Common Parameters section of Microsoft Docs.

    Examples

    Restore-VESPItemExample 1. Restoring SharePoint Site to Original Site [For Veeam Backup & Replication]

    This example shows how to restore the Teams SharePoint site with the following settings:

    • The cmdlet will restore site permissions.
    • The cmdlet will restore changed items.
    • The cmdlet will restore deleted items.
    • The cmdlet will restore the SharePoint list views.

    $credentials = Get-Credential

    $session = Get-VBRSharePointItemRestoreSession

    $database = Get-VESPDatabase -Session $session -Name "WSS_Content.mdf"

    $site = Get-VESPSite -Database $database -Name "Teams"

    Restore-VESPItem -Site $site -RestoreSubsites -Credential $credentials -RestorePermissions -RestoreChangedItems -RestoreDeletedItems -RestoreListViews

    Perform the following steps:

    1. Get the SharePoint site:
    1. Run the Get-Credential cmdlet to create a credential object. Type credentials that you want to use for connecting to the SharePoint server. Save the result to the $credentials variable.
    2. Run the Get-VBRSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    3. Run the Get-VESPDatabase cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $database variable.
    4. Run the Get-VESPSite cmdlet. Set the $database variable as the Database parameter value. Specify the Name parameter value. Save the result to the $site variable.
    1. Run the Restore-VESPItem cmdlet. Specify the following settings:
    • Set the $site variable as the Site parameter value.
    • Provide the RestoreSubsites parameter.
    • Specify the SiteURL parameter value.
    • Set the $credentials variable as the Credential parameter value.
    • Provide the RestorePermissions parameter.
    • Provide the RestoreChangedItems parameter.
    • Provide the RestoreDeletedItems parameter.
    • Provide the RestoreListViews parameter.

    Restore-VESPItemExample 2. Restoring SharePoint Site to New Site [For Veeam Backup & Replication]

    This example shows how to restore the Teams SharePoint site to the http://servername/sitename site with the following settings:

    • The cmdlet will restore site permissions.
    • The cmdlet will restore changed items.
    • The cmdlet will restore deleted items.
    • The cmdlet will restore the SharePoint list views.

    $credentials = Get-Credential

    $session = Get-VBRSharePointItemRestoreSession

    $database = Get-VESPDatabase -Session $session -Name "WSS_Content.mdf"

    $site = Get-VESPSite -Database $database -Name "Teams"

    Restore-VESPItem -Site $site -RestoreSubsites -SiteURL "http://servername/sitename" -Credential $credentials -RestorePermissions -RestoreChangedItems -RestoreDeletedItems -RestoreListViews

    Perform the following steps:

    1. Get the SharePoint site:
    1. Run the Get-Credential cmdlet to create a credential object. Type credentials that you want to use for connecting to the SharePoint server. Save the result to the $credentials variable.
    2. Run the Get-VBRSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    3. Run the Get-VESPDatabase cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $database variable.
    4. Run the Get-VESPSite cmdlet. Set the $database variable as the Database parameter value. Specify the Name parameter value. Save the result to the $site variable.
    1. Run the Restore-VESPItem cmdlet. Specify the following settings:
    • Set the $site variable as the Site parameter value.
    • Provide the RestoreSubsites parameter.
    • Specify the SiteURL parameter value.
    • Set the $credentials variable as the Credential parameter value.
    • Provide the RestorePermissions parameter.
    • Provide the RestoreChangedItems parameter.
    • Provide the RestoreDeletedItems parameter.
    • Provide the RestoreListViews parameter.

    Restore-VESPItemExample 3. Restoring SharePoint List [For Veeam Backup & Replication]

    This example shows how to restore the Color names SharePoint list to the http://servername/sitename site with the following settings:

    • The cmdlet will restore changed items.
    • The cmdlet will restore deleted items.
    • The cmdlet will restore the SharePoint list views.

    $credentials = Get-Credential

    $session = Get-VBRSharePointItemRestoreSession

    $database = Get-VESPDatabase -Session $session -Name "WSS_Content.mdf"

    $list = Get-VESPList -Database $database -Name "Color names"

    Restore-VESPItem -List $list -SiteURL "http://servername/sitename" -Credential $credentials -RestorePermissions -RestoreChangedItems -RestoreDeletedItems -RestoreListViews

    Perform the following steps:

    1. Get the SharePoint list:
    1. Run the Get-Credential cmdlet to create a credential object. Type credentials that you want to use for connecting to the SharePoint server. Save the result to the $credentials variable.
    2. Run the Get-VBRSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    3. Run the Get-VESPDatabase cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $database variable.
    1. Run the Get-VESPList cmdlet. Set the $database variable as the Database parameter value. Specify the Name parameter value. Save the result to the $list variable.
    1. Run the Restore-VESPItem cmdlet. Specify the following settings:
    • Set the $list variable as the List parameter value.
    • Specify the SiteURL parameter value.
    • Set the $credentials variable as the Credential parameter value.
    • Provide the RestorePermissions parameter.
    • Provide the RestoreChangedItems parameter.
    • Provide the RestoreDeletedItems parameter.
    • Provide the RestoreListViews parameter.

    Restore-VESPItemExample 4. Restoring SharePoint Document Library [For Veeam Backup & Replication]

    This example shows how to restore the RegulationsSharePoint document library to the http://servername/sitename site with the following settings:

    • The cmdlet will restore site permissions.
    • The cmdlet will restore changed items.

    $credentials = Get-Credential

    $session = Get-VBRSharePointItemRestoreSession

    $database = Get-VESPDatabase -Session $session -Name "WSS_Content.mdf"

    $documentLibrary = Get-VESPDocumentLibrary -Database $database -Name "Regulations"

    Restore-VESPItem -DocumentLibrary $documentLibrary -SiteURL "http://servername/sitename" -Credential $credentials -RestorePermissions -RestoreChangedItems

    Perform the following steps:

    1. Run the Get-Credential cmdlet to create a credential object. Type credentials that you want to use for connecting to the SharePoint server. Save the result to the $credentials variable.
    2. Get the SharePoint document library:
    1. Run the Get-VBRSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. Run the Get-VESPDatabase cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $database variable.
    3. Run the Get-VESPDocumentLibrary cmdlet. Set the $database variable as the Database parameter value. Specify the Name parameter value. Save the result to the $documentLibrary variable.
    1. Run the Restore-VESPItem cmdlet. Specify the following settings:
    • Set the $documentLibrary variable as the DocumentLibrary parameter value.
    • Specify the SiteURL parameter value.
    • Set the $credentials variable as the Credential parameter value.
    • Provide the RestorePermissions parameter.
    • Provide the RestoreChangedItems parameter.

    Restore-VESPItemExample 5. Restoring SharePoint Document [For Veeam Backup & Replication]

    This example shows how to restore the reports.txt document from the Teams site to the http://servername/sitename site with the following settings:

    • The cmdlet will restore site permissions.
    • The cmdlet will restore changed items.
    • The cmdlet will restore deleted items.
    • The cmdlet will restore the SharePoint list views.

    $session = Get-VBRSharePointItemRestoreSession

    $database = Get-VESPDatabase -Session $session -Name "WSS_Content.mdf"

    $site = Get-VESPSite -Database $database -Name "Teams"

    $document = Get-VESPDocument -Site $site -Query "reports.txt"

    Restore-VESPItem -Document $document -SiteURL "http://servername/sitename" -Credential $credentials -RestorePermissions -RestoreChangedItems -RestoreDeletedItems -RestoreListViews

    Perform the following steps:

    1. Get the SharePoint document.
    1. Run the Get-VBRSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. Run the Get-VESPDatabase cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $database variable.
    3. Run the Get-VESPSite cmdlet. Set the $database variable as the Database parameter value. Specify the Name parameter value. Save the result to the $site variable.
    4. Run the Get-VESPDocument cmdlet. Set the $site variable as the Site parameter value. Specify the Query parameter value.
    1. Run the Restore-VESPItem cmdlet. Specify the following settings:
    • Set the $documentLibrary variable as the DocumentLibrary parameter value.
    • Specify the SiteURL parameter value.
    • Set the $credentials variable as the Credential parameter value.
    • Provide the RestorePermissions parameter.
    • Provide the RestoreChangedItems parameter.

    Restore-VESPItemExample 6. Restoring SharePoint Site to Original Site [For Veeam Backup for Microsoft Office 365]

    This example shows how to restore the Teams SharePoint site with the following settings:

    • The cmdlet will restore site permissions.
    • The cmdlet will restore changed items.
    • The cmdlet will restore deleted items.
    • The cmdlet will restore the SharePoint list views.

    $credentials = Get-Credential

    $session = Get-VBOSharePointItemRestoreSession

    $organization = Get-VESPOrganization -Session $session -Name "ABC"

    $site = Get-VESPSite -Organization $organization -Name "Teams"

    Restore-VESPItem -Site $site -RestoreSubsites -Credential $credentials -RestorePermissions -RestoreChangedItems -RestoreDeletedItems -RestoreListViews

    Perform the following steps:

    1. Run the Get-Credential cmdlet to create a credential object. Type credentials that you want to use for connecting to the SharePoint server. Save the result to the $credentials variable.
    2. Get the SharePoint site.
    1. Run the Get-VBOSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. Run the Get-VESPOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $organization variable.
    3. Run the Get-VESPSite cmdlet. Set the $organization variable as the Organization parameter value. Specify the Name parameter value. Save the result to the $site variable.
    1. Run the Restore-VESPItem cmdlet. Specify the following settings:
    • Set the $site variable as the Site parameter value.
    • Provide the RestoreSubsites parameter.
    • Set the $credentials variable as the Credential parameter value.
    • Provide the RestorePermissions parameter.
    • Provide the RestoreChangedItems parameter.
    • Provide the RestoreDeletedItems parameter.
    • Provide the RestoreListViews parameter.

    Restore-VESPItemExample 7. Restoring SharePoint Site with Multi-Factor Authentication Using Azure AD Application ID [For Veeam Backup for Microsoft Office 365]

    This example shows how to restore the Teams SharePoint site with the following settings:

    • The cmdlet will apply the 6049d4a6-b814-4b67-aa4c-14580af94dce Azure AD application ID to connect to a Microsoft Organization.
    • The cmdlet will restore site permissions.
    • The cmdlet will restore changed items.
    • The cmdlet will restore deleted items.
    • The cmdlet will restore the SharePoint list views.

    $credentials = Get-Credential

    $session = Get-VBOSharePointItemRestoreSession

    $organization = Get-VESPOrganization -Session $session -Name "ABC"

    $site = Get-VESPSite -Organization $organization -Name "Teams"

    Restore-VESPItem -Site $site -RestoreSubsites -ApplicationId "6049d4a6-b814-4b67-aa4c-14580af94dce" -RestorePermissions -RestoreChangedItems -RestoreDeletedItems -RestoreListViews

    Perform the following steps:

    1. Get the SharePoint site.
    1. Run the Get-VBOSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. Run the Get-VESPOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $organization variable.
    3. Run the Get-VESPSite cmdlet. Set the $organization variable as the Organization parameter value. Specify the Name parameter value. Save the result to the $site variable.
    1. Run the Restore-VESPItem cmdlet. Specify the following settings:
    • Set the $site variable as the Site parameter value.
    • Provide the RestoreSubsites parameter.
    • Set the $credentials variable as the Credential parameter value.
    • Specify the ApplicationId parameter value.
    • Provide the RestorePermissions parameter.
    • Provide the RestoreChangedItems parameter.
    • Provide the RestoreDeletedItems parameter.
    • Provide the RestoreListViews parameter.

    Restore-VESPItemExample 8. Restoring SharePoint Site with Multi-Factor Authentication Using Azure AD Application [For Veeam Backup for Microsoft Office 365]

    This example shows how to restore the Teams SharePoint site with the following settings:

    • The cmdlet will apply the 6049d4a6-b814-4b67-aa4c-14580af94dce Azure AD application ID to connect to a Microsoft Organization.
    • The cmdlet will use the certificate located at the C:\Certificate\ path.
    • The cmdlet will restore site permissions.
    • The cmdlet will restore changed items.
    • The cmdlet will restore deleted items.
    • The cmdlet will restore the SharePoint list views.

    $credentials = Get-Credential

    $session = Get-VBOSharePointItemRestoreSession

    $organization = Get-VESPOrganization -Session $session -Name "ABC"

    $site = Get-VESPSite -Organization $organization -Name "Teams"

    Restore-VESPItem -Site $site -RestoreSubsites -ApplicationId "6049d4a6-b814-4b67-aa4c-14580af94dce" -ApplicationCertificatePath "C:\Certificate\" -ApplicationCertificatePassword $securepassword -ImpersonationAccountName global2@tech-365.tech -RestorePermissions -RestoreChangedItems -RestoreDeletedItems -RestoreListViews

    Perform the following steps:

    1. Get the SharePoint site.
    1. Run the Get-VBOSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. Run the Get-VESPOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $organization variable.
    3. Run the Get-VESPSite cmdlet. Set the $organization variable as the Organization parameter value. Specify the Name parameter value. Save the result to the $site variable.
    1. Run the Read-Host cmdlet to specify the password. Specify the text that will show up in the password prompt window in the Prompt parameter. Provide the AsSecureString parameter to convert the password to the secure string.
    2. Enter the password.
    3. Run the Restore-VESPItem cmdlet. Specify the following settings:
    • Set the $site variable as the Site parameter value.
    • Provide the RestoreSubsites parameter.
    • Set the $credentials variable as the Credential parameter value.
    • Specify the ApplicationId parameter value.
    • Specify the ApplicationCertificatePath parameter value.
    • Specify the ApplicationCertificatePassword parameter value.
    • Specify the ImpersonationAccountName parameter value.
    • Provide the RestorePermissions parameter.
    • Provide the RestoreChangedItems parameter.
    • Provide the RestoreDeletedItems parameter.
    • Provide the RestoreListViews parameter.

    Restore-VESPItemExample 9. Restoring SharePoint Site to Another Site [For Veeam Backup for Microsoft Office 365]

    This example shows how to restore the Teams SharePoint site to the AliasTeamSite alias site with the following settings:

    • The cmdlet will restore site permissions.
    • The cmdlet will restore changed items.
    • The cmdlet will restore deleted items.
    • The cmdlet will restore the SharePoint list views.

    $credentials = Get-Credential

    $session = Get-VBOSharePointItemRestoreSession

    $organization = Get-VESPOrganization -Session $session -Name "ABC"

    $site = Get-VESPSite -Organization $organization -Name "Teams"

    Restore-VESPItem -Site $site -RestoreSubsites -SiteAlias "Alias" -Credential $credentials -RestorePermissions -RestoreChangedItems -RestoreDeletedItems -RestoreListViews

    Perform the following steps:

    1. Run the Get-Credential cmdlet to create a credential object. Type credentials that you want to use for connecting to the SharePoint server. Save the result to the $credentials variable.
    2. Get the SharePoint site.
    1. Run the Get-VBOSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. Run the Get-VESPOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $organization variable.
    3. Run the Get-VESPSite cmdlet. Set the $organization variable as the Organization parameter value. Specify the Name parameter value. Save the result to the $site variable.
    1. Run the Restore-VESPItem cmdlet. Specify the following settings:
    • Set the $site variable as the Site parameter value.
    • Provide the RestoreSubsites parameter.
    • Specify the SiteURL parameter value.
    • Set the $credentials variable as the Credential parameter value.
    • Provide the RestorePermissions parameter.
    • Provide the RestoreChangedItems parameter.
    • Provide the RestoreDeletedItems parameter.
    • Provide the RestoreListViews parameter.

    Restore-VESPItemExample 10. Restoring SharePoint List [For Veeam Backup for Microsoft Office 365]

    This example shows how to restore the Color names SharePoint list to the ABC organization production list with the following settings:

    • The cmdlet will restore site permissions.
    • The cmdlet will restore changed items.
    • The cmdlet will restore deleted items.
    • The cmdlet will restore the SharePoint list views.

    $credentials = Get-Credential

    $session = Get-VBOSharePointItemRestoreSession

    $organization = Get-VESPOrganization -Session $session -Name "ABC"

    $list = Get-VESPList -Organization $organization -Name "Color names"

    Restore-VESPItem -List $list -Credential $credentials -RestorePermissions -RestoreChangedItems -RestoreDeletedItems -RestoreListViews

    Perform the following steps:

    1. Run the Get-Credential cmdlet to create a credential object. Type credentials that you want to use for connecting to the SharePoint server. Save the result to the $credentials variable.
    2. Get the SharePoint list.
    1. Run the Get-VBOSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. Run the Get-VESPOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $organization variable.
    3. Run the Get-VESPList cmdlet. Set the $organization variable as the Organization parameter value. Specify the Name parameter value. Save the result to the $list variable.
    1. Run the Restore-VESPItem cmdlet. Specify the following settings:
    • Set the $list variable as the List parameter value.
    • Set the $credentials variable as the Credential parameter value.
    • Provide the RestorePermissions parameter.
    • Provide the RestoreChangedItems parameter.
    • Provide the RestoreDeletedItems parameter.
    • Provide the RestoreListViews parameter.

    Restore-VESPItemExample 11. Restoring SharePoint Document Library [For Veeam Backup for Microsoft Office 365]

    This example shows how to restore the Test Document Library SharePoint document library with the following settings:

    • The cmdlet will restore site permissions.
    • The cmdlet will restore changed items.
    • The cmdlet will restore deleted items.
    • The cmdlet will restore the SharePoint list views.

    $credentials = Get-Credential

    $session = Get-VBOSharePointItemRestoreSession

    $organization = Get-VESPOrganization -Session $session -Name "ABC"

    $documentLibrary = Get-VESPDocumentLibrary -Organization $organization -Name "Documents"

    Restore-VESPItem -DocumentLibrary $documentLibrary -Credential $credentials -RestorePermissions -RestoreChangedItems -RestoreDeletedItems -RestoreListViews

    Perform the following steps:

    1. Run the Get-Credential cmdlet to create a credential object. Type credentials that you want to use for connecting to the SharePoint server. Save the result to the $credentials variable.
    2. Get the SharePoint document library.
    1. Run the Get-VBOSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. Run the Get-VESPOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $organization variable.
    3. Run the Get-VESPDocumentLibrary cmdlet. Set the $organization variable as the Organization parameter value. Specify the Name parameter value. Save the result to the $documentLibrary variable.
    1. Run the Restore-VESPItem cmdlet. Specify the following settings:
    • Set the $documentLibrary variable as the DocumentLibrary parameter value.
    • Set the $credentials variable as the Credential parameter value.
    • Provide the RestorePermissions parameter.
    • Provide the RestoreChangedItems parameter.
    • Provide the RestoreDeletedItems parameter.
    • Provide the RestoreListViews parameter.

    Restore-VESPItemExample 12. Restoring SharePoint Item [For Veeam Backup for Microsoft Office 365]

    This example shows how to restore a SharePoint item added to the ABC organization with the following settings:

    • The cmdlet will restore site permissions.
    • The cmdlet will restore changed items.
    • The cmdlet will restore deleted items.
    • The cmdlet will restore the SharePoint list views.

    $credentials = Get-Credential

    $session = Get-VBOSharePointItemRestoreSession

    $organization = Get-VESPOrganization -Session $session -Name "ABC"

    $item = Get-VESPItem -Organization $organization -Query

    Restore-VESPItem -Item $item -Credential $credentials -RestorePermissions -RestoreChangedItems -RestoreDeletedItems

    Perform the following steps:

    1. Run the Get-Credential cmdlet to create a credential object. Type credentials that you want to use for connecting to the SharePoint server. Save the result to the $credentials variable.
    2. Get the SharePoint item:
    1. Run the Get-VBOSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. Run the Get-VESPOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $organization variable.
    3. Run the Get-VESPItem cmdlet. Set the $organization variable as the Organization parameter value. Specify the Name parameter value. Save the result to the $item variable.
    1. Run the Restore-VESPItem cmdlet. Specify the following settings:
    • Set the $item variable as the Item parameter value.
    • Set the $credentials variable as the Credential parameter value.
    • Provide the RestorePermissions parameter.
    • Provide the RestoreChangedItems parameter.
    • Provide the RestoreDeletedItems parameter.
    • Provide the RestoreListViews parameter.

    Restore-VESPItemExample 13. Restoring SharePoint Item [For Veeam Backup for Microsoft Office 365]

    This example shows how to restore a SharePoint document with the following settings:

    • The cmdlet will restore site permissions.
    • The cmdlet will restore changed items.
    • The cmdlet will restore deleted items.

    $credentials = Get-Credential

    $session = Get-VBOSharePointItemRestoreSession

    $organization = Get-VESPOrganization -Session $session -Name "ABC"

    $document = Get-VESPDocument -Organization $organization -Query "reports.txt"

    Restore-VESPItem -Document $document -Credential $credentials -RestorePermissions -RestoreChangedItems -RestoreDeletedItems

    Perform the following steps:

    1. Run the Get-Credential cmdlet to create a credential object. Type credentials that you want to use for connecting to the SharePoint server. Save the result to the $credentials variable.
    2. Get the SharePoint document:
    1. Run the Get-VBOSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. Run the Get-VESPOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $organization variable.
    3. Run the Get-VESPDocument cmdlet. Set the $organization variable as the Organization parameter value. Specify the Query parameter value. Save the result to the $document variable.
    1. Run the Restore-VESPItem cmdlet. Specify the following settings:
    • Set the $document variable as the Document parameter value.
    • Set the $credentials variable as the Credential parameter value.
    • Provide the RestorePermissions parameter.
    • Provide the RestoreChangedItems parameter.
    • Provide the RestoreDeletedItems parameter.

    Related Commands