Start-VBOTeamsItemRestoreSession

Short Description

Starts restore sessions to explore backed-up Microsoft Teams objects and to perform operations with them.

Applies to: Veeam Backup for Microsoft Office 365

Product Edition: Community, Standard, Enterprise, Enterprise Plus

Syntax

This cmdlet provides parameter sets that allow you to:

  • Explore or restore Microsoft Teams objects from the latest restore point.

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

  • Explore or restore Microsoft Teams objects from the specified restore point.

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

  • Explore or restore Microsoft Teams objects remotely.

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

Detailed Description

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

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

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Accept Wildcard Characters

RestorePoint

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.

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

True

Named

True (ByValue)

False

Organization

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.

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

False

Named

True (ByValue)

False

Job

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.

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

False

Named

True (ByValue)

False

Server

Specifies a DNS name or IP address of the Veeam Backup for Microsoft Office 365 server that backed up items that you want to restore.

String

True

Named

False

False

Credential

Specifies credentials that will be used to authenticate against the Veeam Backup for Microsoft Office 365 server.

PSCredential

True

Named

False

False

Port

Specifies a port number that will be used to connect to the Veeam Backup for Microsoft Office 365 server.

Int32

False

Named

False

False

ShowDeleted

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.

Note: If you provide this parameter, the amount of data returned by cmdlets within the current session may significantly increase.

SwitchParameter

False

Named

False

False

ShowAllVersions

Defines that all versions of Microsoft Teams items will be included in the current session. If you provide this parameter, you will be able to perform operations with these items.

Note: If you provide this parameter, the amount of data returned by cmdlets within the current session may significantly increase.

SwitchParameter

False

Named

False

False

LatestState

Specifies that the cmdlet will retrieve items from the latest restore point in the backup.

SwitchParameter

True

Named

False

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

Start-VBOTeamsItemRestoreSessionExample 1. Starting Restore Session from Latest Restore Point

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

  • The cmdlet will retrieve data from a backup at the state of the latest restore point.
  • The cmdlet will start a restore session only for backups associated with the ABC organization.

 

$org = Get-VBOOrganization -Name "ABC"

Start-VBOTeamsItemRestoreSession -LatestState -Organization $org

Perform the following steps:

  1. Run the Get-VBOOrganization cmdlet. Specify the Name parameter value. Save the result to the $org variable.
  2. Run the Start-VBOTeamsItemRestoreSession cmdlet. Provide the LatestState parameter. Set the $org variable as the Organization parameter value.

Start-VBOTeamsItemRestoreSessionExample 2. Starting Restore Session from Specific Restore Point

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

  • The cmdlet will retrieve data from a backup at the state of the selected restore point.
  • The cmdlet will start a restore session only for backups that were created by the Sales Backup backup job.

$restorepoint = Get-VBORestorePoint

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

Start-VBOTeamsItemRestoreSession -RestorePoint $restorepoint[2] -Job $job

Perform the following steps:

  1. Run the Get-VBORestorePoint cmdlet. Save the result to the $restorepoint variable.

The Get-VBORestorePoint cmdlet will return an array of active restore sessions. Mind the ordinal number of the necessary restore session (in our example, it is the third restore session in the array).

  1. Run the Get-VBOJob cmdlet. Specify the Name parameter value. Save the result to the $job variable.
  1. Run the Start-VBOTeamsItemRestoreSession cmdlet. Set the $restorepoint[2] variable as the RestorePoint parameter value. Set the $job variable as the Job parameter value.

Start-VBOTeamsItemRestoreSessionExample 3. 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 backup at the state of the latest restore point.
  • Perform an item restore from a Microsoft Teams team.
  • Stop a restore session.

 

$vbosrvcreds = Get-Credential

Start-VBOTeamsItemRestoreSession -LatestState -Server vbo365server.support.local -Credential $vbosrvcreds

$session = Get-VBOTeamsItemRestoreSession

$org = Get-VETOrganization -Session $session -Name "ABC"

$team = Get-VETTeam -Organization $org -DisplayName "IT"

$file = Get-VETFile -Team $team -Query "filename: report"

$orgcreds = Get-Credential

Restore-VETItem -Credential $orgcreds -File $file -RestoreChangedItem -RestoreMissingItem

Stop-VBOTeamsItemRestoreSession -Session $session

Perform the following steps:

  1. Start the remote restore session at the state of the latest restore point:
  1. Run the Get-Credential cmdlet to create a credential object. Enter credentials that will be used to connect to the Veeam Backup for Microsoft Office 365 server. Save the result to the $vbosrvcreds variable.
  2. Run the Start-VBOTeamsItemRestoreSession cmdlet. Specify the LatestState parameter value. Specify the Server parameter value. Set the $vbosrvcreds variable as the Credential parameter value.
  1. Perform item restore:
  1. Get files that you want to restore:
  1. Run the Get-VBOTeamsItemRestoreSession cmdlet. Save the result to the $session variable.
  2. Run the Get-VETOrganization cmdlet. Set the $session variable as the Session parameter value. Save the result to the $org variable.
  3. Run the Get-VETTeam cmdlet. Set the $org variable as the Organization parameter value. Specify the Name parameter value. Save the result to the $team variable.
  4. Run the Get-VETFile cmdlet. Set the $team variable as the Team parameter value. Specify the Query parameter value. Save the result to the $file variable.
  1. Run the Get-Credential cmdlet to create a credential object. Enter credentials that will be used to connect to the Microsoft Teams organization. Save the result to the $orgcreds variable.
  2. Run the Restore-VETitem cmdlet. Set the $orgcreds variable as the Credential parameter value. Set the $file variable as the File parameter value. Specify the RestoreChangedItem and RestoreMissingItem parameter values.
  1. Run the Stop-VBOTeamsItemRestoreSession cmdlet. Set the $session variable as the Session parameter value.

Related Commands

I want to report a typo

There is a misspelling right here:

 

I want to let the Veeam Documentation Team know about that.