---
title: "Start-VBRVMRestoreToAmazon"
description: "Starts a restore session of workloads to Amazon EC2 service. Platform: VMware, Hyper-V Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet starts a restore session of workloads to Amazon EC2 service."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrvmrestoretoamazon.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Data Recovery > Restore to Amazon EC2 > Start-VBRVMRestoreToAmazon"
dateModified: "2026-08-19"
---

# Start-VBRVMRestoreToAmazon

## Short Description
Starts a restore session of workloads to Amazon EC2 service.

**Platform**: VMware, Hyper-V

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

## Syntax
```
Start-VBRVMRestoreToAmazon -RestorePoint <COib> [-Region <VBRAmazonEC2Region>]
 -LicenseType <VBRAmazonEC2LicenseType> -InstanceType <VBRAmazonEC2InstanceType> -VMName <String>
 [-DiskConfiguration <VBRAmazonEC2DiskConfiguration[]>] [-VPC <VBRAmazonEC2VPC>] -Subnet <VBRAmazonEC2Subnet>
 -SecurityGroup <VBRAmazonEC2SecurityGroup> [-Reason <String>] [-EnableAntivirusScan] [-EnableYARAScan]
 [-YARAScanRule <String>] [-EnableEntireVolumeScan] [-VirusDetectionAction <VBRAmazonEC2VirusDetectionAction>]
 [-VirusIsolatedSecurityGroup <VBRAmazonEC2SecurityGroup>] [-ProxyAppliance <VBRAmazonEC2ProxyAppliance>]
 [-Credentials <CCredentials>] [-Wait] [-AmazonEC2Tag <VBRAmazonEC2Tag[]>] [-AllocatePublicIP]
 [-PrivateIpAddress <VBRAmazonIpAddress>] [-ShutdownVM] [<CommonParameters>]
```

## Detailed Description
This cmdlet starts a restore session of workloads to Amazon EC2 service.

::: note

To stop a restore session, run the [Stop-VBRVMRestoreToAmazon](stop-vbrvmrestoretoamazon.md) cmdlet.

:::

