Help Center
Choose product document...
Veeam Backup & Replication 9.5
PowerShell Reference

Set-VBRCloudSubUserResource

Short Description

Modifies quotas of cloud subuser resources settings.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

This cmdlet provides 3 parameter sets.

  • To modify the repository friendly name:

Set-VBRCloudSubUserResource -CloudSubUserResource <VBRCloudSubUserResource> [-RepositoryFriendlyName <string>] [<CommonParameters>]

  • To modify the disk space limits:

Set-VBRCloudSubUserResource -CloudSubUserResource <VBRCloudSubUserResource> [-RepositoryFriendlyName <string>] [-Quota <int>]  [<CommonParameters>]

  • To change the disk space quota to unlimited:

Set-VBRCloudSubUserResource -CloudSubUserResource <VBRCloudSubUserResource> [-RepositoryFriendlyName <string>] [-Unlimited]  [<CommonParameters>]

Detailed Description

This cmdlet modifies the VBRCloudSubUserResource object. This object contains the quota of the cloud user backup resources. To modify settings, you need to enter the corresponding parameters with new values. The parameters that you omit will remain unchanged.

Run Set-VBRCloudSubUser to apply the changes.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

CloudSubUserResource

Specifies the quota of the subuser backup resources you want to modify.

Accepts VBRCloudSubUserResource type.

True

Named

True (by Value
FromPipeline, ValueFromPipeline
ByPropertyName)

False

RepositoryFriendlyName

Specifies the name you want to give to the subuser quota.

This name will be displayed in the list of backup repositories at the subuser side.

False

Named

False

False

Quota

Specifies the amount of space you want to give to the subuser on the selected backup repository.

Permitted value: 1 to 2097151  (GB).

False

Named

False

False

Unlimited

Indicates that the quota of resources has unlimited disk space.

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.

Return Type

VBRCloudSubUserResource

Example 1

This example shows how to modify the repository friendly name for a cloud subuser.

  1. Run Get-VBRCloudSubUser to get the cloud subuser. Save the result to the $subuser variable.
  2. Get the existing subuser quota using the Resources property of the VBRCloudSubUserResource object saved to the $subuser variable. Save the result to the $subuserresources variable.
  3. Run Set-VBRCloudSubUserResource. Use the $subuserresources variable.

PS C:\PS> $subuser = Get-VBRCloudSubUser -Name "Alpha"

PS C:\PS> $subuserresources = $subuser.Resources[0]

PS C:\PS> Set-VBRCloudSubUserResource -CloudSubUserResource $subuserresources -RepositoryFriendlyName "Alpha Cloud Repository"

Example 2

This example shows how to modify the quota for a cloud subuser.

  1. Run Get-VBRCloudSubUser to get the subuser. Save the result to the $subuser variable.
  2. Get the existing subuser quota using the Resources property of the VBRCloudSubUserResource object saved to the $subuser variable. Save the result to the $subuserresources variable.
  3. Run Set-VBRCloudSubUserResource. Use the $subuserresources variable.

PS C:\PS> $subuser = Get-VBRCloudSubUser -Name "Alpha"

PS C:\PS> $subuserresources = $subuser.Resources[0]

PS C:\PS> Set-VBRCloudSubUserResource -CloudSubUserResource $subuserresources -Quota 30

Example 3

This example shows how to set unlimited disk space to a cloud subuser.

  1. Run Get-VBRCloudSubUser to get the subuser. Save the result to the $subuser variable.
  2. Get the existing subuser quota using the Resources property of the VBRCloudSubUserResource object saved to the $subuser variable. Save the result to the $subuserresources variable.
  3. Run Set-VBRCloudSubUserResource. Use the $subuserresources variable.

PS C:\PS> $subuser = Get-VBRCloudSubUser -Name "Alpha"

PS C:\PS> $subuserresources = $subuser.Resources[0]

PS C:\PS> Set-VBRCloudSubUserResource -CloudSubUserResource $subuserresources -Unlimited

Related Commands

Get-VBRCloudSubUser

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Backup Explorers User Guide

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide

Veeam Backup for Microsoft Office 365

Veeam ONE Documentation

Veeam Agent for Windows Documentation

Veeam Agent for Linux Documentation

Veeam Management Pack Documentation