---
title: "Add-VBRCloudSubTenant"
description: "This cmdlet creates a new cloud subtenant account."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrcloudsubtenant.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Cloud Connect > Veeam Cloud Connect Subtenants > Add-VBRCloudSubTenant"
dateModified: "2026-08-19"
---

# Add-VBRCloudSubTenant

## Short Description
Creates cloud subtenant accounts.

**Platform**: VMware, Hyper-V

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

## Syntax
```
Add-VBRCloudSubTenant -Tenant <VBRCloudTenant> -Name <String> [-Description <String>] -Password <String>
 [-HashedPassword] [-Disabled] -Resources <VBRCloudSubTenantResource[]> [<CommonParameters>]
```

## Detailed Description
This cmdlet creates a new cloud subtenant account.

## 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 subtenant 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 subtenant 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">HashedPassword</span></p>
        </td>
        <td>
          <p>Defines that you submit the hashed password. The hashed passwords are stored in Veeam backup database.</p><p>Use this parameter, for example, to restore subtenant accounts.</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 subtenant account.</p><p>The subtenant name must meet the following requirements:</p><ul><li>The maximum length of the subtenant name is 128 characters. It is recommended that you create short subtenant names to avoid problems with long paths to backup files on the cloud repository.</li><li>The subtenant name may contain space characters.</li><li>The subtenant name must not contain the following characters: \\/:*?\\"&lt;&gt;|=; as well as Unicode characters.</li><li>The subtenant 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 subtenant 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 subtenant backup resources you want to give to the subtenant.</p><p>Accepts the <a href="vbrcloudsubtenantresource.md"><code>VBRCloudSubTenantResource[]</code></a> object. To get this object, run the <a href="new-vbrcloudsubtenantresource.md"><code>New-VBRCloudSubtenantResource</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrcloudsubtenantresource.md"><code>VBRCloudSubTenantResource[]</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Tenant</span></p>
        </td>
        <td>
          <p>Specifies the parent tenant. The cmdlet will use resources of this tenant as parent resources for the subtenant.</p><p>Accepts the <a href="vbrcloudtenant.md"><code>VBRCloudTenant</code></a> object. To get this object, run the <a href="get-vbrcloudtenant.md"><code>Get-VBRCloudTenant</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrcloudtenant.md"><code>VBRCloudTenant</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>
    </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
[`VBRCloudSubTenant`](vbrcloudsubtenant.md)

## Examples

::: example
### Creating Cloud Subtenant Account

This example shows how to create a cloud subtenant account.

```
$parent = Get-VBRCloudTenant -Name "ABC Company"
$parentresource = $parent.Resources[0]
$subtenantquota = New-VBRCloudSubtenantResource -Parent $parentresource -RepositoryFriendlyName "ABC Cloud Repository" -Unlimited
$tenant = Get-VBRCloudTenant -Name "Alpha"
Add-VBRCloudSubTenant -Tenant $tenant -Name "Alpha" -Password "Pass123" -Resources $subtenantquota
```

Perform the following steps:

1. Run the [`Get-VBRCloudTenant`](get-vbrcloudtenant.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$parent` variable.
2. Get the parent resources using the `Resources` property of the [`VBRCloudTenantResource`](vbrcloudtenantresource.md) object saved to the `$parent` variable. Save the result to the `$parentresource` variable.
3. Run the [`New-VBRCloudSubTenantResource`](new-vbrcloudsubtenantresource.md) cmdlet for details. Set the `$parentresource` variable as the `Parent` parameter value. Specify the `RepositoryFriendlyName` parameter value. Provide the `Unlimited` parameter. Save the result to the `$subtenantquota` variable.
4. Run the [`Get-VBRCloudTenant`](get-vbrcloudtenant.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$tenant` variable.
5. Run the `Add-VBRCloudSubTenant` cmdlet. Specify the following settings:

   - Set the `$tenant` variable as the `Tenant` parameter value.
   - Specify the `Name` and the `Password` parameter values.
   - Set the `$subtenantquota` variable as the `Resources` parameter value.

:::

## Related Commands

[`Get-VBRCloudTenant`](get-vbrcloudtenant.md)