This is an archive version of the document. To get the most up-to-date information, see the current version.

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 object storage during backup copy jobs.

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

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-VBOAmazonArchiverAppliance Example 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:

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