---
title: "Add-VBRViAdvancedVirtualLab"
description: "Creates a VMware advanced virtual lab. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet creates a VMware advanced virtual lab."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrviadvancedvirtuallab.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > SureBackup > SureBackup Virtual Labs > Add-VBRViAdvancedVirtualLab"
dateModified: "2026-08-19"
---

# Add-VBRViAdvancedVirtualLab

## Short Description
Creates a VMware advanced virtual lab.

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

## Syntax
```
Add-VBRViAdvancedVirtualLab -Server <CHost> [-Name <String>] [-Description <String>]
 [-DesignatedResourcePoolName <String>] [-DesignatedVMFolderName <String>] [-CacheDatastore <VBRViDatastore>]
 [-ProxyAppliance <VBRViVirtualLabProxyAppliance>] [-NetworkMappingRule <VBRViVirtualLabNetworkMappingRule[]>]
 [-NetworkOptions <VBRViVirtualLabNetworkOptions[]>] [-EnableRoutingBetweenvNics] [-DVS <VBRViVirtualSwitch>]
 [-IpMappingRule <VBRViVirtualLabIPMappingRule[]>] [-Force] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates a VMware advanced virtual lab.

## 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">CacheDatastore</span></p>
        </td>
        <td>
          <p>Specifies a datastore to keep redo logs for verified VMs.</p><p><strong>Note</strong>: If you do not specify this parameter, Veeam Backup & Replication will store redo logs on the vPower NFS server.</p><p>Accepts the <code>VBRViDatastore</code> object. To get this object, run the <a href="find-vbrvidatastore.md"><code>Find-VBRViDatastore</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRViDatastore</code></p>
        </td>
        <td style="width:10%;">
          <p>False</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">Description</span></p>
        </td>
        <td>
          <p>Specifies a description. The cmdlet will create a virtual lab with this description.</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>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">DesignatedResourcePoolName</span></p>
        </td>
        <td>
          <p>Specifies a name of a resource pool. The cmdlet will create the resource pool with the specified name on the ESXi host.</p><p>Default: Same name as the Virtual Lab.</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>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">DesignatedVMFolderName</span></p>
        </td>
        <td>
          <p>Specifies a name of the dedicated folder. The cmdlet will create the folder in a resource pool with the specified name.</p><p>Default: Same name as the Virtual Lab.</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>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">DVS</span></p>
        </td>
        <td>
          <p>Specifies the VMware Distributed vSwitch. The create a virtual lab with the specified virtual switch.</p><p>Accepts the <code>VBRViVirtualSwitch</code> object. To get this object, run the <a href="get-vbrvivirtualswitch.md"><code>Get-VBRViVirtualSwitch</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrvivirtualswitch.md"><code>VBRViVirtualSwitch</code></a></p>
        </td>
        <td style="width:10%;">
          <p>False</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">EnableRoutingBetweenvNics</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will enable communication between isolated networks.</p><p>If you provide this parameter, the cmdlet will enable communication between isolated networks. Otherwise, Veeam Backup & Replication will not be able to connect the isolated networks with production networks.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will not show any warning about network mapping. If you do not provide this parameter, the cmdlet will display a warning.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</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">IpMappingRule</span></p>
        </td>
        <td>
          <p>Specifies static IP address mapping rules. The cmdlet will create a virtual lab with the specified mapping rules.</p><p>Accepts the <code>VBRViVirtualLabIPMappingRule[]</code> object. To get this object, run the <a href="new-vbrvivirtuallabipmappingrule.md"><code>New-VBRViVirtualLabIPMappingRule</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRViVirtualLabIPMappingRule[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</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">Name</span></p>
        </td>
        <td>
          <p>Specifies a name. The cmdlet will create a virtual lab with this name.</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>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">NetworkMappingRule</span></p>
        </td>
        <td>
          <p>Specifies mapping rules of isolated networks with production networks. The cmdlet will create a virtual lab with the specified mapping rules.</p><p>Accepts the <code>VBRViVirtualLabNetworkMappingRule[]</code> object. To get this object, run the <a href="new-vbrvinetworkmappingrule.md"><code>New-VBRViNetworkMappingRule</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRViVirtualLabNetworkMappingRule[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</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">NetworkOptions</span></p>
        </td>
        <td>
          <p>Specifies network settings of an isolated network. The cmdlet will create a virtual lab with the specified network settings.</p><p>Accepts the <code>VBRViVirtualLabNetworkOptions[]</code> object. To get this object, run the <a href="new-vbrvivirtuallabnetworkoptions.md"><code>New-VBRViVirtualLabNetworkOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRViVirtualLabNetworkOptions[]</code></p>
        </td>
        <td style="width:10%;">
          <p>False</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">ProxyAppliance</span></p>
        </td>
        <td>
          <p>Specifies a proxy appliance. The cmdlet will add this proxy appliance to a virtual lab.</p><p>Accepts the <code>VBRViVirtualLabProxyAppliance</code> object. To get this object, run the <a href="new-vbrvivirtuallabproxyappliance.md"><code>New-VBRViVirtualLabProxyAppliance</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRViVirtualLabProxyAppliance</code></p>
        </td>
        <td style="width:10%;">
          <p>False</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">Server</span></p>
        </td>
        <td>
          <p>Specifies an ESXi host. The cmdlet will create a virtual lab on this host.</p><p>Accepts the <code>CHost</code> object. To get this object, run the <a href="get-vbrserver.md"><code>Get-VBRServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CHost</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>
    </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
The cmdlet returns the `VBRVirtualLab` object that contains settings of advanced VMware virtual labs.

## Examples

::: example
### Example 1. Creating Advanced Virtual Lab

This example shows how to create an advanced virtual lab with default settings. The cmdlet will create the virtual lab on the esx09.tech.local ESXi host.

```
$esxi = Get-VBRServer -Name "esx09.tech.local"
Add-VBRViAdvancedVirtualLab -Server $esxi -Name "Exchange Lab" -Description "Virtual Lab for Exchange VMs"
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$esxi` variable.
2. Run the `Add-VBRViAdvancedVirtualLab` cmdlet. Set the `$esxi` variable as the `Server` parameter value. Specify the `Name` parameter value. Specify the `Description` parameter value.

:::

::: example
### Example 2. Creating Virtual Lab with Custom Datastore

The following request returns license usage data for the VAO server with the ID `76da0d75-75b0-4675-8296-0142ad0d52a7`.

- Veeam Backup & Replication will keep redo logs on the `esx09-das6` datastore.
- The virtual lab will be located on the SQL test resource pool with the SQL folder.

```
$esxi = Get-VBRServer -Name "esx09.tech.local"
$datastore = Find-VBRViDatastore -Server $esxi -Name "esx09-das6"
Add-VBRViAdvancedVirtualLab -Server $esxi -Name "SQL Database Lab" -Description "Virtual Lab for SQL Databases" -DesignatedResourcePoolName "SQL test" -DesignatedVMFolderName "SQL" -CacheDatastore $datastore
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$esxi` variable.
2. Run the [`Find-VBRViDatastore`](find-vbrvidatastore.md) cmdlet. Set the `$esxi` variable as the `Server` parameter value. Specify the `Name` parameter value. Save the result to the `$datastore` variable.
3. Run the `Add-VBRViAdvancedVirtualLab` cmdlet. Specify the following settings:

   - Set the `$esxi` variable as the `Server` parameter value.
   - Specify the `Name` parameter value.
   - Specify the `Description` parameter value.
   - Specify the `DesignatedResourcePoolName` parameter value.
   - Specify the `DesignatedVMFolderName` parameter value.
   - Set the `$datastore` variable as the `CacheDatastore` parameter value.

:::

## Related Commands

- [`Get-VBRServer`](get-vbrserver.md)
- [`Find-VBRViDatastore`](find-vbrvidatastore.md)