---
title: "Deploy-VBRAzureLinuxRestoreAppliance"
description: "Deploys or removes helper appliances for restoring Linux VMs to Microsoft Azure. Platform: VMware, Hyper-V Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet "
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/deploy-vbrazurelinuxrestoreappliance.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Data Recovery > Restore to Microsoft Azure > Deploy-VBRAzureLinuxRestoreAppliance"
dateModified: "2026-08-19"
---

# Deploy-VBRAzureLinuxRestoreAppliance

## Short Description
Deploys or removes helper appliances for restoring Linux VMs to Microsoft Azure.

**Platform**: VMware, Hyper-V

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>Remove</code></p>

```
Deploy-VBRAzureLinuxRestoreAppliance -Account <VBRAzureAccount> [-RemoveAll] [-Wait] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Appliance</code></p>

```
Deploy-VBRAzureLinuxRestoreAppliance -Account <VBRAzureAccount> -Appliance <VBRAzureLinuxRestoreAppliance[]>
 [-Wait] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet deploys or removes helper appliances for restoring Linux VMs to Microsoft Azure. The cmdlet offers the following possibilities:

- To remove all helper appliances associated with an account, run the 1st parameter set.
- To remove selected helper appliances, run the 2nd parameter set and enumerate only those helper appliances that must remain. 
- To deploy a new helper appliance or a number of new helper appliances, run the 2nd parameter set and pass an array of helper appliances you want to deploy. Note that if there are any existing helper appliances already deployed for this account that you want to keep, you must include them in the array.
- To modify settings of an existing helper appliance or helper appliances, run the 2nd parameter set and pass an array of existing helper appliances with different settings.

Run the [`Get-VBRAzureApplicanceSession`](get-vbrazureappliancesession.md) cmdlet to get the status of sessions initiated by this cmdlet.

::: important

Consider the following:

- This cmdlet does not support Microsoft Azure accounts with the Azure Service Manager type of a subscription (ASM, also known as a "classic" type subscription).
- This cmdlet always deploys the helper appliances anew. The array of helper appliances that you pass to this cmdlet must contain all helper appliances that you want to be associated with the account.
- If there are existing helper appliances associated with this account, but which you do not include in the array you pass, the cmdlet will remove them.
- If there are existing helper appliances associated with this account, and you pass them with different settings, the cmdlet will re-deploy them with the new settings.

:::

## 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">Account</span></p>
        </td>
        <td>
          <p>Specifies the account.</p><p>For removing helper appliances: the cmdlet will remove all helper appliances connected to this account.</p><p>For deploying helper appliances: the cmdlet will deploy helper appliances for this account.</p><p>Accepts the <a href="vbrazureaccount.md"><code>VBRAzureAccount</code></a> object. To get this object, run the<a href="get-vbrazureaccount.md"><code> Get-VBRAzureAccount</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrazureaccount.md"><code>VBRAzureAccount</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>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Appliance</span></p>
        </td>
        <td>
          <p>Specifies the array of helper appliances you want to deploy.</p><p>Accepts the <a href="vbrazurelinuxrestoreappliance.md"><code>VBRAzureLinuxRestoreAppliance</code></a><code>[]</code> object. To get this object, run the <a href="get-vbrazurelinuxrestoreappliance.md"><code>Get-VBRAzureLinuxRestoreAppliance</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrazurelinuxrestoreappliance.md"><code>VBRAzureLinuxRestoreAppliance[]</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>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RemoveAll</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet removes all helper appliances associated with the account.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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">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
[`VBRAzureApplianceSession`](vbrazureappliancesession.md)

## Examples

::: example
### Example 1. Removing All Linux VM Restore Helper Appliances for Microsoft Azure Account

This example shows how to remove all Linux VM restore helper appliances associated with a Microsoft Azure account.

```
$account = Get-VBRAzureAccount -Type ResourceManager -Name "RestoreToAzureRM@Veeam.com"
$appliancesession = Deploy-VBRAzureLinuxRestoreAppliance -Account $account -RemoveAll:$true
```

Perform the following steps:

1. Run the [`Get-VBRAzureAccount`](get-vbrazureaccount.md) cmdlet. Set the `ResourceManager` option for the `Type` parameter. Specify the `Name` parameter value. Save the result to the `$account` variable.
2. Run the `Deploy-VBRAzureLinuxRestoreAppliance` cmdlet. Set the `$account` variable as the `Account` parameter value. Set the `RemoveAll` switch parameter to `$true`. Save the deployment session to the `$appliancesession` variable to check its status.

:::

::: example
### Example 2. Deploying Additional Linux VM Restore Helper Appliance for Microsoft Azure Account

This example shows how to deploy an additional Linux VM restore helper appliance for a Microsoft Azure account.

```
$account = Get-VBRAzureAccount -Type ResourceManager -Name "RestoreToAzureRM@Veeam.com"
$appliances = Get-VBRAzureLinuxRestoreAppliance
$currentappliance = $appliances[0]
$newappliance = $appliances[1]
$appliancesession = Deploy-VBRAzureLinuxRestoreAppliance -Account $account -Appliance $currentappliance, $newappliance
```

Perform the following steps:

1. Run the [`Get-VBRAzureAccount`](get-vbrazureaccount.md) cmdlet. Set the `ResourceManager` value as the `Type` parameter value. Specify the `Name` parameter value. Save the result to the `$account` variable.
2. Run the [`Get-VBRAzureLinuxRestoreAppliance`](get-vbrazurelinuxrestoreappliance.md) cmdlet. Save the array to the `$appliances` variable.
3. From the `$appliances` array, get the Linux helper appliance that is currently used. Save it to the `$currentappliance` variable.
4. From the `$appliances` array, get the new Linux helper appliance. Save it to the `$newappliance` variable.
5. Run the `Deploy-VBRAzureLinuxRestoreAppliance` cmdlet. Specify the following settings:

   - Set the `$account` variable as the `Account` parameter value.
   - Set the `$appliance` and the `$newappliance` variables as the `Appliance` parameter value.
   - Save the deployment session to the `$appliancesession` variable to check its status.

:::

## Related Commands

- [`Get-VBRAzureAccount`](get-vbrazureaccount.md)
- [`Get-VBRAzureLinuxRestoreAppliance`](get-vbrazurelinuxrestoreappliance.md)