---
title: "Add-VBRCloudSubUser"
description: "This cmdlet creates new cloud subuser accounts."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrcloudsubuser.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Cloud Connect > Veeam Cloud Connect Subusers > Add-VBRCloudSubUser"
dateModified: "2026-08-19"
---

# Add-VBRCloudSubUser

## Short Description
Creates cloud subuser accounts.

**Platform**: VMware, Hyper-V

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

## Syntax
```
Add-VBRCloudSubUser -CloudProvider <VBRCloudProvider> -Name <String> [-Description <String>] -Password <String>
 [-Disabled] -Resources <VBRCloudSubUserResource[]> [<CommonParameters>]
```

## Detailed Description
This cmdlet creates new cloud subuser accounts.

## 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">CloudProvider</span></p>
        </td>
        <td>
          <p>Specifies the cloud provider. The resources of this provider will be parent for the subuser.</p><p>Accepts the <a href="vbrcloudprovider.md"><code>VBRCloudProvider</code></a> object. To get this object, run the <a href="get-vbrcloudprovider.md"><code>Get-VBRCloudProvider</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrcloudprovider.md"><code>VBRCloudProvider</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </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">Name</span></p>
        </td>
        <td>
          <p>Specifies the name you want to assign to the subuser account.</p><p>The subuser name must meet the following requirements:</p><ul><li>The maximum length of the subuser name is 128 characters. It is recommended that you create short subuser names to avoid problems with long paths to backup files on the cloud repository.</li><li>The subuser name may contain space characters.</li><li>The subuser name must not contain the following characters: \\/:*?\\"&lt;&gt;|=; as well as Unicode characters.</li><li>The subuser name must not end with the period character [.].</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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>True</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> object. To create this object, run the <a href="new-vbrcloudsubuserresource.md"><code>New-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>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</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
[`VBRCloudSubUser`](vbrcloudsubuser.md)

## Examples

::: example
### Creating Cloud Subuser Account

This example shows how to create a cloud subuser account.

```
$cloudrepository = Get-VBRBackupRepository | Where {$_.Type -eq "Cloud"} | Select -First 1
$subuserquota = New-VBRCloudSubUserResource -CloudRepository $cloudrepository -RepositoryFriendlyName "Cloud Repository 1" -Quota 10
$cloudprovider = Get-VBRCloudProvider
Add-VBRCloudSubUser -CloudProvider $cloudprovider -Name "Subuser 1" -Password "Pass 123" -Resources $subuserquota
```

Perform the following steps:

1. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Pipe the cmdlet output to the `Where` cmdlet to filter repositories where `Type` property equals `Cloud`. Pipe the cmdlet output to the `Select` cmdlet. Set the `1` number as the `First` parameter value. Save the result to the `$cloudrepository` variable.
2. Run the [`New-VBRCloudSubUserResource`](new-vbrcloudsubuserresource.md) cmdlet. Set the `$cloudrepository` variable as the `CloudRepository` parameter value. Specify the `RepositoryFriendlyName` and the `Quota` parameter values. Save the result to the `$subuserquota` variable.
3. Run the [`Get-VBRCloudProvider`](get-vbrcloudprovider.md) cmdlet. Save the result to the `$cloudprovider` variable.
4. Run the `Add-VBRCloudSubUser` cmdlet. Specify the following settings:

   - Set the `$cloudprovider` variable as the `CloudProvider` parameter value.
   - Specify the `Name` parameter value.
   - Specify the `Password` parameter value.
   - Set the `$subuserquota` variable as the `Resources` parameter value.

:::

## Related Commands

- [`Get-VBRCloudProvider`](get-vbrcloudprovider.md)
- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)
- [`New-VBRCloudSubUserResource`](new-vbrcloudsubuserresource.md)