Move-VBOEntityData

Short Description

Moves organization data from one repository to another.

Syntax

This cmdlet provides parameter sets that allow you to:

Move of organization user data.

Move-VBOEntityData -From <VBORepository> -To <VBORepository> -User <VBOUserData> [-Mailbox] [-ArchiveMailbox][-OneDrive] [-Sites] [-RunAsync] [-WhatIf] [-Confirm] [<CommonParameters>]

Move of organization group data.

Move-VBOEntityData -From <VBORepository> -To <VBORepository> -Group <VBOGroupData> [-Mailbox] [-ArchiveMailbox] [-OneDrive] [-Sites] [-GroupMailbox] [-GroupSite] [-RunAsync] [-WhatIf] [-Confirm] [<CommonParameters>]

Move of organization site data.

Move-VBOEntityData -From <VBORepository> -To <VBORepository> -Site <VBOSiteData> [-RunAsync] [-WhatIf] [-Confirm] [<CommonParameters>]

Move of organization team data.

Move-VBOEntityData -From <VBORepository> -To <VBORepository> -Team <VBOTeamData> [-RunAsync] [-WhatIf] [-Confirm] [<CommonParameters>]

Detailed Description

This cmdlet moves the organization data between repositories and supports the following scenarios:

Data move from one local repository to another local repository.
Data move from a local repository to a backup repository extended with object storage. The data will be moved to object storage.

Move-VBOEntityData Important

Consider the following:

Data move from object storage to another object storage (including object storage specified as target for backup copy jobs) or a local repository is not supported.
Object storage where you want to move backed-up data must not contain any data associated with the items that you want to move.
If the move process was interrupted, make sure to resume your data move before starting backup jobs to back up data to the source or target repository.
As data is being moved, Veeam Backup for Microsoft 365 removes items from the source repository and replaces them with the whitespace in the source repository database.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
From	Specifies a source repository. The cmdlet will move data from this repository.	Accepts the VBORepository object. To get this object, run the Get-VBORepository cmdlet.	True	Named	False	False
To	Specifies a target repository for backed-up data. The cmdlet will move data to this repository. You can specify one of the following types of repositories: Local backup repository Backup repository extended with object storage	Accepts the VBORepository object. To get this object, run the Get-VBORepository cmdlet.	True	Named	False	False
User	Specifies the organization user data that the cmdlet will move.	VBOUserData	True	Named	True (ByValue)	False
Mailbox	Defines that this cmdlet will move the entity mailbox data.	SwitchParameter	False	Named	False	False
ArchiveMailbox	Defines that this cmdlet will move the entity archive mailbox data.	SwitchParameter	False	Named	False	False
OneDrive	Defines that this cmdlet will move the entity OneDrive data.	SwitchParameter	False	Named	False	False
Sites	Defines that this cmdlet will move the entity sites data.	SwitchParameter	False	Named	False	False
RunAsync	Defines that the command returns immediately without waiting for the task to complete.	SwitchParameter	False	Named	False	False
WhatIf	Defines that the cmdlet will write a message that describes the effects of running the cmdlet without actually performing any action.	SwitchParameter	False	Named	False	False
Confirm	Defines that the cmdlet will display a prompt that asks if the user is sure that he wants to continue. Default: True	SwitchParameter	False	Named	False	False
Group	Specifies the organization group data that the cmdlet will move.	VBOGroupData	True	Named	True (ByValue)	False
GroupMailbox	Defines that this cmdlet will move the organization group mailbox data.	SwitchParameter	False	Named	False	False
GroupSite	Defines that this cmdlet will move the organization group site data.	SwitchParameter	False	Named	False	False
Site	Specifies the organization site data that the cmdlet will move.	VBOSiteData	True	Named	True (ByValue)	False
Team	Specifies the organization team data that the cmdlet will move.	VBOTeamData	True	Named	True (ByValue)	False

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

