Connect-VSBHvVirtualLab (obsolete)

Short Description

Connects an existing Hyper-V virtual lab.

Note

This cmdlet is obsolete. The cmdlet still works but may not be supported in further versions.

Platform: Hyper-V

For VMware, run the Connect-VSBVirtualLabConnects an existing VMware virtual lab. This cmdlet is deprecated and will be marked as obsolete in the future. It is recommended to re-write your scripts using the Connect-VBRViVirtualLab cmdlet. cmdlet.

Product Edition: Enterprise, Enterprise Plus, Veeam Universal License

Syntax

Connect-VSBHvVirtualLab [[-VirtualLab] <CHvLabShortInfo>] [<CommonParameters>]

Detailed Description

This cmdlet connects an existing Hyper-V virtual lab to Veeam Backup & Replication console.

When you add a new host to your Veeam Backup & Replication console, the virtual labs that are registered on it are not added automatically. Use this cmdlet to add the virtual labs to your Veeam Backup & Replication console.

Parameters

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

VirtualLab

Specifies the virtual lab you want to connect to your Veeam Backup & Replication console.

Accepts the CHvLabShortInfo object. To get this object, run the Find-VSBHvVirtualLabLooks for virtual labs created on the specified Hyper-V host. This cmdlet is obsolete. The cmdlet will still work but may not be supported in further versions. cmdlet.

CHvLabShortInfo

False

0

True (ByPropertyName, ByValue)

<CommonParameters>

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

Examples

Connect-VSBHvVirtualLab (obsolete)Example 1. Connecting Virtual Lab [Using Pipeline]

This example shows how to connect the Exchange VLab 01 virtual lab.

$server = Get-VBRServer -Name "srv001"

Find-VSBHvVirtualLab -Server $server -Name "Exchange VLab 01" | Connect-VSBHvVirtualLab

Perform the following steps:

  1. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
  2. Run the Find-VSBHvVirtualLabLooks for virtual labs created on the specified Hyper-V host. This cmdlet is obsolete. The cmdlet will still work but may not be supported in further versions. cmdlet. Set the $server variable as the Server parameter value. Specify the Name parameter value.
  3. Pipe the cmdlet output to the Connect-VSBHvVirtualLab cmdlet.

Connect-VSBHvVirtualLab (obsolete)Example 2. Connecting Virtual Lab [Using Variable]

This example shows how to connect the Exchange VLab 01 virtual lab.

$server = Get-VBRServer -Name "srv001"

$VLab01 = Find-VSBHvVirtualLab -Server $server -Name "Exchange VLab 01"

Connect-VSBHvVirtualLab -VirtualLab $VLab01

Perform the following steps:

  1. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
  2. Run the Find-VSBHvVirtualLabLooks for virtual labs created on the specified Hyper-V host. This cmdlet is obsolete. The cmdlet will still work but may not be supported in further versions. cmdlet. Set the $server variable as the Server parameter value. Specify the Name parameter value. Save the result to the $VLab01 variable.
  3. Run the Connect-VSBHvVirtualLab cmdlet. Set the $VLab01 variable as the VirtualLab parameter value.

Find-VSBHvVirtualLabLooks for virtual labs created on the specified Hyper-V host. This cmdlet is obsolete. The cmdlet will still work but may not be supported in further versions.

Page updated 2026-08-19

Page content applies to build 13.1.1.18