Switch-VBRCloudTenantsQuotaRepositoryToSOBR
Short Description
Switches tenant quotas on the cloud repository to a scale-out backup repository.
Applies to
Platform: VMware, Hyper-V
Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License
Requires a cloud provider license.
Syntax
Switch-VBRCloudTenantsQuotaRepositoryToSOBR -Resource <VBRCloudTenantResource> -ScaleOutBackupRepository <VBRScaleOutBackupRepository> [-Force] [<CommonParameters>] |
Detailed Description
This cmdlet switches tenant quotas on the cloud repository to a scale-out backup repository. You can use this cmdlet if you want to move tenant backup data to a scale-out backup repository used as a cloud repository.
Consider the following:
- The cmdlet does not copy the actual backup data from an original cloud repository to a new cloud repository. Instead, it creates folders for tenant data on extents of the scale-out backup repository used as a cloud repository, copies backup metadata to these folders and prompts the user to copy backup files to these folders as well.
Note that either all folders or no folders that are being migrated must exist on the scale-out backup repository. If some tenant folders already exist on the scale-out backup repository, while other folders are missing, the migration process will fail.
- Migration of tenant data from and to object storage used as a cloud repository is not supported.
- Migration to a scale-out backup repository is not possible if at least one extent is in the maintenance mode.
- Names of folders with tenant backup data on the cloud repository must not contain special characters (for example, \/`~,!?#$&*|{}[];"<>) and non-ASCII characters.
- During migration, tenant accounts will be automatically disabled. The service provider must enable the disabled accounts manually once the migration process is completed.
- All subtenants are migrated together with the tenant, it is not possible to migrate only specific subtenants.
Parameters
Parameter | Description | Type | Required | Position | Accept |
|---|---|---|---|---|---|
Resource | Specifies the settings for backup resources. | Accepts the VBRCloudTenantResource object. To create this object, run the New-VBRCloudTenantResource cmdlet. | True | Named | True (ByPropertyName, ByValue) |
ScaleOutBackupRepository | Specifies the scale-out backup repository where you want to create cloud repository quota for a tenant account. | Accepts the VBRScaleOutBackupRepository object. To create this object, run the Get-VBRBackupRepository cmdlet and provide the ScaleOut parameter. | True | Named | True (ByValue, |
Force | Defines that the cmdlet will switch tenant quotas on the cloud repository to a scale-out backup repository without showing warnings in the PowerShell console. | SwitchParameter | False | Named | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.
Output Object
None.
Switching Tenant Quota on Cloud Repository to Scale-Out Backup Repository
$repository = Get-VBRBackupRepository -ScaleOut -Name "Veeam Scale-Out Backup Repository" $tenant = Get-VBRCloudTenant -Name "Tenant" $resource = $tenant.Resources Switch-VBRCloudTenantsQuotaRepositoryToSOBR -Resource $resource[2] -ScaleOutBackupRepository $repository |
- Run the Get-VBRBackupRepository cmdlet. Provide the ScaleOut parameter. Specify the Name parameter value. Save the result to the $repository variable.
- Run the Get-VBRCloudTenant cmdlet. Specify the Name parameter value.
- Get the tenant resources. Provide the Resources property of the $tenant object. Save the result to the $resource variable.
You will get an array of tenant resources. Mind the ordinal number of the necessary tenant resource (in our example, it is the third tenant resource in the array).
- Run the Switch-VBRCloudTenantsQuotaRepositoryToSOBR cmdlet. Set the $repository variable as the ScaleOutBackupRepository parameter value. Set the $resource[2] variable as the Resource parameter value.
- The cmdlet will prompt you to perform the following operations:
- Confirm that the specified tenant accounts will be disabled.
- Copy tenant backup files to the folders that the cmdlet has created on the scale-out backup repository, and then confirm that the backup files have been copied.
- Confirm that the cmdlet will update tenant backups and cloud repository settings for the tenant account.
- Confirm that the cmdlet will rescan the new cloud repository.
Related Commands
