Set-VBRCloudSubUser

Short Description

Modifies settings of cloud subuser accounts.

Applies to

Platform: VMware, Hyper-V

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

Syntax

Set-VBRCloudSubUser -SubUser <IVBRCloudSubUser> [-Description <string>] [-Password <string>] [-Disabled] [-Resources <VBRCloudSubUserResource[]>] [-PassThru]  [<CommonParameters>]

Detailed Description

This cmdlet modifies settings for the subuser tenant account. You can modify the cloud subuser accounts of the following types:

  • Simple cloud subtenant accounts
  • Cloud Director subtenant accounts

Important

You cannot modify the following settings:

  • The cloud subuser name. After the subuser account is created, the name becomes a part of system information and cannot be changed.
  • For Agent Management subusers: user name and resources.

Note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged.

Parameters

Parameter

Description

Type

Required

Position

Accept
Pipeline
Input

SubUser

Specifies the cloud subuser you want to modify.

Accepts the VBRCloudSubUser type. To get this object, run the Get-VBRCloudSubUser cmdlet.

True

Named

True (ByValue)

Description

Specifies the description of the cloud subuser account.

String

False

Named

False

Password

Specifies the password you want to set to the subuser account.

String

False

Named

False

Disabled

Defines that the cloud subuser is disabled.

SwitchParameter

False

Named

False

Resources

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

Accepts the VBRCloudSubUserResource[] type. To get this object, run the Set-VBRCloudSubUserResource cmdlet.

False

Named

False

PassThru

Defines that the command returns the output object to the Windows 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

IVBRCloudSubUser

Examples

Set-VBRCloudSubUserExample 1. Modifying Password for Selected Cloud Subuser

Set-VBRCloudSubUserExample 2. Disabling Selected Cloud Subuser

Set-VBRCloudSubUserExample 3. Modifying Quota for Selected Cloud Subuser

Related Commands

Get-VBRCloudSubUser

Page updated 4/24/2024

Page content applies to build 12.3.1.1139