Assign-VBRInstanceWorkload

Short Description

Sets the product edition for standalone Veeam Agents.

Applies to

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

Syntax

Assign-VBRInstanceWorkload -Workload <VBRLicensedInstanceWorkload[]> -LicenseMode <VBRAgentLicenseMode> {Server | Workstation} [<CommonParameters>]

Detailed Description

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

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Workload	Specifies an array of protected workloads. The cmdlet will set the product edition for these workloads.	Accepts the VBRLicensedInstanceWorkload[] object. To get this object, run the Get-VBRLicensedInstanceWorkload cmdlet.	True	Named	False
LicenseMode	Specifies a product edition. The cmdlet will set this product edition to protected. You can specify either of the following product editions: Server Workstation	VBRAgentLicenseMode	True	Named	False

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Workload

Specifies an array of protected workloads. The cmdlet will set the product edition for these workloads.

Accepts the VBRLicensedInstanceWorkload[] object. To get this object, run the Get-VBRLicensedInstanceWorkload cmdlet.

True

Named

False

LicenseMode

Specifies a product edition. The cmdlet will set this product edition to protected. You can specify either of the following product editions:

True

Named

False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Examples

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

Run the Get-VBRInstalledLicense cmdlet. Save the result to the $license variable.
Run the Get-VBRLicensedInstanceWorkload cmdlet. Set the $license variable as the License parameter value. Save the result to the $workload variable.

Run the Assign-VBRInstanceWorkload cmdlet. Set the $workload variable as the Workload parameter value. Set the Server option for the LicenseMode parameter.

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

Run the Get-VBRInstalledLicense cmdlet. Save the result to the $license variable.
Run the Get-VBRLicensedSocketWorkload cmdlet. Set the $license variable as the License parameter value. Save the result to the $workload variable.
Run the Assign-VBRInstanceWorkload cmdlet. Set the $workload variable as the Workload parameter value. Set the Workstation option for the LicenseMode parameter.

Related Commands