Set-VBRViVirtualLab

In this article

    Short Description

    Modifies settings of VMware virtual labs.

    Applies to

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

    Syntax

    Set-VBRViVirtualLab -VirtualLab <VBRViVirtualLabConfiguration> [-Type <VBRViVirtualLabType> {Simple | Advanced |AdvancedMultiHost}] [-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

    Parameters

    Parameter

    Description

    Type

    Required

    Position

    Accept Pipeline Input

    VirtualLab

    Specifies a virtual lab that you want to modify.

    Accepts the VBRViVirtualLabConfiguration object. To get this object, run the Get-VBRViVirtualLabConfiguration cmdlet.

    True

    Named

    True (ByValue,
    ByProperty
    Name)

    Type

    Specifies a networking mode for a virtual lab. You can select one of the following networking modes:

    • Simple: use this option if all VMs that you want to verify are connected to the same production network.
    • Advanced: use this option if all VMs that you want to verify are connected to different networks and are located on the same ESXi hosts.
    • AdvancedMultiHost: use this option if all VMs that you want to verify are connected to different networks and are located on the different ESXi hosts.

    VBRViVirtualLabType

    False

    Named

    False

    Description

    Specifies a description. The cmdlet will create a virtual lab with this description.

    String

    False

    Named

    False

    EnableCacheRedirect

    Defines that the cmdlet will redirect redo logs of verified VMs to the datastore.

    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.

    Run the CacheDatastore parameter to specify the datastore for the redo logs.

    SwitchParamter

    False

    Named

    False

    CacheDatastore

    Specifies a datastore to keep redo logs for verified VMs.

    Accepts the VBRViDatastore object. To get this object, run the Find-VBRViDatastore cmdlet.

    False

    Named

    False

    EnableProxyAppliance

    Defines that the cmdlet will enable the proxy appliance option.

    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.

    SwitchParamter

    False

    Named

    False

    ProxyAppliance

    Specifies a proxy appliance. The cmdlet will add this proxy appliance to a virtual lab.

    Accepts the VBRViVirtualLabProxyAppliance object. To get this object, run the New-VBRViVirtualLabProxyAppliance cmdlet.

    False

    Named

    False

    DVS

    Specifies the VMware Distributed vSwitch. The create a virtual lab with the specified virtual switch.

    Accepts the VBRViVirtualSwitch object. To get this object, run the Get-VBRViVirtualSwitch cmdlet.

    False

    Named

    False

    NetworkMappingRule

    Specifies mapping rules of isolated networks with production networks. The cmdlet will create a virtual lab with the specified mapping rules.

    Accepts the VBRViVirtualLabNetworkMappingRule[] object. To get this object, run the New-VBRViVirtualLabIPMappingRule cmdlet.

    False

    Named

    False

    NetworkOptions

    Specifies network settings of an isolated network. The cmdlet will create a virtual lab with the specified network settings.

    Accepts the VBRViVirtualLabNetworkOptions[] object. To get this object, run the New-VBRViVirtualLabNetworkOptions cmdlet.

    False

    Named

    False

    EnableRoutingBetweenvNics

    Defines that the cmdlet will enable communication between isolated networks.

    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.

    SwitchParamter

    False

    Named

    False

    EnableStaticIPMapping

    Defines that the cmdlet will enable the static IP mapping option.

    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.

    SwitchParamter

    False

    Named

    False

    IpMappingRule

    Specifies static IP address mapping rules. The cmdlet will create a virtual lab with the specified mapping rules.

    Accepts the VBRViVirtualLabIPMappingRule[] object. To get this object, run the New-VBRViVirtualLabIPMappingRule cmdlet.

    False

    Named

    False

    Force

    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.

    SwitchParamter

    False

    Named

    False

    <CommonParameters>

    This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

    Output Object

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

    Examples

    Set-VBRViVirtualLabExample 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"

    $esx = Get-VBRServer -Name "esx09.tech.local"

    $datastore = Find-VBRViDatastore -Server $esx -Name "esx09-das6"

    Set-VBRViVirtualLab -VirtualLab $lab -CacheDatastore $datastore

    Run the following steps:

    1. Run the Get-VBRViVirtualLabConfiguration cmdlet. Specify the Name parameter value. Save the result to the $lab variable.
    2. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $esx variable.
    3. Run the Find-VBRViDatastore cmdlet. Set the $esx 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.

    Set-VBRViVirtualLabExample 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

    Run the following steps:

    1. Run the Get-VBRViVirtualLabConfiguration 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 $datastore variable as the CacheDatastore parameter value.

    Related Commands