New-VBRAmazonEC2ProxyAppliance

Short Description

Defines settings for Amazon EC2 helper appliances.

Platform: VMware, Hyper-V

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

Syntax

New-VBRAmazonEC2ProxyAppliance -InstanceType <VBRAmazonEC2InstanceType> -Subnet <VBRAmazonEC2Subnet>

-SecurityGroup <VBRAmazonEC2SecurityGroup> -RedirectorPort <Int32> [<CommonParameters>]

Detailed Description

This cmdlet creates the VBRAmazonEC2ProxyAppliance object. This object contains settings for Amazon EC2 helper appliances.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
InstanceType	Specifies a Amazon EC2 instance type. The cmdlet will set the CPU and memory settings for a Amazon EC2 instance according to this instance type. Accepts the `VBRAmazonEC2InstanceType` object. To get this object, run the `Get-VBRAmazonEC2InstanceType` cmdlet.	`VBRAmazonEC2InstanceType`	True	Named	False
RedirectorPort	Specifies the redirection port number. Veeam Backup & Replication will use this port to connect to the proxy appliance. Default: `443`	`Int32`	True	Named	False
SecurityGroup	Specifies the Amazon EC2 security group. Accepts the `VBRAmazonEC2SecurityGroup` object. To get this object, run the `Get-VBRAmazonEC2SecurityGroup` cmdlet.	`VBRAmazonEC2SecurityGroup`	True	Named	False
Subnet	Specifies the Amazon VPC subnet. Accepts the `VBRAmazonEC2Subnet` object. To get this object, run the `Get-VBRAmazonEC2Subnet` cmdlet.	`VBRAmazonEC2Subnet`	True	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

The cmdlet returns the VBRAmazonEC2ProxyAppliance object that contains settings of Amazon EC2 helper appliances.

Examples

Defining Settings for AmazonEC2 Help Appliance

This example shows how to define settings for the AmazonEC2 helper appliance.

$account = Get-VBRAmazonAccount -Id "936edf7c-7cf3-4dbd-9895-c7485ef4bb2c"

$region = Get-VBRAmazonEC2Region -Account $account -RegionType Global -Name "ap-northeast-1"

$instance = Get-VBRAmazonEC2InstanceType -Region $region

$vpc = Get-VBRAmazonEC2VPC -Region $region

$sgroup = Get-VBRAmazonEC2SecurityGroup -VPC $vpc

$subnet = Get-VBRAmazonEC2Subnet -VPC $vpc -AvailabilityZone "eu-west-1a"

New-VBRAmazonEC2ProxyAppliance -InstanceType $instance -Subnet $subnet -SecurityGroup $sgroup -RedirectorPort 443

Perform the following steps:

Run the Get-VBRAmazonAccount cmdlet. Specify the Id parameter value. Save the result to the $account variable.
Run the Get-VBRAmazonEC2Region 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.
Run the Get-VBRAmazonEC2InstanceType cmdlet. Set the $region variable as the Region parameter value. Save the result to the $instance variable.
Run the Get-VBRAmazonEC2VPC cmdlet. Set the $region variable as the Region parameter value. Save the result to the $vpc variable.
Run the Get-VBRAmazonEC2SecurityGroup cmdlet. Set the $vpc variable as the VPC parameter value. Save the result to the $sgroup variable.
Run the Get-VBRAmazonEC2Subnet cmdlet. Set the $vpc variable as the VPC parameter value. Specify the AvailabilityZone parameter value. Save the result to the $subnet variable.
Run the New-VBRAmazonEC2ProxyAppliance cmdlet. Specify the following settings:
- 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.