---
title: "Add-VBRAzureRestoreProxy"
description: "This cmdlet creates a Windows-based proxy appliance. You can use this proxy appliance to restore Windows-based and Linux-based workloads to Microsoft Azure."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrazurerestoreproxy.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Data Recovery > Restore to Microsoft Azure > Add-VBRAzureRestoreProxy"
dateModified: "2026-08-20"
---

# Add-VBRAzureRestoreProxy

## Short Description
Creates a proxy appliance used for restoring workloads to Microsoft Azure.

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

## Syntax
```
Add-VBRAzureRestoreProxy -Name <String> -Description <String> -MaxConcurrentTasks <Int32> -CredentialsId <Guid>
 -TrafficPort <Int32> -Subscription <VBRAzureSubscription> -Location <VBRAzureLocation>
 -VmSize <VBRAzureVMSize> -StorageAccount <VBRAzureStorageAccount> -ResourceGroup <VBRAzureResourceGroup>
 -DnsNameLabel <String> -VirtualNetwork <VBRAzureVirtualNetwork> -VirtualSubnet <VBRAzureNetworkSubnet>
 [-NetworkSecurityGroup <VBRNetworkSecurityGroup>] [-SkipNetworkSecurityGroup] [-Wait] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates a Windows-based proxy appliance. You can use this proxy appliance to restore Windows-based and Linux-based workloads to Microsoft Azure.

::: note

When you specify a name of a restore proxy appliance, consider the following requirements:

- The name must not be longer than 15 characters.
- The name must contain only alphanumeric characters and hyphens.
- The name must start with a letter and end with a letter or number.
- The name must not contain only numeric characters.
- The name must not contain special characters: `*!@#$%^&*()+=_[]{}\\;:.'",<>/?.*

:::

