---
title: "Get-VBRLicensedInstanceWorkload"
description: "This cmdlet returns the VBRLicensedInstanceWorkload object that contains details on protected workloads for the per-instance license that Veeam Backup & Replication applies to back up these workloads."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/get-vbrlicensedinstanceworkload.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Licenses > Get-VBRLicensedInstanceWorkload"
dateModified: "2026-08-19"
---

# Get-VBRLicensedInstanceWorkload

## Short Description
Returns details on protected workloads for the per-instance license.

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

## Syntax
```
Get-VBRLicensedInstanceWorkload -License <VBRInstalledLicense> [<CommonParameters>]
```

## Detailed Description
This cmdlet returns the `VBRLicensedInstanceWorkload` object that contains details on protected workloads for the per-instance license that Veeam Backup & Replication applies to back up these workloads.

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

- VMBackupCount
- WorkstationBackupCount
- ServerBackupCount
- 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">License</span></p>
        </td>
        <td>
          <p>Specifies a license. The cmdlet will return details on protected workloads that Veeam Backup & Replication backs up using this license.</p><p>Accepts the <a href="vbrinstalledlicense.md"><code>VBRInstalledLicense</code></a> object. To get this object, run the <a href="get-vbrinstalledlicense.md"><code>Get-VBRInstalledLicense</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrinstalledlicense.md"><code>VBRInstalledLicense</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
[`VBRLicensedInstanceWorkload`](vbrlicensedinstanceworkload.md)

## Examples

::: example
### Getting Details on Protected Workloads

This example shows how to get details on protected workloads for the per-instance license that Veeam Backup & Replication applies to back up these workloads.

```
$license = Get-VBRInstalledLicense
Get-VBRLicensedInstanceWorkload -License $license
```

Perform the following steps:

1. Run the [`Get-VBRInstalledLicense`](get-vbrinstalledlicense.md) cmdlet. Save the result to the `$license` variable.
2. Run the `Get-VBRLicensedInstanceWorkload` cmdlet. Set the `$license` variable as the `License` parameter value.

:::

## Related Commands

[`Get-VBRInstalledLicense`](get-vbrinstalledlicense.md)