---
title: "Set-VBRViVirtualLab"
description: "Modifies settings of VMware virtual labs. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet modifies settings of VMware virtual labs of the following kinds: To modify settings, specify new values for the nece"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrvivirtuallab.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > SureBackup > SureBackup Virtual Labs > Set-VBRViVirtualLab"
dateModified: "2026-08-19"
---

# Set-VBRViVirtualLab

## Short Description
Modifies settings of VMware virtual labs.

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

## Syntax
```
Set-VBRViVirtualLab -VirtualLab <VBRViVirtualLabConfiguration> [-Type <VBRViVirtualLabType>]
 [-Description <String>] [-EnableCacheRedirect] [-CacheDatastore <VBRViDatastore>] [-EnableProxyAppliance]
 [-ProxyAppliance <VBRViVirtualLabProxyAppliance>] [-DVS <VBRViVirtualSwitch>]
 [-NetworkMappingRule <VBRViVirtualLabNetworkMappingRule[]>]
 [-NetworkOptions <VBRViVirtualLabNetworkOptions[]>] [-EnableRoutingBetweenvNics] [-EnableStaticIPMapping]
 [-IpMappingRule <VBRViVirtualLabIPMappingRule[]>] [-Force] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies settings of VMware virtual labs of the following kinds:

- VMware Basic Virtual Lab
- VMware Advanced Virtual Lab

::: note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged.

:::

## 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>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">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">EnableCacheRedirect</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will redirect redo logs of verified VMs to the datastore.</p><p>If you provide this parameter, Veeam Backup & Replication will keep the redo logs on the specified datastore. Otherwise, it will keep them on the vPower NFS server.</p><p>Run the <code>CacheDatastore</code> parameter to specify the datastore for the redo logs.</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">EnableProxyAppliance</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will enable the proxy appliance option.</p><p>If you specify this option, Veeam Backup & Replication enable automatic recovery verification of VMs. Otherwise, Veeam Backup & Replication will only start VMs in the virtual lab and perform the heartbeat test for VMs during recovery verification.</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">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">EnableStaticIPMapping</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will enable the static IP mapping option.</p><p>If you provide this parameter, Veeam Backup & Replication will assign a static IP address to every VM in the virtual lab. Otherwise, you must update the routing table on every client machine.</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">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-vbrvivirtuallabipmappingrule.md"><code>New-VBRViVirtualLabIPMappingRule</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">Type</span></p>
        </td>
        <td>
          <p>Specifies a networking mode for a virtual lab. You can select one of the following networking modes:</p><ul><li><code>Simple</code>: use this option if all VMs that you want to verify are connected to the same production network.</li><li><code>Advanced</code>: use this option if all VMs that you want to verify are connected to different networks and are located on the same ESXi hosts.</li><li><code>AdvancedMultiHost</code>: use this option if all VMs that you want to verify are connected to different networks and are located on the different ESXi hosts.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRViVirtualLabType</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">VirtualLab</span></p>
        </td>
        <td>
          <p>Specifies a virtual lab that you want to modify.</p><p>Accepts the <code>VBRViVirtualLabConfiguration</code> object. To get this object, run the <a href="get-vbrvivirtuallabconfiguration.md"><code>Get-VBRViVirtualLabConfiguration</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRViVirtualLabConfiguration</code></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).

## Output Object
The cmdlet returns the `VBRViVirtualLabConfig>[]` object that contains settings of basic VMware virtual labs.

## Examples

::: example
### Example 1. Modifying Datastore for Virtual Lab

This example shows how to specify the custom datastore for a virtual lab. Veeam Backup & Replication will keep redo logs on the `esx09-das6` datastore instead of the Power NFS server.

```
$lab = Get-VBRViVirtualLabConfiguration -Name "SQL Virtual Lab"
$ESXi = Get-VBRServer -Name "esx09.tech.local"
$datastore = Find-VBRViDatastore -Server $ESXi -Name "esx09-das6"
Set-VBRViVirtualLab -VirtualLab $lab -CacheDatastore $datastore
```

Perform the following steps:

1. Run the [`Get-VBRViVirtualLabConfiguration`](get-vbrvivirtuallabconfiguration.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$lab` variable.
2. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$ESXi` variable.
3. Run the [`Find-VBRViDatastore`](find-vbrvidatastore.md) cmdlet. Set the `$ESXi` as the `Server` parameter value. Specify the `Name` parameter value. Save the result to the `$datastore` variable.
4. Run the `Set-VBRViVirtualLab` cmdlet. Set the `$lab` variable as the `VirtualLab` parameter value. Set the `$datastore` variable as the `CacheDatastore` parameter value.

:::

::: example
### Example 2. Modifying Networking Mode for Virtual Lab

This example shows how to modify networking mode for a virtual lab. The networking mode will be switched to verify that all VMs are connected to different networks and are located on the same ESXi hosts.

```
$lab = Get-VBRViVirtualLabConfiguration -Name "SQL Virtual Lab"
Set-VBRViVirtualLab -VirtualLab $lab -Type Advanced
```

Perform the following steps:

1. Run the [`Get-VBRViVirtualLabConfiguration`](get-vbrvivirtuallabconfiguration.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$lab` variable.
2. Run the `Set-VBRViVirtualLab` cmdlet. Set the `$lab` variable as the `VirtualLab` parameter value. Set the `Advanced` option for the `Type` parameter.

:::

## Related Commands

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