## 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">CredentialsId</span></p>
        </td>
        <td>
          <p>Specifies credentials of a user that will be assigned the Local Administrator permissions on the restore proxy appliance.</p><p><strong>Note</strong>:</p><ul><li>You cannot use reserved names such as <code>administrator</code>, <code>admin</code>, <code>user</code>, <code>abc@123</code>, <code>P@$$w0rd</code> and so on as a user name and password of the local administrator account.</li><li>You must specify the user name without a domain or Microsoft Azure machine name.</li><li>The password must be at least 8 characters long, and must contain at least 1 uppercase character, 1 lowercase character, 1 numeric character and 1 special character.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>Guid</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">Description</span></p>
        </td>
        <td>
          <p>Specifies a description for the restore proxy appliance.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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">DnsNameLabel</span></p>
        </td>
        <td>
          <p>Specifies a DNS name label for the public IP that will be created.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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">Location</span></p>
        </td>
        <td>
          <p>Specifies the geographic region to which you want to place the restore proxy appliance.</p><p>Accepts the <a href="vbrazurelocation.md"><code>VBRAzureLocation</code></a> object. To get this object, run the <a href="get-vbrazurelocation.md"><code>Get-VBRAzureLocation</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrazurelocation.md"><code>VBRAzureLocation</code></a></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">MaxConcurrentTasks</span></p>
        </td>
        <td>
          <p>Specifies a number of concurrent tasks that the Azure restore proxy appliance must handle in parallel.</p><p>Recommended value: 4 tasks.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</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">Name</span></p>
        </td>
        <td>
          <p>Specifies a name for the restore proxy appliance.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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">NetworkSecurityGroup</span></p>
        </td>
        <td>
          <p>Specifies the network security group for the restore proxy appliance. If you do not specify a network security group, Veeam Backup & Replication will automatically create a new group, allow RDP and SSH on it and connect network interfaces to it.</p><p>Accepts the <code>VBRNetworkSecurityGroup</code> object. To get this object, run the <a href="get-vbrazurenetworksecuritygroup.md"><code>Get-VBRAzureNetworkSecurityGroup</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRNetworkSecurityGroup</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">ResourceGroup</span></p>
        </td>
        <td>
          <p>Specifies the resource group to which the proxy appliance must be placed.</p><p>Accepts the <a href="vbrazureresourcegroup.md"><code>VBRAzureResourceGroup</code></a> object. To get this object, run the <a href="get-vbrazureresourcegroup.md"><code>Get-VBRAzureResourceGroup</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrazureresourcegroup.md"><code>VBRAzureResourceGroup</code></a></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">SkipNetworkSecurityGroup</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will not assign a network security group to the restore proxy appliance.</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">StorageAccount</span></p>
        </td>
        <td>
          <p>Specifies the storage account you want to use to deploy the restore proxy appliance VM.</p><p>Accepts the <a href="vbrazurestorageaccount.md"><code>VBRAzureStorageAccount</code></a> object. To get this object, run the <a href="get-vbrazurestorageaccount.md"><code>Get-VBRAzureStorageAccount</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrazurestorageaccount.md"><code>VBRAzureStorageAccount</code></a></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">Subscription</span></p>
        </td>
        <td>
          <p>Specifies the Microsoft Azure subscription whose resources you want to use to deploy the restore proxy appliance.</p><p>Accepts the <a href="vbrazuresubscription.md"><code>VBRAzureSubscription</code></a> object. To create this object, run the <a href="get-vbrazuresubscription.md"><code>Get-VBRAzureSubscription</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrazuresubscription.md"><code>VBRAzureSubscription</code></a></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">TrafficPort</span></p>
        </td>
        <td>
          <p>Specifies a port number. The cmdlet will use this port to control components installed on the restore proxy appliance and transport workload disks data to Blob storage.</p><p>Default: 443.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</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">VirtualNetwork</span></p>
        </td>
        <td>
          <p>Specifies a virtual network.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrazurevirtualnetwork.md"><code>VBRAzureVirtualNetwork</code></a></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">VirtualSubnet</span></p>
        </td>
        <td>
          <p>Specifies the virtual network subnet to which you want to connect the restore proxy appliance.</p><p>Accepts the <a href="vbrazurenetworksubnet.md"><code>VBRAzureNetworkSubnet</code></a> object. To create this object, run the <a href="get-vbrazurevirtualnetworksubnet.md"><code>Get-VBRAzureVirtualNetworkSubnet</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrazurenetworksubnet.md"><code>VBRAzureNetworkSubnet</code></a></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">VmSize</span></p>
        </td>
        <td>
          <p>Specifies the size for the proxy appliance VM.</p><p>Accepts the <code>VBRAzureVMSize</code> object. To create this object, run the <a href="get-vbrazurevmsize.md"><code>Get-VBRAzureVMSize</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrazurevmsize.md"><code>VBRAzureVMSize</code></a></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">Wait</span></p>
        </td>
        <td>
          <p>Defines that the command waits for the process to complete before accepting more input.</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>
    </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
[`VBRAzureRestoreProxy`](vbrazurerestoreproxy.md)

## Examples

::: example
### Creating Microsoft Azure Restore Proxy Appliance

This example shows how to create a restore proxy appliance for restoring backups to Microsoft Azure VMs

```
$account = Get-VBRAzureAccount -Name "azcomputeaccount"
$subscription = Get-VBRAzureSubscription -Account $account -Name "ContosoProd"
$location = Get-VBRAzureLocation -Subscription $subscription -Name "westeurope"
$rg = Get-VBRAzureResourceGroup -Subscription $subscription -Name "azprx01-rg"
$storage = Get-VBRAzureStorageAccount -Subscription $subscription -Name "veeamstorage01"
$vnet = Get-VBRAzureVirtualNetwork -Subscription $subscription -Name "veeamvnet"
$subnet = Get-VBRAzureVirtualNetworkSubnet -Network $vnet -Name "default"
$vmSize = Get-VBRAzureVMSize -Subscription $subscription -Location $location -Name "Standard_F4s_v2"
$creds = Add-VBRCredentials -Type "Windows" -User "veeamadmin" -Password "P@ssw0rd!"
Add-VBRAzureRestoreProxy -Name "azprx01" -Description "Azure restore proxy appliance" -MaxConcurrentTasks 4 -CredentialsId $creds.Id -TrafficPort 443 -Subscription $subscription -Location $location -VmSize $vmSize -StorageAccount $storage -ResourceGroup $rg -DnsNameLabel "azprx01" -VirtualNetwork $vnet -VirtualSubnet $subnet -Wait
```

