---
title: "Assign-VBRInstanceWorkload"
description: "This cmdlet sets the product edition for standalone Veeam Agents to one of the following: Server edition Workstation edition"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/assign-vbrinstanceworkload.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Licenses > Assign-VBRInstanceWorkload"
dateModified: "2026-08-19"
---

# Assign-VBRInstanceWorkload

## Short Description
Sets the product edition for standalone Veeam Agents.

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

## Syntax
```
Assign-VBRInstanceWorkload -Workload <VBRLicensedInstanceWorkload[]> -LicenseMode <VBRAgentLicenseMode> [<CommonParameters>]
```

## Detailed Description
This cmdlet sets the product edition for standalone Veeam Agents to one of the following:

- Server edition
- Workstation edition

## 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">LicenseMode</span></p>
        </td>
        <td>
          <p>Specifies a product edition. The cmdlet will set this product edition to protected. You can specify either of the following product editions:</p><ul><li><code>Server</code></li><li><code>Workstation</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRAgentLicenseMode</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">Workload</span></p>
        </td>
        <td>
          <p>Specifies an array of protected workloads. The cmdlet will set the product edition for these workloads.</p><p>Accepts the <a href="vbrlicensedinstanceworkload.md"><code>VBRLicensedInstanceWorkload</code></a><code>[]</code> object. To get this object, run the <a href="get-vbrlicensedinstanceworkload.md"><code>Get-VBRLicensedInstanceWorkload</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrlicensedinstanceworkload.md"><code>VBRLicensedInstanceWorkload[]</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).

## Examples

::: example
### Example 1. Setting Server Edition

This example shows how to set the Server edition for a standalone Veeam Agent that is running the Workstation edition.

```
$license = Get-VBRInstalledLicense
$workload = Get-VBRLicensedInstanceWorkload -License $license
Assign-VBRInstanceWorkload -Workload $workload -LicenseMode Server
```

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`](get-vbrlicensedinstanceworkload.md) cmdlet. Set the `$license` variable as the `License` parameter value. Save the result to the `$workload` variable.
3. Run the `Assign-VBRInstanceWorkload` cmdlet. Set the `$workload` variable as the `Workload` parameter value. Set the `Server` option for the `LicenseMode` parameter.

:::

::: example
### Example 2. Setting Workstation Edition

This example shows how to set the Workstation edition for a standalone Veeam Agent that is running the Server edition.

```
$license = Get-VBRInstalledLicense
$workload = Get-VBRLicensedInstanceWorkload -License $license
Assign-VBRInstanceWorkload -Workload $workload -LicenseMode Workstation
```

Perform the following steps:

1. Run the [`Get-VBRInstalledLicense`](get-vbrinstalledlicense.md) cmdlet. Save the result to the `$license` variable.
2. Run the [`Get-VBRLicensedSocketWorkload`](get-vbrlicensedsocketworkload.md) cmdlet. Set the `$license` variable as the `License` parameter value. Save the result to the `$workload` variable.
3. Run the `Assign-VBRInstanceWorkload` cmdlet. Set the `$workload` variable as the `Workload` parameter value. Set the `Workstation` option for the `LicenseMode` parameter.

:::

## Related Commands

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