---
title: "New-VBRViVirtualLabProxyAppliance"
description: "Defines settings of proxy appliances. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet creates the VBRViVirtualLabProxyAppliance object that defines settings of proxy appliances that are added to the virtual"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrvivirtuallabproxyappliance.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > SureBackup > SureBackup Virtual Labs > New-VBRViVirtualLabProxyAppliance"
dateModified: "2026-08-19"
---

# New-VBRViVirtualLabProxyAppliance

## Short Description
Defines settings of proxy appliances.

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

## Syntax
```
New-VBRViVirtualLabProxyAppliance -Server <CHost> [-Name <String>] [-Datastore <VBRViDatastoreBase>]
 [-Network <VBRViNetworkInfo>] [-EnableIPv4Interface] [-ObtainIPAutomatically] [-IPAddress <IPAddress>]
 [-SubnetMask <String>] [-DefaultGateway <IPAddress>] [-ObtainDNSAutomatically]
 [-PreferredDNSServer <IPAddress>] [-AlternateDNSServer <IPAddress>] [-EnableIPv6Interface]
 [-ObtainIPv6AddressAutomatically] [-IPv6Address <IPAddress>] [-IPv6PrefixLength <Int32>]
 [-IPv6DefaultGateway <IPAddress>] [-ObtainIPv6DNSAutomatically] [-IPv6PreferredDNSServer <IPAddress>]
 [-IPv6AlternateDNSServer <IPAddress>] [-HTTPPort <Int32>] [-ProductionProxyIPAddress <IPAddress>]
 [-EnableInternetProxy] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates the `VBRViVirtualLabProxyAppliance` object that defines settings of proxy appliances that are added to the 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">AlternateDNSServer</span></p>
        </td>
        <td>
          <p>Specifies an IPv4 address of an alternate DNS server.</p>
        </td>
        <td style="width:10%;">
          <p><code>IPAddress</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">Datastore</span></p>
        </td>
        <td>
          <p>Specifies the datastore. The cmdlet will deploy a proxy appliance on this datastore.</p><p>Accepts the <code>VBRViDatastore</code> object. To get this object, run the <a href="find-vbrvidatastore.md">Find-VBRViDatastore</a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRViDatastoreBase</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">DefaultGateway</span></p>
        </td>
        <td>
          <p>Specifies an IPv4 address of a default gateway. The cmdlet will assign this IP address to a default gateway on a proxy appliance.</p>
        </td>
        <td style="width:10%;">
          <p><code>IPAddress</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">EnableInternetProxy</span></p>
        </td>
        <td>
          <p>Defines that a proxy appliance will act as an internet proxy for VMs in the isolated network.</p><p>If you provide this parameter, a proxy appliance will act as an internet proxy for VMs in the isolated network. Otherwise, VMs from the isolated network will not have access to the Internet.</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">EnableIPv4Interface</span></p>
        </td>
        <td>
          <p>Defines that IPv4 interface will be enabled.</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">EnableIPv6Interface</span></p>
        </td>
        <td>
          <p>Defines that IPv6 interface will be enabled.</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">HTTPPort</span></p>
        </td>
        <td>
          <p>Specifies the port number. VMs from the isolated network will use this port number to access the Internet.</p><p>Default: <code>8080</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</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">IPAddress</span></p>
        </td>
        <td>
          <p>Specifies an IPv4 address for a proxy appliance in the production network. The cmdlet will assign this IP address to a proxy appliance.</p>
        </td>
        <td style="width:10%;">
          <p><code>IPAddress</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">IPv6Address</span></p>
        </td>
        <td>
          <p>Specifies an IPv6 address for a proxy appliance in the production network. The cmdlet will assign this IP address to a proxy appliance.</p>
        </td>
        <td style="width:10%;">
          <p><code>IPAddress</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">IPv6AlternateDNSServer</span></p>
        </td>
        <td>
          <p>Specifies an IPv6 address of an alternate DNS server.</p>
        </td>
        <td style="width:10%;">
          <p><code>IPAddress</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">IPv6DefaultGateway</span></p>
        </td>
        <td>
          <p>Specifies an IPv6 address of a default gateway. The cmdlet will assign this IP address to a default gateway on a proxy appliance.</p>
        </td>
        <td style="width:10%;">
          <p><code>IPAddress</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">IPv6PreferredDNSServer</span></p>
        </td>
        <td>
          <p>Specifies an IPv6 address of a preferred DNS server.</p>
        </td>
        <td style="width:10%;">
          <p><code>IPAddress</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">IPv6PrefixLength</span></p>
        </td>
        <td>
          <p>Specifies a prefix length for a proxy appliance in the production network. The cmdlet will set up network settings of a proxy appliance with this prefix length.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</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 of a proxy appliance. The cmdlet will deploy the proxy appliance 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">Network</span></p>
        </td>
        <td>
          <p>Specifies the production network. The cmdlet will connect a proxy appliance to the specified network.</p><p>Accepts the <code>VBRViNetworkInfo</code> object. To get this object, run the <a href="get-vbrviservernetworkinfo.md"><code>Get-VBRViServerNetworkInfo</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrvinetworkinfo.md"><code>VBRViNetworkInfo</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">ObtainDNSAutomatically</span></p>
        </td>
        <td>
          <p>Defines that a proxy appliance will obtain DNS server settings automatically.</p><p>If you provide this parameter, Veeam Backup & Replication will obtain IPv4 DNS server settings for the proxy appliance automatically. Otherwise, you will need to set the DNS server settings manually.</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">ObtainIPAutomatically</span></p>
        </td>
        <td>
          <p>Defines that a proxy appliance will obtain an IPv4 address automatically.</p><p>If you provide this parameter, Veeam Backup & Replication will obtain an IP address for the proxy appliance automatically. Otherwise, you will need to set the IP address manually.</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">ObtainIPv6AddressAutomatically</span></p>
        </td>
        <td>
          <p>Defines that a proxy appliance will obtain an IPv6 address automatically.</p><p>If you provide this parameter, Veeam Backup & Replication will obtain an IP address for the proxy appliance automatically. Otherwise, you will need to set the IP address manually.</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">ObtainIPv6DNSAutomatically</span></p>
        </td>
        <td>
          <p>Defines that a proxy appliance will obtain IPv6 DNS server settings automatically.</p><p>If you provide this parameter, Veeam Backup & Replication will obtain DNS server settings for the proxy appliance automatically. Otherwise, you will need to set the DNS server settings manually.</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">PreferredDNSServer</span></p>
        </td>
        <td>
          <p>Specifies an IPv4 address of a preferred DNS server.</p>
        </td>
        <td style="width:10%;">
          <p><code>IPAddress</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">ProductionProxyIPAddress</span></p>
        </td>
        <td>
          <p>Specifies an IP address or a fully qualified domain name of an Internet-facing proxy server that VMs from the isolated network must use to access the Internet.</p>
        </td>
        <td style="width:10%;">
          <p><code>IPAddress</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 deploy a proxy appliance on this host.</p><p><strong>Note</strong>: The ESXi host must be the same as the ESXi host where the virtual lab is created.</p><p>This parameter must be the same as the <code>Server</code> parameter in the objects that are created by the following cmdlets:</p><ul><li><a href="add-vbrviadvancedvirtuallab.md"><code>Add-VBRViAdvancedVirtualLab</code></a></li><li><a href="add-vbrvisimplevirtuallab.md"><code>Add-VBRViSimpleVirtualLab</code></a></li><li><a href="set-vbrvivirtuallab.md"><code>Set-VBRViVirtualLab</code></a></li></ul><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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">SubnetMask</span></p>
        </td>
        <td>
          <p>Specifies a subnet mask for a proxy appliance in the production network. The cmdlet will set up network settings of a proxy appliance with this subnet mask.</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>
    </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 `VBRViVirtualLabProxyAppliance` object that defines settings of proxy appliances that are added to the virtual lab.

## Examples

::: example
### Example 1. Defining Settings of Proxy Appliance with Automatic IP and DNS Setup

This example shows how to define settings of the `Proxy_appliance_05` proxy appliance that is deployed with the automatic IP and DNS setup. The proxy appliance will be deployed with the following settings:

- The proxy appliance will be deployed on the `esx09.tech.local` ESXi host.
- Veeam Backup & Replication will keep redo logs for verified VMs on the `esx09-das6` datastore.
- The proxy appliance will connect to the production network on the `esx09.tech.local` ESXi host.

```
$ESXi = Get-VBRServer -Name "esx09.tech.local"
$network = Get-VBRViServerNetworkInfo -Server $ESXi
$datastore = Find-VBRViDatastore -Server $ESXi -Name "esx09-das6"
New-VBRViVirtualLabProxyAppliance -Server $ESXi -ObtainIPAutomatically -ObtainDNSAutomatically -Name "Proxy_appliance_05" -Datastore $datastore -Network $network[3]
```

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 [`Get-VBRViServerNetworkInfo`](get-vbrviservernetworkinfo.md) cmdlet. Set the `$ESXi` variable as the `Server` parameter value. Save the result to the `$network` variable.
3. 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.
4. Run the `New-VBRViVirtualLabProxyAppliance` cmdlet. Specify the following settings:

   - Set the `$ESXi` variable as the `Server` parameter value.
   - Provide the `ObtainIPAutomatically` parameter.
   - Provide the `ObtainDNSAutomatically` parameter.
   - Specify the `Name` parameter value.
   - Set the `$datastore` variable as the `Datastore` parameter value.
   - Set the `$network[3]` variable as the `Network` parameter value.

     The `Get-VBRViServerNetworkInfo` cmdlet will return an array of production networks. Mind the ordinal number of the necessary production network (An array starts with 0. In our example, it is the fourth production network in the array).

:::

::: example
### Example 2. Defining Settings of Proxy Appliance as Proxy

This example shows how to define settings of a proxy appliance that is deployed with the automatic IP and DNS and acts as an Internet proxy server. The proxy appliance will be deployed with the following settings:

- The proxy appliance will be deployed on the `esx07.tech.local` ESXi host.
- Veeam Backup & Replication will keep redo logs for verified VMs on the vPower NFS server.
- VMs from the isolated network will use the `172.17.1.2` IP address to access the Internet.
- VMs from isolated network will use this the `8085` port number to access the Internet.

```
$ESXi = Get-VBRServer -Name "esx07.tech.local"
New-VBRViVirtualLabProxyAppliance -Server $ESXi -ObtainIPAutomatically -ObtainDNSAutomatically -HTTPPort 8085 -ProductionProxyIPAddress 172.17.1.2 -EnableInternetProxy
```

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 `New-VBRViVirtualLabProxyAppliance` cmdlet. Specify the following settings:

   - Set the `$ESXi` variable as the `Server` parameter value.
   - Provide the `ObtainIPAutomatically` parameter.
   - Provide the `ObtainDNSAutomatically` parameter.
   - Specify the `HTTPPort` parameter value.
   - Specify the `ProductionProxyIPAddress` parameter value.
   - Provide the `EnableInternetProxy` parameter.

:::

::: example
### Example 3. Defining Settings of Proxy Appliance with Manual IP and DNS Setup

This example shows how to define settings of the `Proxy_appliance_07` proxy appliance that is deployed with manual IP and DNS setup. The proxy appliance will be deployed with the following settings:

- The proxy appliance will be deployed on the `esx07.tech.local` ESXi host.
- The proxy appliance will use the `172.17.53.162` IP to connect to the production network.
- The proxy appliance is assigned the `255.255.0.0` subnet mask.
- The default gateway is assigned the `172.17.53.168` IP.
- The IP of the preferred DNS server is set to `172.17.53.175`.
- The IP of the alternate DNS server is set to `172.17.53.176`.

```
$ESXi = Get-VBRServer -Name "esx07.tech.local"
New-VBRViVirtualLabProxyAppliance -Server $ESXi -Name "Proxy_appliance_07" -IPAddress 172.17.53.162 -SubnetMask 255.255.0.0 -DefaultGateway 172.17.53.168 -PreferredDNSServer 172.17.53.175 -AlternateDNSServer 172.17.53.176
```

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 `New-VBRViVirtualLabProxyAppliance` cmdlet. Specify the following settings:

   - Set the `$ESXi` variable as the `Server` parameter value.
   - Specify the `Name` parameter value.
   - Specify the `IPAddress` parameter value.
   - Specify the `SubnetMask` parameter value.
   - Specify the `DefaultGateway` parameter value.
   - Specify the `PreferredDNSServer` parameter value.
   - Specify the `AlternateDNSServer` parameter value.

:::

## Related Commands

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