Examples

Move-VBOEntityData Example 1. Moving User Data

This example shows how to move data of a user with the name Chuck Brown from one repository to another.

$repository = Get-VBORepository -Name "ABC Daily Backup"

$destination = Get-VBORepository -Name "Support North"

$user = Get-VBOEntityData -Type User -Repository $repository -Name "Chuck Brown"

Move-VBOEntityData -From $repository -To $destination -User $user -Mailbox -ArchiveMailbox -OneDrive -Sites

Perform the following steps:

Run the Get-VBORepository cmdlet with the Name parameter to get the source repository. Save the result to the $repository variable.
Run the Get-VBORepository cmdlet with the Name parameter to get the destination repository. Save result to the $destination variable.
Run the Get-VBOEntityData cmdlet with the Name parameter and the $repository variable. Save result to the $user variable.
Run the Move-VBOEntityData cmdlet with the $repository, $destination and $user variables and Mailbox, ArchiveMailbox, OneDrive and Sites parameters to move the data to the specified repository.

Move-VBOEntityData Example 2. Moving Group Data

This example shows how to move data of an organization group with the name Support from one repository to another.

$repository = Get-VBORepository -Name "ABC Daily Backup"

$destination = Get-VBORepository -Name "Support North"

$group = Get-VBOEntityData -Type Group -Repository $repository -Name "Support"

Move-VBOEntityData -From $repository -To $destination -Group $group -Mailbox -ArchiveMailbox -OneDrive -Sites -GroupMailbox -GroupSite

Perform the following steps:

Run the Get-VBORepository cmdlet with the Name parameter to get the source repository. Save the result to the $repository variable.
Run the Get-VBORepository cmdlet with the Name parameter to get the destination repository. Save result to the $destination variable.
Run the Get-VBOEntityData cmdlet with the Name parameter and the $repository variable. Save result to the $group variable.
Run the Move-VBOEntityData cmdlet with the $repository, $destination and $group variables and Mailbox, ArchiveMailbox, OneDrive, Sites, GroupMailbox and GroupSite parameters to move the data to the specified repository.

Move-VBOEntityData Example 3. Moving Site Data

This example shows how to move data of an organization site with the name Support from one repository to another.

$repository = Get-VBORepository -Name "ABC Daily Backup"

$destination = Get-VBORepository -Name "Support North"

$site = Get-VBOEntityData -Type Site -Repository $repository -Name "Support"

Move-VBOEntityData -From $repository -To $destination -Site $site

Perform the following steps:

Run the Get-VBORepository cmdlet with the Name parameter to get the source repository. Save the result to the $repository variable.
Run the Get-VBORepository cmdlet with the Name parameter to get the destination repository. Save result to the $destination variable.
Run the Get-VBOEntityData cmdlet with the Name parameter and the $repository variable. Save result to the $site variable.
Run the Move-VBOEntityData cmdlet with the $repository, $destination and $site variables to move the data to the specified repository.

Move-VBOEntityData Example 4. Moving User Data to Object Storage

This example shows how to move the Chuck Brown user data from a local repository to object storage.

$source = Get-VBORepository -Name "ABC Daily Backup"

$target = Get-VBORepository -Name "Extended Backup Repository"

$user = Get-VBOEntityData -Type User -Repository $source -Name "Chuck Brown"

Move-VBOEntityData -From $source -To $target -User $user -Mailbox -ArchiveMailbox -RunAsync

Perform the following steps:

Run the Get-VBORepository cmdlet with the Name parameter to get the source repository. Save the result to the $source variable.
Run the Get-VBORepository cmdlet with the Name parameter to get the destination repository. Save result to the $target variable.
Run the Get-VBOEntityData cmdlet with the Type and Name parameters and the $source variable. Save result to the $user variable.
Run the Move-VBOEntityData cmdlet with the $source, $target and $user variables to move the data to the specified repository.

Related Commands