Perform the following steps:

1. Run the [`Get-VBRAzureAccount`](get-vbrazureaccount.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$account` variable.
2. Run the [`Get-VBRAzureSubscription`](get-vbrazuresubscription.md) cmdlet. Specify the `Account` and `Name` parameters value. Save the result to the `$subscription` variable.
3. Run the [`Get-VBRAzureLocation`](get-vbrazurelocation.md) cmdlet. Specify the `Subscription` and `Name` parameters values. Save the result to the `$location` variable.
4. Run the [`Get-VBRAzureResourceGroup`](get-vbrazureresourcegroup.md) cmdlet. Specify the `Subscription` and `Name` parameters values. Save the result to the `$rg` variable.
5. Run the [`Get-VBRAzureStorageAccount`](get-vbrazurestorageaccount.md) cmdlet. Specify the `ResourceGroup` and `Name` parameters values. Save the result to the `$storage` variable.
6. Run the [`Get-VBRAzureVirtualNetwork`](get-vbrazurevirtualnetwork.md) cmdlet. Specify the `ResourceGroup` and `Name` parameters values. Save the result to the `$vnet` variable.
7. Run the [`Get-VBRAzureNetworkSubnet`](get-vbrazureresourcegroup.md) cmdlet. Specify the `VirtualNetwork` and `Name` parameters values. Save the result to the `$subnet` variable.
8. Run the [`Get-VBRAzureVMSize`](get-vbrazurevmsize.md) cmdlet. Specify the `Subscription`, `Location` and `Name` parameters values. Save the result to the `$vmSize` variable.
9. Run the [`Add-VBRCredentials`](add-vbrcredentials.md) cmdlet. Specify the `Type`, `User`, and `Password` parameter values. Save the result to the `$cred` variable.
10. Run the `Add-VBRAzureRestoreProxy` cmdlet. Specify the following settings:

    - Specify the `Name` parameter value.
    - Specify the `Description` parameter value.
    - Specify the `MaxConcurrentTasks` parameter value.
    - Set the `$creds.Id` as the `CredentialsId` parameter value.
    - Specify the `TrafficPort` parameter value.
    - Set the `$subscription` as the `Subscription` parameter value.
    - Set the `$location` as the `Location` parameter value.
    - Set the `$vmSize` as the `VmSize` parameter value.
    - Set the `$storage` as the `StorageAccount` parameter value.
    - Set the `$rg` as the `ResourceGroup` parameter value.
    - Specify the `DnsNameLabel` parameter value.
    - Set the `$vnet` as the `VirtualNetwork` parameter value.
    - Set the `$subnet` as the `VirtualSubnet` parameter value.
    - Provide the `Wait` parameter.

:::

## Related Commands

- [`Get-VBRAzureSubscription`](get-vbrazuresubscription.md)
- [`Get-VBRAzureLocation`](get-vbrazurelocation.md)
- [`Get-VBRAzureResourceGroup`](get-vbrazureresourcegroup.md)
- [`Get-VBRAzureStorageAccount`](get-vbrazurestorageaccount.md)
- [`Get-VBRAzureVirtualNetwork`](get-vbrazurevirtualnetwork.md)
- [`Get-VBRAzureVMSize`](get-vbrazurevmsize.md)