New-VBOAmazonArchiverAppliance

Short Description

Defines the Amazon archiver appliance settings.

Syntax

New-VBOAmazonArchiverAppliance [-InstanceType <VBOAmazonInstanceType>] [-Port <int32>] [-VPC <VBOAmazonVpc>] [-Subnet <VBOAmazonSubnet>] [-SecurityGroup <VBOAmazonSecurityGroup>]  [<CommonParameters>]

Detailed Description

This cmdlet creates the VBOAmazonArchiverAppliance object. This object defines settings of the Amazon archiver appliance that Veeam Backup for Microsoft 365 will use when transferring backed-up data to an archive object storage.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Accept Wildcard Characters

InstanceType

Specifies an instance type that the archiver appliance will use.

For more information on instance types, see this Amazon article.

Default: m6i.xlarge (4 CPU/16 GB)

Accepts the VBOAmazonInstanceType object.

To get this object, run the Get-VBOAmazonInstanceType cmdlet.

False

Named

False

False

Port

Specifies the 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.

Default: 443

Int32

False

Named

False

False

VPC

Specifies the Amazon Virtual Private Cloud (Amazon VPC). The cmdlet will launch the target EC2 instance on this Amazon VPC.

For more information on the Amazon VPC, see this Amazon article.

Default: Create new

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 Add-VBOAmazonS3ObjectStorageRepository cmdlet.

Accepts the VBOAmazonVpc object.

To get this object, run the Get-VBOAmazonVPC cmdlet.

False

Named

False

False

Subnet

Specifies the archiver appliance subnet.

Default: Create new

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 Add-VBOAmazonS3ObjectStorageRepository cmdlet.

Accepts the VBOAmazonSubnet object.

To get this object, run the Get-VBOAmazonSubnet cmdlet.

False

Named

False

False

SecurityGroup

Specifies a security group that will be associated with the archiver appliance.

For more information on security groups for Amazon VPC, see this Amazon article.

Default: Create new

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 Add-VBOAmazonS3ObjectStorageRepository cmdlet.

Accepts the VBOAmazonSecurityGroup object.

To get this object, run the Get-VBOAmazonSecurityGroup cmdlet.

False

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Output Object

The cmdlet returns the VBOAmazonArchiverAppliance object that contains the Amazon archiver appliance settings.

Examples

New-VBOAmazonArchiverApplianceExample 1. 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 -Port 80

Perform the following steps:

  1. Run the Get-VBOAmazonS3Account cmdlet. Specify the AccessKey parameter value.  Save the result to the $S3account variable.
  2. Run the New-VBOAmazonS3ConnectionSettings 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 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 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 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 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 Port parameter value.

Related Commands