This is an archive version of the document. To get the most up-to-date information, see the current version.

New-VBRCloudTenantResource

In this article

    Short Description

    Creates VBRCloudTenantResource objects that contain backup resources.

    Applies to

    Platform: VMware, Hyper-V

    Product Edition: Standard, Enterprise, Enterprise Plus

    Requires a cloud provider license.

    Syntax

    New-VBRCloudTenantResource -Repository <CBackupRepository> -RepositoryFriendlyName <String> -Quota <Int32> [-EnableWanAccelerator] [-WanAccelerator <CWanAccelerator>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<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

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    Repository

    Specifies the backup repository in your backup infrastructure you want to expose to the tenant.

    Accepts CBackupRepository object.

    You can specify simple or scale-out backup repositories.

    You cannot specify cloud repositories or individual scale-out repositories extents.

    True

    Named

    False

    False

    Repository
    Friendly
    Name

    Specifies a friendly 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.

    Accepts string type.

    True

    Named

    False

    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).

    True

    Named

    False

    False

    Enable
    Wan
    Accelerator

    Indicates that the backup jobs can use WAN accelerators for transferring data to cloud repositories.

    Use the WanAccelerator parameter to set the WAN accelerator.

    False

    Named

    False

    False

    Wan
    Accelerator

    Specifies the WAN accelerator for the EnableWanAccelerator parameter.

    Accepts CWanAccelerator object.

    False

    Named

    False

    False

    <CommonParameters>

    This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

    Related Commands

    Get-VBRBackupRepository

    Get-VBRWANAccelerator

    Return Type

    VBRCloudTenantResource

    Example 1

    This command creates an object containing a 10 GB repository quota. The created object is assigned to the '$standard1' variable.

    • The backup repository from which the cloud resources will be allocated is obtained with Get-VBRBackupRepository and assigned to the '$repo1' variable.
    • The cloud repository is named 'Standard Tier Repository'.
    • The tenant quota is set to 10 GB.

    PS C:\PS> $standard1 = New-VBRCloudTenantResource -Repository $repo1 -RepositoryFriendlyName "Standard Tier Repository" -Quota 10

    Example 2

    This command creates an object containing a 100 GB repository quota. The WAN acceleration is allowed. The created object is assigned to the '$golden2' variable.

    • The backup repository from which the cloud resources will be allocated is obtained with Get-VBRBackupRepository and assigned to the '$repo2' variable.
    • The cloud repository is named 'Golden Tier Repository'.
    • The tenant quota is set to 100 GB.
    • The EnableWanAcceleration parameter is used to enable using WAN acceleration for data transfer. The WAN accelerator that will be used is obtained with Get-VBRWANAccelerator and assigned to the '$wan' variable beforehand.

    PS C:\PS> $golden2 = New-VBRCloudTenantResource -Repository $repo2 -RepositoryFriendlyName "Golden Tier Repository" -Quota 100 -EnableWanAccelerator -WanAccelerator $wan