## 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">AllocatePublicIP</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet assigns a public IP to the restored VM.</p><p>If you do not provide this parameter, the restored VM remains without the public IP.</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">AmazonEC2Tag</span></p>
        </td>
        <td>
          <p>Specifies AmazonEC2 tags. The cmdlet will restore VMs with the specified tags.</p><p>Accepts the <code>VBRAmazonEC2Tag[]</code> object. To get this object, run the <a href="new-vbramazonec2tag.md"><code>New-VBRAmazonEC2Tag</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRAmazonEC2Tag[]</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">Credentials</span></p>
        </td>
        <td>
          <p>For restoring backups located on a network shared folder.</p><p>Specifies the credentials to authenticate with the network shared folder.</p>
        </td>
        <td style="width:10%;">
          <p><code>CCredentials</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">DiskConfiguration</span></p>
        </td>
        <td>
          <p>Specifies the array of storage volume settings for Amazon EC2 instances.</p><p>If you do not specify this parameter, the cmdlet will restore all disks as General Purpose SSD (GP2).</p><p>Accepts the <code>VBRAmazonEC2DiskConfiguration[]</code> object. To get this object, run the <a href="new-vbramazonec2diskconfiguration.md"><code>New-VBRAmazonEC2DiskConfiguration</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRAmazonEC2DiskConfiguration[]</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">EnableAntivirusScan</span></p>
        </td>
        <td>
          <p>Enables the secure restore option. Veeam Backup & Replication will trigger the antivirus software to scan selected machines before the restore.</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">EnableEntireVolumeScan</span></p>
        </td>
        <td>
          <p>For secure restore.</p><p>Enables the option for the antivirus to continue VMs scan after the first virus threat is found. Use this option if you want to get the report on all virus threats.</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">EnableYARAScan</span></p>
        </td>
        <td>
          <p>Enables the YARA scan for the selected VMs.</p><p>Use the <code>YARAScanRule</code> parameter to specify the YARA rule to be used.</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">InstanceType</span></p>
        </td>
        <td>
          <p>Specifies the Amazon EC2 instance type. The cmdlet will restore the VM with the CPU and memory settings of the selected instance.</p><p>Accepts the <code>VBRAmazonEC2InstanceType</code> object. To get this object, run the <a href="get-vbramazonec2instancetype.md"><code>Get-VBRAmazonEC2InstanceType</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbramazonec2instancetype.md"><code>VBRAmazonEC2InstanceType</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">LicenseType</span></p>
        </td>
        <td>
          <p>Specifies the OS license. You can select the following types of licenses:</p><ul><li><code>BYOL</code> — use this option if you want to use your existing licenses for Microsoft software.</li><li><code>ProvidedByAWS</code> — use this option if you want Amazon EC2 to update the license on the restored VM.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRAmazonEC2LicenseType</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">PrivateIpAddress</span></p>
        </td>
        <td>
          <p>Specifies the dynamic or static private IP address that will be assigned to the restored workload.</p><p>Accepts the <code>VBRAmazonIpAddress</code> object. To create this object, run the <a href="new-vbramazonipaddress.md"><code>New-VBRAmazonIpAddress</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbramazonipaddress.md"><code>VBRAmazonIpAddress</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">ProxyAppliance</span></p>
        </td>
        <td>
          <p>Specifies the AmazonEC2 proxy appliance.</p><p>Accepts the <code>VBRAmazonEC2ProxyAppliance</code> object. To get this object, run the <a href="new-vbramazonec2proxyappliance.md"><code>New-VBRAmazonEC2ProxyAppliance</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbramazonec2proxyappliance.md"><code>VBRAmazonEC2ProxyAppliance</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">Reason</span></p>
        </td>
        <td>
          <p>Specifies the restore reason.</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">Region</span></p>
        </td>
        <td>
          <p>Specifies the Amazon EC2 region. The cmdlet will restore the VM to this Amazon EC2 region.</p><p>Accepts the <a href="vbramazonec2region.md"><code>VBRAmazonEC2Region</code></a> object. To get this object, run the <a href="get-vbramazonec2region.md"><code>Get-VBRAmazonEC2Region</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbramazonec2region.md"><code>VBRAmazonEC2Region</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">RestorePoint</span></p>
        </td>
        <td>
          <p>Specifies the restore point of workloads that you want to restore to Amazon EC2.</p><p>Accepts the <code>COib</code> object. To get this object, run the <a href="get-vbrrestorepoint.md"><code>Get-VBRRestorePoint</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>COib</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">SecurityGroup</span></p>
        </td>
        <td>
          <p>Specifies the Amazon VPC security group.</p><p>Accepts the <code>VBRAmazonEC2SecurityGroup</code> object. To get this object, run the <a href="get-vbramazonec2securitygroup.md"><code>Get-VBRAmazonEC2SecurityGroup</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbramazonec2securitygroup.md"><code>VBRAmazonEC2SecurityGroup</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">ShutdownVM</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet powers off the restored VM after the restore is complete.</p><p>If you do not provide this parameter, the restored VM remains powered on.</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">Subnet</span></p>
        </td>
        <td>
          <p>Specifies the Amazon VPC subnet.</p><p>Accepts the <code>VBRAmazonEC2Subnet</code> object. To get this object, run the <a href="get-vbramazonec2subnet.md"><code>Get-VBRAmazonEC2Subnet</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbramazonec2subnet.md"><code>VBRAmazonEC2Subnet</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">VirusDetectionAction</span></p>
        </td>
        <td>
          <p>For secure restore.</p><p>Specifies the secure restore action when the virus threat is detected.</p><ul><li><code>ConnectToIsolatedSecurityGroup</code> — use this option to restore the machine to a different AWS security group. Use the <code>VirusIsolatedSecurityGroup</code> parameter to specify the security group.</li><li><code>AbortRecovery</code> — use this option to cancel the restore session.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRAmazonEC2VirusDetectionAction</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">VirusIsolatedSecurityGroup</span></p>
        </td>
        <td>
          <p>For secure restore.</p><p>Specifies the AmazonEC2 security group. Veeam Backup & Replication will restore the infected the machine to the selected security group.</p><p>Accepts the <code>VBRAmazonEC2SecurityGroup</code> object.  To get this object, run the <a href="get-vbramazonec2securitygroup.md"><code>Get-VBRAmazonEC2SecurityGroup</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbramazonec2securitygroup.md"><code>VBRAmazonEC2SecurityGroup</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">VMName</span></p>
        </td>
        <td>
          <p>Specifies the name for the target EC2 instance. Veeam Backup & Replication will restore the instance with this name.</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">VPC</span></p>
        </td>
        <td>
          <p>Specifies the Amazon VPC.</p><p>Accepts the <code>VBRAmazonEC2VPC</code> object. To get this object, run the <a href="get-vbramazonec2vpc.md"><code>Get-VBRAmazonEC2VPC</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbramazonec2vpc.md"><code>VBRAmazonEC2VPC</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">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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">YARAScanRule</span></p>
        </td>
        <td>
          <p>Specifies the YARA rule. Veeam Backup & Replication will scan VMs with this rule.</p><p>Veeam Backup & Replication searches for YARA rules in the <code>YaraRules</code> folder. The default path is: <code>C:\Program Files\Veeam\Backup and Replication\Backup\YaraRules</code>.</p><p>To use a YARA rule, you must specify its name and extension. Veeam Backup & Replication accepts only <code>.yar</code> and <code>.yara</code> extensions.</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 `VBRVMRestoreToAmazon` object that contains settings of a restore session to Amazon EC2 service.

