New-VBRCloudTenantResource

Short Description

Creates the VBRCloudTenantResource objects that contain backup resources.

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Requires a cloud provider license.

Syntax

New-VBRCloudTenantResource -Repository <CBackupRepository> -RepositoryFriendlyName <String> -Quota <Int64>

[-EnableWanAccelerator] [-WanAccelerator <CWanAccelerator>] [<CommonParameters>]

Detailed Description

This cmdlet creates a new VBRCloudTenantResource object. This object contains the backup resources settings and is used further to apply these settings to a cloud tenant account.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
EnableWanAccelerator	Enables the option to use WAN accelerators for backup jobs to cloud repositories. Use the `WanAccelerator` parameter to set the WAN accelerator.	`SwitchParameter`	False	Named	False
Quota	Specifies the amount of space you want to allocate to the tenant on the selected backup repository. Permitted value: `1` to `2097151` (GB).	`Int64`	True	Named	False
Repository	Specifies the backup repository in your backup infrastructure you want to expose to the tenant. You can specify simple or scale-out backup repositories. You cannot specify cloud repositories or individual scale-out repositories extents. Accepts the `CBackupRepository` object. To get this object, run the `Get-VBRBackupRepository` cmdlet.	`CBackupRepository`	True	Named	False
RepositoryFriendlyName	Specifies a name for the cloud repository you want to present to the tenant. The name you enter will be displayed in the list of backup repositories at the tenant's side.	`String`	True	Named	False
WanAccelerator	Specifies the WAN accelerator for the `EnableWanAccelerator` parameter. Accepts the `CWanAccelerator` object. To get this object, run the `Get-VBRWANAccelerator` cmdlet.	`CWanAccelerator`	False	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

VBRCloudTenantResource

Examples

New-VBRCloudTenantResource Example 1. Creating Object with Tenant Quota

This example shows how to create an object containing backup resources with the following settings:

The cloud repository is named Standard Tier Repository.
The tenant quota is set to 10 GB.

$repo1 = Get-VBRBackupRepository -Name "Backups Vol2"

$standard1 = New-VBRCloudTenantResource -Repository $repo1 -RepositoryFriendlyName "Standard Tier Repository" -Quota 10

Perform the following steps:

Run the Get-VBRBackupRepository cmdlet. Specify the Name parameter value. Save the result to the $repo1 variable.
Run the New-VBRCloudTenantResource cmdlet. Specify the following settings:
- Set the $repo1 variable as the Repository parameter value.
- Specify the RepositoryFriendlyName parameter value.
- Specify the Quota parameter value.
- Save the result to the $standard1 variable to be used with other cmdlets.

New-VBRCloudTenantResource Example 2. Creating Object with Tenant Quota and WAN Acceleration

This example shows how to create an object containing backup resources with the following settings:

The cloud repository is named Golden Tier Repository.
The tenant quota is set to 100 GB.
The WAN acceleration is allowed.

$repo2 = Get-VBRBackupRepository -Name "Backups Vol2"

$wan = Get-VBRWANAccelerator -Name "WAN 1"

$golden2 = New-VBRCloudTenantResource -Repository $repo2 -RepositoryFriendlyName "Golden Tier Repository" -Quota 100 -EnableWanAccelerator -WanAccelerator $wan

Perform the following steps:

Run the Get-VBRBackupRepository cmdlet. Specify the Name parameter value. Save the result to the $repo2 variable.
Run the Get-VBRWANAccelerator cmdlet. Specify the Name parameter value. Save the result to the $wan variable.
Run the New-VBRCloudTenantResource cmdlet. Specify the following settings:
- Set the $repo2 variable as the Repository parameter value.
- Specify the RepositoryFriendlyName parameter value.
- Specify the Quota parameter value.
- Provide the EnableWanAccelerator parameter.
- Set the $wan variable as the WanAccelerator parameter value.
- Save the result to the $golden2 variable to be used with other cmdlets.