Get-VBORestorePoint

In this article

    Short Description

    Returns restore points.

    Syntax

    This cmdlet provides the following parameter sets:

    • Get all restore points created by all backup jobs.

    Get-VBORestorePoint  [<CommonParameters>]

    • Get restore points created by a specific backup job.

    Get-VBORestorePoint [-Job <VBOJob>]  [<CommonParameters>]

    • Get restore points for a specific Veeam Backup for Microsoft Office 365 organization.

    Get-VBORestorePoint [-Organization <VBOOrganization>]  [<CommonParameters>]

    Detailed Description

    This cmdlet returns restore points stored in Veeam Backup for Microsoft Office 365. Once you get restore points, you can start restore sessions to explore backed-up Microsoft Exchange objects, SharePoint items, OneDrive items, and Microsoft Teams objects using the following cmdlets:

    Parameters

    Parameter

    Description

    Required

    Position

    Accept Pipeline Input

    Accept Wildcard Characters

    Job

    Specifies the backup job. The cmdlet will return restore points created by this backup job.

    False

    Named

    True (ByValue)

    False

    Organization

    Specifies organization. The cmdlet will return restore points for this organization.

    False

    Named

    True (ByValue)

    True

    <CommonParameters>

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

    Examples

    Example 1

    This command returns restore points created by all backup jobs.

    Get-VBORestorePoint

    Example 2

    This example shows how to get restore points created by a specific backup job.

    1. Run the Get-VBOJob cmdlet with the Name parameter to get the backup job for which you want to get restore points. Save the result to the $job variable.
    2. Run the Get-VBORestorePoint cmdlet. Set the $job variable as the Job parameter value.

    $job = Get-VBOJob -Name "Backup: Sales Mailbox"

    Get-VBORestorePoint -Job $job

    Example 3

    This example shows how to get restore points created by backup jobs of a specific organization.

    1. Run the Get-VBOOrganization cmdlet with the Name parameter to get the organization with the name "ABC". Save the result to the $org variable.
    2. Run the Get-VBORestorePoint cmdlet. Set the $org variable as the Organization parameter value.

    $org = Get-VBOOrganization -Name "ABC"

    Get-VBORestorePoint -Organization $org

    Example 4

    This example shows how to start a restore session to explore backed-up Microsoft Exchange objects for the first restore point of a specific backup job.

    1. Run the Get-VBOJob cmdlet with the Name parameter to get the backup job for which you want to start a restore session. Save the result to the $job variable.
    2. Run the Get-VBORestorePoint cmdlet to get an array of restore points automatically sorted descending by BackupTime. Set the $job variable as the Job parameter value. Save the result to the $restorepoint variable.
    3. Run the Start-VBOExchangeItemRestoreSession cmdlet. Set the $restorepoint variable as the RestorePoint parameter value.

    $job = Get-VBOJob -Name "Backup: Sales Mailbox"

    $restorepoint = (Get-VBORestorePoint -Job $job | Sort -Property BackupTime)

    Start-VBOExchangeItemRestoreSession -RestorePoint $restorepoint[0]

    Related Commands