---
title: "New-VBOAmazonArchiverAppliance"
description: "This cmdlet creates the VBOAmazonArchiverAppliance object. This object contains settings of the Amazon archiver appliance that Veeam Backup for Microsoft 365 will use when transferring backed-up data between different instances of the general..."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/new-vboamazonarchiverappliance.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > Archiver Appliances > New-VBOAmazonArchiverAppliance"
dateModified: "2026-08-21"
---

# New-VBOAmazonArchiverAppliance

## Short Description
Defines the Amazon archiver appliance settings.

## Syntax

This cmdlet provides the following parameter sets:

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

```
New-VBOAmazonArchiverAppliance [-InstanceType <VBOAmazonInstanceType>] [-Port <Int32>] [-VPC <VBOAmazonVpc>]
 [-Subnet <VBOAmazonSubnet>] [-SecurityGroup <VBOAmazonSecurityGroup>] -IpRanges <String[]> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>ProxyParamSet</code></p>

```
New-VBOAmazonArchiverAppliance [-InstanceType <VBOAmazonInstanceType>] [-Port <Int32>] [-VPC <VBOAmazonVpc>]
 [-Subnet <VBOAmazonSubnet>] [-SecurityGroup <VBOAmazonSecurityGroup>] -ProxyIpRange <VBOProxy> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>ProxyPoolParamSet</code></p>

