---
title: "Get-VBRCloudTenant"
description: "Returns cloud tenant accounts. Platform: VMware, Hyper-V Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License Requires a cloud provider license."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/get-vbrcloudtenant.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Cloud Connect > Veeam Cloud Connect Tenant Accounts > Get-VBRCloudTenant"
dateModified: "2026-08-19"
---

# Get-VBRCloudTenant

## Short Description
Returns cloud tenant accounts.

**Platform**: VMware, Hyper-V

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

Requires a cloud provider license.

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>AllParameterSets (Default)</code></p>

```
Get-VBRCloudTenant [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Id</code></p>

```
Get-VBRCloudTenant [-Id <Guid[]>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Name</code></p>

```
Get-VBRCloudTenant [-Name <String[]>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>BackupRepository</code></p>

```
Get-VBRCloudTenant [-Repository <CBackupRepository[]>] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet returns cloud tenant accounts of the following types:

- Simple cloud tenant accounts
- Cloud Director tenant accounts

::: important

The cmdlet gets only information on a number of licensed objects. To get information on backups stored in quota (non-licensed objects), see the [Tenant Machine Count](https://helpcenter.veeam.com/docs/backup/cloud/cloud_connect_machine_count.html?ver=120) section in Veeam Cloud Connect Guide.

:::

::: note

The cmdlet returns information on a number of processed workloads that consume instances from the license scope. Instances are not consumed if a provider obtains a rental license and workloads have been processed for the first time during the current month. These workloads are counted separately and the cmdlet will display them under the following tenant settings:

- `NewVMBackupCount`
- `NewWorkstationBackupCount`
- `NewServerBackupCount`
- `NewReplicaCount`

Workloads that start to consume instances on the first day of the following month are displayed under the following tenant settings:

- `VMCount`
- `WorkstationCount`
- `ServerCount`
- `ReplicaCount`

If a tenant obtains a rental license, these workloads do not consume instances from the provider license scope and are displayed under the following tenant settings:

- `RentalVMBackupCount`
- `RentalWorkstationBackupCount`
- `RentalServerBackupCount`
- `RentalReplicaCount`

:::

## 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">Id</span></p>
        </td>
        <td>
          <p>Specifies an array of cloud tenant IDs you want to get.</p><p>Accepts <code>Guid[]</code> or <code>String[]</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>Guid[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</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">Name</span></p>
        </td>
        <td>
          <p>Specifies an array of cloud tenant names. The cmdlet will return details on tenants with specified names.</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>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Repository</span></p>
        </td>
        <td>
          <p>Specifies an array of backup repositories. The cmdlet will return the tenants that use these repositories.</p><p>You can specify simple or scale-out backup repositories.</p><p>You cannot specify cloud repositories.</p><p>Accepts the <code>CBackupRepository[]</code> object. To get this object, run the <a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackupRepository[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</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).

## Examples

::: example
### Example 1. Getting All Cloud Tenants

This example shows how to look for all cloud tenants.

```
Get-VBRCloudTenant
```

:::

::: example
### Example 2. Getting Cloud Tenant by Tenant Account Name

This example shows how to look for a cloud tenant by the tenant account name.

```
Get-VBRCloudTenant -Name "ABC Company"
```

:::

::: example
### Example 3. Getting Cloud Tenant by Tenant Account Backup Repository

This example shows how to look for a cloud tenants by the tenant account backup repository.

```
$repository = Get-VBRBackupRepository -Name "Backups Vol2"
Get-VBRCloudTenant -Repository $repository
```

Perform the following steps:

1. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
2. Run the `Get-VBRCloudTenant` cmdlet. Set the `$repository` variable as `Repository` parameter value.

:::

## Related Commands

[`Get-VBRBackupRepository`](get-vbrbackuprepository.md)