## Examples

::: example
### Example 1. Restoring Workloads to Amazon EC2

This example shows how to restore workloads to Amazon EC2.

```
$backup = Get-VBRBackup -Name "MSExchange"
$restorepoint = Get-VBRRestorePoint -Name *MSExchange02* -Backup $backup
$account = Get-VBRAmazonAccount -Id "936edf7c-7cf3-4dbd-9895-c7485ef4bb2c"
$region = Get-VBRAmazonEC2Region -Account $account -RegionType Global -Name "ap-northeast-1"
$config = New-VBRAmazonEC2DiskConfiguration -DiskName "Virtual Disk" -Include -DiskType GeneralPurposeSSD
$instance = Get-VBRAmazonEC2InstanceType -Region $region
$vpc = Get-VBRAmazonEC2VPC -Region $region
$sgroup = Get-VBRAmazonEC2SecurityGroup -VPC $vpc
$subnet = Get-VBRAmazonEC2Subnet -VPC $vpc -AvailabilityZone "eu-west-1a"
Start-VBRVMRestoreToAmazon -RestorePoint $restorepoint -Region $region -LicenseType ProvidedByAWS -InstanceType $instance -VMName "Restored VM" -DiskConfiguration $config -VPC $vpc -SecurityGroup $sgroup -Subnet $subnet -Reason "Data recovery"
```

Perform the following steps:

1. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
2. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Specify the `Name` parameter value. Set the `$backup` variable as the `Backup` parameter value. Save the result to the `$restorepoint` variable.
3. Run the [`Get-VBRAmazonAccount`](get-vbramazonaccount.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$account` variable.
4. Run the [`Get-VBRAmazonEC2Region`](get-vbramazonec2region.md) cmdlet. Set the `$account` variable as the `Account` parameter value. Set the `Global` value as the `RegionType` parameter value. Specify the `Name` parameter value. Save the result to the `$region` variable.
5. Run the [`New-VBRAmazonEC2DiskConfiguration`](new-vbramazonec2diskconfiguration.md) cmdlet. Specify the `DiskName` parameter value. Provide the `Include` parameter. Set the `GeneralPurposeSSD` value as the `DiskType` parameter value. Save the result to the `$config` variable.
6. Run the [`Get-VBRAmazonEC2InstanceType`](get-vbramazonec2instancetype.md) cmdlet. Set the `$region` variable as the `Region` parameter value. Save the result to the `$instance` variable.
7. Run the [`Get-VBRAmazonEC2VPC`](get-vbramazonec2vpc.md) cmdlet. Set the `$region` variable as the `Region` parameter value. Save the result to the `$vpc` variable.
8. Run the [`Get-VBRAmazonEC2SecurityGroup`](get-vbramazonec2securitygroup.md) cmdlet. Set the `$vpc` variable as the `VPC` parameter value. Save the result to the `$sgroup` variable.
9. Run the [`Get-VBRAmazonEC2Subnet`](get-vbramazonec2subnet.md) cmdlet. Set the `$vpc` variable as the `VPC` parameter value. Specify the `AvailabilityZone` parameter value. Save the result to the `$subnet` variable.
10. Run the `Start-VBRVMRestoreToAmazon` cmdlet. Specify the following settings:

    - Set the `$restorepoint` variable as the `RestorePoint` parameter value.
    - Set the `$region` variable as the `Region` parameter value.
    - Set the `ProvidedByAWS` value as the `LicenseType` parameter value.
    - Set the `$instance` variable as the `InstanceType` parameter value.
    - Specify the `VMName` parameter value.
    - Set the `$config` variable as the `DiskConfiguration` parameter value.
    - Set the `$vpc` variable as the `VPC` parameter value.
    - Set the `$sgroup` variable as the `SecurityGroup` parameter value.
    - Set the `$subnet` variable as the `Subnet` parameter value.
    - Specify the `Reason` parameter value.

:::

::: example
### Example 2. Restoring Workloads to Amazon EC2 using Proxy Appliance

This example shows how to restore workloads to Amazon EC2 with AmazonEC2 proxy appliance.

```
$backup = Get-VBRBackup -Name "MSExchange"
$restorepoint = Get-VBRRestorePoint -Name *MSExchange02* -Backup $backup
$account = Get-VBRAmazonAccount -Id "936edf7c-7cf3-4dbd-9895-c7485ef4bb2c"
$region = Get-VBRAmazonEC2Region -Account $account -RegionType Global -Name "ap-northeast-1"
$config = New-VBRAmazonEC2DiskConfiguration -DiskName "Virtual Disk" -Include -DiskType GeneralPurposeSSD
$instance = Get-VBRAmazonEC2InstanceType -Region $region
$vpc = Get-VBRAmazonEC2VPC -Region $region
$sgroup = Get-VBRAmazonEC2SecurityGroup -VPC $vpc
$subnet = Get-VBRAmazonEC2Subnet -VPC $vpc -AvailabilityZone eu-west-1a
$proxy = New-VBRAmazonEC2ProxyAppliance -InstanceType $instance -Subnet $subnet -SecurityGroup $sgroup -RedirectorPort 443
Start-VBRVMRestoreToAmazon -RestorePoint $restorepoint -Region $region -LicenseType ProvidedByAWS -InstanceType $instance -VMName "Restored VM" -DiskConfiguration $config -VPC $vpc -SecurityGroup $sgroup -Subnet $subnet -ProxyAppliance $proxy -Reason "Data recovery"
```

Perform the following steps:

1. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
2. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Specify the `Name` parameter value. Set the `$backup` variable as the `Backup` parameter value. Save the result to the `$restorepoint` variable.
3. Run the [`Get-VBRAmazonAccount`](get-vbramazonaccount.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$account` variable.
4. Run the [`Get-VBRAmazonEC2Region`](get-vbramazonec2region.md) cmdlet. Set the `$account` variable as the `Account` parameter value. Set the `Global` value as the `RegionType` parameter value. Specify the `Name` parameter value. Save the result to the `$region` variable.
5. Run the [`New-VBRAmazonEC2DiskConfiguration`](new-vbramazonec2diskconfiguration.md) cmdlet. Specify the `DiskName` parameter value. Provide the `Include` parameter. Set the `GeneralPurposeSSD` value as the `DiskType` parameter value. Save the result to the `$config` variable.
6. Run the [`Get-VBRAmazonEC2InstanceType`](get-vbramazonec2instancetype.md) cmdlet. Set the `$region` variable as the `Region` parameter value. Save the result to the `$instance` variable.
7. Run the [`Get-VBRAmazonEC2VPC`](get-vbramazonec2vpc.md) cmdlet. Set the `$region` variable as the `Region` parameter value. Save the result to the `$vpc` variable.
8. Run the [`Get-VBRAmazonEC2SecurityGroup`](get-vbramazonec2securitygroup.md) cmdlet. Set the `$vpc` variable as the `VPC` parameter value. Save the result to the `$sgroup` variable.
9. Run the [`Get-VBRAmazonEC2Subnet`](get-vbramazonec2subnet.md) cmdlet. Set the `$vpc` variable as the `VPC` parameter value. Specify the `AvailabilityZone` parameter value. Save the result to the `$subnet` variable.
10. Run the [`New-VBRAmazonEC2ProxyAppliance`](new-vbramazonec2proxyappliance.md) cmdlet. Set the `$instance` variable as the `InstanceType` parameter value. Set the `$subnet` variable as the `Subnet` parameter value. Set the `$sgroup` variable as the `SecurityGroup` parameter value. Specify the `RedirectorPort` parameter value. Save the result to the `$proxy` variable. 
11. Run the `Start-VBRVMRestoreToAmazon` cmdlet. Specify the following settings:

    - Set the `$restorepoint` variable as the `RestorePoint` parameter value.
    - Set the `$region` variable as the `Region` parameter value.
    - Set the `ProvidedByAWS` value as the `LicenseType` parameter value.
    - Set the `$instance` variable as the `InstanceType` parameter value.
    - Specify the `VMName` parameter value.
    - Set the `$config` variable as the `DiskConfiguration` parameter value.
    - Set the `$vpc` variable as the `VPC` parameter value.
    - Set the `$sgroup` variable as the `SecurityGroup` parameter value.
    - Set the `$subnet` variable as the `Subnet` parameter value.
    - Set the `$proxy` variable as the `ProxyAppliance` parameter value.
    - Specify the `Reason` parameter value.

:::

::: example
### Example 3. Restoring Backups Created by Veeam Agent for Microsoft Windows to Amazon EC2

This example shows how to restore backups of computers created by Veeam Agent for Microsoft Windows to Amazon EC2.

```
$winbackup = Get-VBRBackup -Name "WinBackup*"
$restorepoint = Get-VBRRestorePoint -Backup $winbackup
$disk = Get-VBRComputerDisk -RestorePoint $restorepoint[1]
$account = Get-VBRAmazonAccount -Id '6c4746ba-5422-4649-ac20-5d29939eda1a'
$region = Get-VBRAmazonEC2Region -Account $account -RegionType Global -Name 'eu-west-2'
$instance = Get-VBRAmazonEC2InstanceType -Region $region -Name 'c4.large'
$config = New-VBRAmazonEC2DiskConfiguration -DiskName $disk.UniqueId -DiskType GeneralPurposeSSD -Include
$vpc = Get-VBRAmazonEC2VPC -Region $region
$subnet = Get-VBRAmazonEC2Subnet -VPC $vpc[0]
$sgroup = Get-VBRAmazonEC2SecurityGroup -VPC $vpc[0]
Start-VBRVMRestoreToAmazon -RestorePoint $restorepoint[1] -Region $region -LicenseType ProvidedByAWS -InstanceType $instance -VMName 'agent-restored' -DiskConfiguration $config -VPC $vpc -Subnet $subnet[0] -SecurityGroup $sgroup -Reason 'test'
```

Perform the following steps:

1. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$winbackup` variable.
2. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Set the `$winbackup` variable as the `Backup` parameter value. Save the result to the `$restorepoint` variable.
3. Run the [`Get-VBRComputerDisk`](get-vbrcomputerdisk.md) cmdlet. Set the `$restorepoint` variable as the `RestorePoint` parameter value. Save the result to the `$disk` variable.

   The `Get-VBRRestorePoint` cmdlet will return an array of restore points. Consider that the array numbering starts with 0. In our example, the second restore point is used.

4. Run the [`Get-VBRAmazonAccount`](get-vbramazonaccount.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$account` variable.
5. Run the [`Get-VBRAmazonEC2Region`](get-vbramazonec2region.md) cmdlet. Set the `$account` variable as the `Account` parameter value. Set the `Global` value as the `RegionType` parameter value. Specify the `Name` parameter value. Save the result to the `$region` variable.
6. Run the [`Get-VBRAmazonEC2InstanceType`](get-vbramazonec2instancetype.md) cmdlet. Set the `$region` variable as the `Region` parameter value. Save the result to the `$instance` variable.
7. Run the [`New-VBRAmazonEC2DiskConfiguration`](new-vbramazonec2diskconfiguration.md) cmdlet. Set the `UniqueId` parameter of the `$disk` variable as the `DiskName` parameter value. Set the `GeneralPurposeSSD` value as the `DiskType` parameter value. Provide the `Include` parameter. Save the result to the `$config` variable.
8. Run the [`Get-VBRAmazonEC2VPC`](get-vbramazonec2vpc.md) cmdlet. Set the `$region` variable as the `Region` parameter value. Save the result to the `$vpc` variable.

   The `Get-VBRAmazonEC2VPC` cmdlet will return an array of VPCs. Consider that the array numbering starts with 0. In our example, the first VPC will be used.

9. Run the [`Get-VBRAmazonEC2Subnet`](get-vbramazonec2subnet.md) cmdlet. Set the `$vpc` variable as the `VPC` parameter value. Save the result to the `$subnet` variable.
10. Run the [`Get-VBRAmazonEC2SecurityGroup`](get-vbramazonec2securitygroup.md) cmdlet. Set the `$vpc` variable as the `VPC` parameter value. Save the result to the `$sgroup` variable.
11. Run the `Start-VBRVMRestoreToAmazon` cmdlet. Specify the following settings:

    - Set the `$restorepoint` variable as the `RestorePoint` parameter value.
    - Set the `$region` variable as the `Region` parameter value.
    - Set the `ProvidedByAWS` value as the `LicenseType` parameter value.
    - Set the `$instance` variable as the `InstanceType` parameter value.
    - Specify the `VMName` parameter value.
    - Set the `$config` variable as the `DiskConfiguration` parameter value.
    - Set the `$vpc` variable as the `VPC` parameter value.
    - Set the `$sgroup` variable as the `SecurityGroup` parameter value.
    - Set the `$subnet` variable as the `Subnet` parameter value.
    - Set the `$sgroup` variable as the `SecurityGroup` parameter value.
    - Specify the `Reason` parameter value.

:::

## Related Commands

- [`Get-VBRAmazonAccount`](get-vbramazonaccount.md)
- [`Get-VBRAmazonEC2Region`](get-vbramazonec2region.md)
- [`New-VBRAmazonEC2DiskConfiguration`](new-vbramazonec2diskconfiguration.md)
- [`Get-VBRAmazonEC2InstanceType`](get-vbramazonec2instancetype.md)
- [`Get-VBRAmazonEC2VPC`](get-vbramazonec2vpc.md)
- [`Get-VBRAmazonEC2SecurityGroup`](get-vbramazonec2securitygroup.md)
- [`Get-VBRAmazonEC2Subnet`](get-vbramazonec2subnet.md)
- [`New-VBRAmazonEC2ProxyAppliance`](new-vbramazonec2proxyappliance.md)