Help Center
Choose product document...
Veeam Backup & Replication 9.5
PowerShell Reference

Deploy-VBRAzureLinuxRestoreAppliance

Short Description

Deploys or removes appliances for restoring Linux VMs to Microsoft Azure.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

This cmdlet provides 2 parameter sets.

  • For removing Linux VM restore appliances:

Deploy-VBRAzureLinuxRestoreAppliance -Account <VBRAzureAccount> -RemoveAll [-Wait]  [<CommonParameters>]

  • For deploying Linux VM restore appliances:

Deploy-VBRAzureLinuxRestoreAppliance -Account <VBRAzureAccount> -Appliance <VBRAzureLinuxRestoreAppliance[]> [-Wait]  [<CommonParameters>]

Detailed Description

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

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

Deploy-VBRAzureLinuxRestoreAppliance Important!

This cmdlet always deploys the appliances anew. The array of appliances that you pass to this cmdlet must contain all appliances that you want to be associated with the account.

Mind the following:

  • If there are existing 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 appliances associated with this account, and you pass them with different settings, the cmdlet will re-deploy them with the new settings.

Run Get-VBRAzureApplicanceSession to get the status of sessions initiated by this cmdlet.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Account

Specifies the account.

For removing appliances: the cmdlet will remove all appliances connected to this account.

For deploying appliances: the cmdlet will deploy appliances for this account.

True

Named

True (ByValue,
ByProperty
Name)

False

RemoveAll

Indicates that the cmdlet removes all appliances associated with the account.

True

Named

False

False

Appliance

Specifies the array of appliances you want to deploy.

True

Names

True (ByProperty
Name)

False

Wait

Indicates that the command waits for the process to complete before accepting more input.

False

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Return Type

VBRAzureApplianceSession

Example 1

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

  1. Get the Microsoft Azure account: run Get-VBRAzureAccount and save the result to the $account variable.
  2. Run Deploy-VBRAzureLinuxRestoreAppliance with the $account variable. Use the RemoveAll switch parameter. Save the deployment session to the $appliancesession variable to check its status.

PS C:\PS> $account = Get-VBRAzureAccount -Type ResourceManager -Name "RestoreToAzureRM@Veeam.com"

PS C:\PS> $appliancesession = Deploy-VBRAzureLinuxRestoreAppliance -Account $account -RemoveAll:$true

Example 2

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

  1. Get the Microsoft Azure account: run Get-VBRAzureAccount and save the result to the $account variable.
  2. Get the array of all Linux appliances. Run Get-VBRAzureLinuxRestoreAppliance and save the array to the $appliances variable.
  3. From the $appliances array, get the Linux appliance that is currently used. Save it to the $currentappliance variable.
  4. From the $appliances array, get the new Linux appliance. Save it to the $newappliance variable.
  5. Run Deploy-VBRAzureLinuxRestoreAppliance with the saved variables. Be careful to use both appliances variables. Save the deployment session to the $appliancesession variable to check its status.

PS C:\PS> $account = Get-VBRAzureAccount -Type ResourceManager -Name "RestoreToAzureRM@Veeam.com"

PS C:\PS> $appliances = Get-VBRAzureLinuxRestoreAppliance

PS C:\PS> $currentappliance = $appliances[0]

PS C:\PS> $newappliance = $appliances[1]

PS C:\PS> $appliancesession = Deploy-VBRAzureLinuxRestoreAppliance -Account $account -Appliance $currentappliance, $newappliance

Related Commands

Get-VBRAzureAccount

Get-VBRAzureLinuxRestoreAppliance

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Backup Explorers User Guide

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide

Veeam Backup for Microsoft Office 365

Veeam ONE Documentation

Veeam Agent for Windows Documentation

Veeam Agent for Linux Documentation

Veeam Management Pack Documentation