---
title: "Set-VBRCloudSubUser"
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 You cannot modify the following settings: The cloud..."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrcloudsubuser.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Cloud Connect > Veeam Cloud Connect Subusers > Set-VBRCloudSubUser"
dateModified: "2026-08-19"
---

# Set-VBRCloudSubUser

## Short Description
Modifies settings of cloud subuser accounts.

**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

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Description</span></p>
        </td>
        <td>
          <p>Specifies the description of the cloud subuser account.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Disabled</span></p>
        </td>
        <td>
          <p>Defines that the cloud subuser is disabled.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">PassThru</span></p>
        </td>
        <td>
          <p>Defines that the command returns the output object to the Windows PowerShell console.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Password</span></p>
        </td>
        <td>
          <p>Specifies the password you want to set to the subuser account.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Resources</span></p>
        </td>
        <td>
          <p>Specifies the quota of the subuser backup resources you want to give to the subuser.</p><p>Accepts the <a href="vbrcloudsubuserresource.md"><code>VBRCloudSubUserResource[]</code></a> type. To get this object, run the <a href="set-vbrcloudsubuserresource.md"><code>Set-VBRCloudSubUserResource</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrcloudsubuserresource.md"><code>VBRCloudSubUserResource[]</code></a></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SubUser</span></p>
        </td>
        <td>
          <p>Specifies the cloud subuser you want to modify.</p><p>Accepts the <a href="vbrcloudsubuser.md"><code>VBRCloudSubUser</code></a> type. To get this object, run the <a href="get-vbrcloudsubuser.md"><code>Get-VBRCloudSubUser</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>IVBRCloudSubUser</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
`IVBRCloudSubUser`

## Examples

::: example
### Example 1.  Modifying Password for Selected Cloud Subuser

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

```
$subuser = Get-VBRCloudSubUser -Name "Subuser 1"
Set-VBRCloudSubUser -SubUser $subuser -Password "Pass12345"
```

Perform the following steps:

1. Run the [`Get-VBRCloudSubUser`](get-vbrcloudsubuser.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$subuser` variable.
2. Run the `Set-VBRCloudSubUser` cmdlet. Set the `$subuser` variable as the `SubUser` parameter value. Specify the `Password` parameter value.

:::

::: example
### Example 2.  Disabling Selected Cloud Subuser

This example shows how to disable a selected cloud subuser.

```
$subuser = Get-VBRCloudSubUser -Name "Subuser 1"
Set-VBRCloudSubUser -SubUser $subuser -Disabled
```

Perform the following steps:

1. Run the [`Get-VBRCloudSubUser`](get-vbrcloudsubuser.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$subuser` variable.
2. Run the `Set-VBRCloudSubUser` cmdlet. Set the `$subuser` variable as the `SubUser` parameter value. Provide the `Disabled` parameter.

:::

::: example
### Example 3.  Modifying Quota for Selected Cloud Subuser

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

```
$subuser = Get-VBRCloudSubUser -Name "Subuser 1"
$subuserresources = $subuser.Resources[0]
$newresources = Set-VBRCloudSubUserResource -CloudSubUserResource $subuserresources -Quota 20
Set-VBRCloudSubUser -SubUser $subuser -Resources $newresources
```

Perform the following steps:

1. Run the [`Get-VBRCloudSubUser`](get-vbrcloudsubuser.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$subuser` variable.
2. Get the existing quota of the subuser. Use the `Resources` property of the [`VBRCloudSubUserResource`](vbrcloudsubuserresource.md) object saved to the `$subuser` variable. Save the result to the `$subuserresources` variable.
3. Run the [`Set-VBRCloudSubUserResource`](set-vbrcloudsubuserresource.md) cmdlet. Set the `$subuserresources` variable as the `CloudSubUserResource` parameter value. Specify the `Quota` parameter value. Save the result to the `$newresources` variable.
4. Run the `Set-VBRCloudSubUser` cmdlet. Set the `$subuser` variable as the `SubUser` parameter value. Set the `$newresources` variable as the `Resources` parameter value.

:::

## Related Commands

[`Get-VBRCloudSubUser`](get-vbrcloudsubuser.md)