```
New-VBOAmazonArchiverAppliance [-InstanceType <VBOAmazonInstanceType>] [-Port <Int32>] [-VPC <VBOAmazonVpc>]
 [-Subnet <VBOAmazonSubnet>] [-SecurityGroup <VBOAmazonSecurityGroup>] -ProxyPoolIpRange <VBOProxyPool> [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet creates the [`VBOAmazonArchiverAppliance`](vboamazonarchiverappliance.md) object. This object contains settings of the Amazon archiver appliance that Veeam Backup for Microsoft 365 will use when transferring backed-up data between different instances of the general purpose object storage repositories (Amazon S3 Standard, Amazon S3 Standard-Infrequent Access and Amazon S3 One Zone-Infrequent Access storage classes) or to any of Amazon S3 Glacier object storage repositories (Amazon S3 Glacier Instant Retrieval, Amazon S3 Glacier Flexible Retrieval and Amazon S3 Glacier Deep Archive storage classes).

## 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">InstanceType</span></p>
        </td>
        <td>
          <p>Specifies an instance type that the archiver appliance will use.</p><p>For more information on instance types, see <a href="https://aws.amazon.com/ec2/instance-types/">this Amazon article</a>.</p><p>Default: <em>m6i.xlarge (4 CPU/16 GB)</em></p><p>Accepts the <a href="vboamazoninstancetype.md"><code>VBOAmazonInstanceType</code></a> object.</p><p>To get this object, run the <a href="get-vboamazoninstancetype.md"><code>Get-VBOAmazonInstanceType</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboamazoninstancetype.md"><code>VBOAmazonInstanceType</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">IpRanges</span></p>
        </td>
        <td>
          <p>Specifies a range of IPv4 addresses for the specified security group.</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">Port</span></p>
        </td>
        <td>
          <p>Specifies a port number. The cmdlet will use this port number to route requests between the archiver appliance and Veeam Backup for Microsoft 365 backup infrastructure components.</p><p>Default: <em>443</em></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">ProxyIpRange</span></p>
        </td>
        <td>
          <p>Specifies public IPv4 address of a backup proxy server.</p><p>Accepts the <a href="vboproxy.md"><code>VBOProxy</code></a> object.</p><p>To get this object, run the <a href="get-vboproxy.md"><code>Get-VBOProxy</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboproxy.md"><code>VBOProxy</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">ProxyPoolIpRange</span></p>
        </td>
        <td>
          <p>Specifies public IPv4 addresses of all backup proxy servers added to a backup proxy pool.</p><p>Accepts the <a href="vboproxypool.md"><code>VBOProxyPool</code></a> object.</p><p>To get this object, run the <a href="get-vboproxypool.md"><code>Get-VBOProxyPool</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboproxypool.md"><code>VBOProxyPool</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">SecurityGroup</span></p>
        </td>
        <td>
          <p>Specifies a security group that will be associated with the archiver appliance.</p><p>For more information on security groups for Amazon VPC, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html">this Amazon article</a>.</p><p>Default: <em>Create new</em></p><p>This value indicates that a new security group will be created in a region where a bucket with the specified folder is located when you run the <a href="add-vboamazons3objectstoragerepository.md"><code>Add-VBOAmazonS3ObjectStorageRepository</code></a> or <a href="add-vboamazons3glacierrepository.md"><code>Add-VBOAmazonS3GlacierRepository</code></a> or <a href="add-vboamazons3repository.md"><code>Add-VBOAmazonS3Repository</code></a> cmdlet.</p><p>Accepts the <a href="vboamazonsecuritygroup.md"><code>VBOAmazonSecurityGroup</code></a> object.</p><p>To get this object, run the <a href="get-vboamazonsecuritygroup.md"><code>Get-VBOAmazonSecurityGroup</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboamazonsecuritygroup.md"><code>VBOAmazonSecurityGroup</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">Subnet</span></p>
        </td>
        <td>
          <p>Specifies the archiver appliance subnet.</p><p>Default: <em>Create new</em></p><p>This value indicates that a new subnet will be created in a region where a bucket with the specified folder is located when you run the <a href="add-vboamazons3objectstoragerepository.md"><code>Add-VBOAmazonS3ObjectStorageRepository</code></a> or <a href="add-vboamazons3glacierrepository.md"><code>Add-VBOAmazonS3GlacierRepository</code></a> or <a href="add-vboamazons3repository.md"><code>Add-VBOAmazonS3Repository</code></a> cmdlet.</p><p>Accepts the <a href="vboamazonsubnet.md"><code>VBOAmazonSubnet</code></a> object.</p><p>To get this object, run the <a href="get-vboamazonsubnet.md"><code>Get-VBOAmazonSubnet</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboamazonsubnet.md"><code>VBOAmazonSubnet</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">VPC</span></p>
        </td>
        <td>
          <p>Specifies the Amazon Virtual Private Cloud (Amazon VPC). The cmdlet will launch the target EC2 instance on this Amazon VPC.</p><p>For more information on the Amazon VPC, see <a href="https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html">this Amazon article</a>.</p><p>Default: <em>Create new</em></p><p>This value indicates that a new Amazon VPC will be created in a region where a bucket with the specified folder is located when you run the <a href="add-vboamazons3objectstoragerepository.md"><code>Add-VBOAmazonS3ObjectStorageRepository</code></a> or <a href="add-vboamazons3glacierrepository.md"><code>Add-VBOAmazonS3GlacierRepository</code></a> or <a href="add-vboamazons3repository.md"><code>Add-VBOAmazonS3Repository</code></a> cmdlet.</p><p>Accepts the <a href="vboamazonvpc.md"><code>VBOAmazonVpc</code></a> object.</p><p>To get this object, run the <a href="get-vboamazonvpc.md"><code>Get-VBOAmazonVPC</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboamazonvpc.md"><code>VBOAmazonVpc</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>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Output Object
The cmdlet returns the [`VBOAmazonArchiverAppliance`](vboamazonarchiverappliance.md) object that contains the Amazon archiver appliance settings.

## Examples

::: example
### Creating Amazon Archiver Appliance

This example shows how to define the Amazon archiver appliance settings.

```
$S3account = Get-VBOAmazonS3Account -AccessKey "?Iqws8NewidZydk"
$S3connection = New-VBOAmazonS3ConnectionSettings -Account $S3account -RegionType Global
$inst = Get-VBOAmazonInstanceType -AmazonS3ConnectionSettings $S3connection -RegionId eu-central-1 -Name m6i.2xlarge
$VPC = Get-VBOAmazonVPC -AmazonS3ConnectionSettings $S3connection -RegionId eu-central-1 -Name "VPCName"
$subnet = Get-VBOAmazonSubnet -VPC $VPC -Name "SubnetName"
$sgroup = Get-VBOAmazonSecurityGroup -VPC $VPC -Name "SecurityGroupName"
New-VBOAmazonArchiverAppliance -InstanceType $inst -VPC $VPC -Subnet $subnet -SecurityGroup $sgroup -IpRanges @("217.113.11.0/24","124.31.42.18") -Port 80
```

Perform the following steps:

1. Run the [`Get-VBOAmazonS3Account`](get-vboamazons3account.md) cmdlet. Specify the `AccessKey` parameter value. Save the result to the `$S3account` variable.
2. Run the [`New-VBOAmazonS3ConnectionSettings`](new-vboamazons3connectionsettings.md) cmdlet. Set the `$S3account` variable as the `Account` parameter value. Specify the `RegionType` parameter value. Save the result to the `$S3connection` variable.
3. Run the [`Get-VBOAmazonInstanceType`](get-vboamazoninstancetype.md) cmdlet. Set the `$S3connection` variable as the `AmazonS3ConnectionSettings` parameter value. Specify the `RegionId` parameter value. Specify the `Name` parameter value. Save the result to the `$inst` variable.
4. Run the [`Get-VBOAmazonVPC`](get-vboamazonvpc.md) cmdlet. Set the `$S3connection` variable as the `AmazonS3ConnectionSettings` parameter value. Specify the `RegionId` parameter value. Specify the `Name` parameter value. Save the result to the `$VPC` variable.
5. Run the [`Get-VBOAmazonSubnet`](get-vboamazonsubnet.md) cmdlet. Set the `$VPC` variable as the `VPC` parameter value. Specify the `Name` parameter value. Save the result to the `$subnet` variable.
6. Run the [`Get-VBOAmazonSecurityGroup`](get-vboamazonsecuritygroup.md) cmdlet. Set the `$VPC` variable as the `VPC` parameter value. Specify the `Name` parameter value. Save the result to the `$sgroup` variable.
7. Run the `New-VBOAmazonArchiverAppliance` cmdlet. Specify the following settings:

   - Set the `$inst` variable as the `InstanceType` parameter value.
   - Set the `$VPC` variable as the `VPC` parameter value.
   - Set the `$subnet` variable as the `Subnet` parameter value.
   - Set the `$sgroup` variable as the `SecurityGroup` parameter value.
   - Specify the `IpRanges` parameter value.
   - Specify the `Port` parameter value.

:::

## Related Commands

- [`Get-VBOAmazonInstanceType`](get-vboamazoninstancetype.md)
- [`Get-VBOAmazonSecurityGroup`](get-vboamazonsecuritygroup.md)
- [`Get-VBOAmazonSubnet`](get-vboamazonsubnet.md)
- [`Get-VBOAmazonVPC`](get-vboamazonvpc.md)
- [`New-VBOAmazonS3ConnectionSettings`](new-vboamazons3connectionsettings.md)
- [`Get-VBOAmazonS3Account`](get-vboamazons3account.md)
- [`Get-VBOProxy`](get-vboproxy.md)
- [`Get-VBOProxyPool`](get-vboproxypool.md)