Get-VBRAmazonEC2Subnet
Short Description
Returns an array of Amazon VPC subnets.
Applies to
Platform: VMware, Hyper-V
Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License
Syntax
This cmdlet provides parameter sets that allow you to:
- Get an Amazon VPC subnet by the sunbnet IP range.
Get-VBRAmazonEC2Subnet -VPC <VBRAmazonEC2VPC> -Name <string> [<CommonParameters>] |
- Get an Amazon EC2 subnet by the Availability Zone in which the subnet resides.
Get-VBRAmazonEC2Subnet -VPC <VBRAmazonEC2VPC> [-AvailabilityZone <string>] [<CommonParameters>] |
Detailed Description
This cmdlet returns an array of subnets that are available in the selected Amazon VPC.
Parameters
Parameter | Description | Type | Required | Position | Accept |
|---|---|---|---|---|---|
VPC | Specifies the Amazon VPC. | Accepts the VBRAmazonEC2VPC object. To get this object, run the Get-VBRAmazonEC2VPC cmdlet. | True | Named | False |
Name | Specifies the IP range. The cmdlet will return the Amazon VPC subnet with this IP range. | String | True | Named | False |
AvailabilityZone | Specifies the Availability Zone. The cmdlet will return the Amazon VPC subnet that resides in the specified Availability Zone. | String | False | Named | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.
Output Object
Examples
Getting Amazon VPC Subnet by Availability Zone
This example shows how to get the Amazon VPC subnet by geographic location and the associated Availability Zone.
$account = Get-VBRAmazonAccount -Id "936edf7c-7cf3-4dbd-9895-c7485ef4bb2c" $region = Get-VBRAmazonEC2Region -Account $account -RegionType Global -Name "ap-northeast-1" $vpc = Get-VBRAmazonEC2VPC -Region $region Get-VBRAmazonEC2Subnet -VPC $vpc -AvailabilityZone "eu-west-1a" |
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-VBRAmazonEC2VPC cmdlet. Set the $region variable as the Region parameter value. Save the result to the $vpc variable.
- Run the Get-VBRAmazonEC2Subnet cmdlet. Set the $vpc variable as the VCP parameter value. Specify the AvailabilityZone parameter value.
Related Commands