New-VBRAmazonEC2Container - Veeam Backup PowerShell Reference

New-VBRAmazonEC2Container -Region <VBRAmazonEC2Region> -Entity <Object[]> [-ExcludeEntities] [-ExcludedEntity <Object[]>] [-AutoAssignIAMRole] [<CommonParameters>]

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Region	Specifies AWS Regions in which you want to deploy Veeam Agent on cloud machines.	Accepts the VBRAmazonEC2Region object. To create this object, run the Get-VBRAmazonEC2Region cmdlet.	True	Named	True (ByValue, ByPropertyName)
Entity	Specifies an array of the following entities that the cmdlet will add to a scope of a protection group: EC2 instances. EC2 tags. AWS datacenters.	Accepts the Object[] object. To get this object, run the following cmdlets: Get-VBRAmazonEC2VM New-VBRAmazonEC2Tag Get-VBRAmazonEC2Region	True	Named	True (ByValue, ByPropertyName)
ExcludeEntities	Defines that the cmdlet will exclude the following entities from a scope of a protection group: EC2 instances. EC2 tags. AWS datacenters. Provide the ExcludedEntity parameter to specify the excluded entities.	SwitchParameter	False	Named	True (ByPropertyName, ByValue)
ExcludedEntity	Specifies an array of the following entities that the cmdlet will exclude from a scope of a protection group: EC2 instances. EC2 tags. AWS datacenters.	Accepts the Object[] object. To get this object, run the following cmdlets: Get-VBRAmazonEC2VM New-VBRAmazonEC2Tag Get-VBRAmazonEC2Region	False	Named	True (ByValue, ByPropertyName)
AutoAssignIAMRole	Defines that the cmdlet will automatically set the IAM role with the AmazonSSMManagedInstanceCore policy to the EC2 instances that you want to back up. If you do not provide this parameter, you will have to set the IAM role manually.	SwitchParameter	False	Named	True (ByValue, ByPropertyName)

This example shows how to define the scope of Amazon EC2 instances to add them to a protection group.

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

$AWSregion = Get-VBRAmazonEC2Region -Account $AWSaccount -RegionType Global -Name "eu-central-1"

$instances = Get-VBRAmazonEC2VM -Region $AWSregion

$container = New-VBRAmazonEC2Container -Region $AWSregion -Entity $instances

Perform the following steps:

Run the Get-VBRAmazonAccount cmdlet. Specify the Id parameter value. Save the result to the $AWSaccount variable.
Run the Get-VBRAmazonEC2Region cmdlet. Set the $AWSaccount 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 $AWSregion variable.
Run the Get-VBRAmazonEC2VM cmdlet. Set the $AWSregion variable as the Region parameter value. Save the result to the $instances variable.
Run the New-VBRAmazonEC2Container cmdlet. Set the $AWSregion variable as the Region parameter value. Set the $instances variable as the Entity parameter value. Save the result to the $container variable.

This example shows how to define the scope of Amazon EC2 datacenters to add them to a protection group.

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

$datacenter = Get-VBRAmazonEC2Region -Account $AWSaccount -RegionType Global -Name "eu-central-1"

$container = New-VBRAmazonEC2Container -Region $AWSregion -Entity $datacenter

Perform the following steps:

Run the Get-VBRAmazonAccount cmdlet. Specify the Id parameter value. Save the result to the $AWSaccount variable.
Run the Get-VBRAmazonEC2Region cmdlet. Set the $AWSaccount 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 $datacenter variable.
Run the New-VBRAmazonEC2Container cmdlet. Set the $AWSregion variable as the Region parameter value. Set the $datacenter variable as the Entity parameter value. Save the result to the $container variable.

This example shows how to define the to define the scope of Amazon EC2 tags to add them to a protection group.

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

$AWSregion = Get-VBRAmazonEC2Region -Account $AWSaccount -RegionType Global -Name "eu-central-1"

$tag = New-VBRAmazonEC2Tag -Key "owner" -Value "vat"

$container = New-VBRAmazonEC2Container -Region $AWSregion -Entity $tag

Perform the following steps:

Run the Get-VBRAmazonAccount cmdlet. Specify the Id parameter value. Save the result to the $AWSaccount variable.
Run the Get-VBRAmazonEC2Region cmdlet. Set the $AWSaccount 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 $AWSregion variable.
Run the New-VBRAmazonEC2Tag cmdlet. Specify the Key and the Value parameter values. Save the result to the $tag variable.
Run the New-VBRAmazonEC2Container cmdlet. Set the $AWSregion variable as the Region parameter value. Set the $tag variable as the Entity parameter value. Save the result to the $container variable.