New-VBOAmazonArchiverAppliance

Short Description

Defines the Amazon archiver appliance settings.

Syntax

This cmdlet provides the following parameter sets:

IpRangesParamSet

New-VBOAmazonArchiverAppliance [-InstanceType <VBOAmazonInstanceType>] [-Port <Int32>] [-VPC <VBOAmazonVpc>]

[-Subnet <VBOAmazonSubnet>] [-SecurityGroup <VBOAmazonSecurityGroup>] -IpRanges <String[]> [<CommonParameters>]

ProxyParamSet

New-VBOAmazonArchiverAppliance [-InstanceType <VBOAmazonInstanceType>] [-Port <Int32>] [-VPC <VBOAmazonVpc>]

[-Subnet <VBOAmazonSubnet>] [-SecurityGroup <VBOAmazonSecurityGroup>] -ProxyIpRange <VBOProxy> [<CommonParameters>]

ProxyPoolParamSet

New-VBOAmazonArchiverAppliance [-InstanceType <VBOAmazonInstanceType>] [-Port <Int32>] [-VPC <VBOAmazonVpc>]

[-Subnet <VBOAmazonSubnet>] [-SecurityGroup <VBOAmazonSecurityGroup>] -ProxyPoolIpRange <VBOProxyPool> [<CommonParameters>]

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

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
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.	`VBOAmazonInstanceType`	False	Named	False
IpRanges	Specifies a range of IPv4 addresses for the specified security group.	`String[]`	True	Named	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
ProxyIpRange	Specifies public IPv4 address of a backup proxy server. Accepts the `VBOProxy` object. To get this object, run the `Get-VBOProxy` cmdlet.	`VBOProxy`	True	Named	False
ProxyPoolIpRange	Specifies public IPv4 addresses of all backup proxy servers added to a backup proxy pool. Accepts the `VBOProxyPool` object. To get this object, run the `Get-VBOProxyPool` cmdlet.	`VBOProxyPool`	True	Named	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` or `Add-VBOAmazonS3GlacierRepository` or `Add-VBOAmazonS3Repository` cmdlet. Accepts the `VBOAmazonSecurityGroup` object. To get this object, run the `Get-VBOAmazonSecurityGroup` cmdlet.	`VBOAmazonSecurityGroup`	False	Named	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` or `Add-VBOAmazonS3GlacierRepository` or `Add-VBOAmazonS3Repository` cmdlet. Accepts the `VBOAmazonSubnet` object. To get this object, run the `Get-VBOAmazonSubnet` cmdlet.	`VBOAmazonSubnet`	False	Named	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` or `Add-VBOAmazonS3GlacierRepository` or `Add-VBOAmazonS3Repository` cmdlet. Accepts the `VBOAmazonVpc` object. To get this object, run the `Get-VBOAmazonVPC` cmdlet.	`VBOAmazonVpc`	False	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About Common Parameters section of Microsoft Learn.

Output Object

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

Examples

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:

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 IpRanges parameter value.
- Specify the Port parameter value.