New-VBRCloudTenantHwPlanOptions

Short Description

Creates the VBRCloudTenantHwPlanOptions objects that contains hardware plan options.

Platform: VMware, Hyper-V

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

Requires a VCP license.

Syntax

New-VBRCloudTenantHwPlanOptions -HardwarePlan <VBRCloudHardwarePlan> [-EnableWanAcceleration]

[-WanAccelerator <CWanAccelerator>] [<CommonParameters>]

Detailed Description

This cmdlet creates a VBRCloudTenantHwPlanOptions object that contains a hardware plan. This object is used in the New-VBRCloudTenantReplicationResources cmdlet to specify the hardware plan options.

You can also enable WAN acceleration and set a target WAN accelerator. Note that the tenant who plan to use the WAN acceleration must configure a source WAN accelerator on their side.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
EnableWanAcceleration	Enables the option to use WAN accelerators for backup jobs to cloud repositories. Use the `WanAccelerator` parameter to set the WAN accelerator.	`SwitchParameter`	False	Named	False
HardwarePlan	Specifies the hardware plan from which you want to enable the WAN acceleration. Accepts the `VBRHvCloudHardwarePlan` or `VBRViCloudHardwarePlan` object. To get this object, run the `Get-VBRCloudHardwarePlan` cmdlet.	`VBRCloudHardwarePlan`	True	Named	True (ByPropertyName, ByValue)
WanAccelerator	Specifies the WAN accelerator for the `EnableWanAccelerator` parameter. Accepts the `CWanAccelerator` object. To get this object, run the `Get-VBRWANAccelerator` cmdlet.	`CWanAccelerator`	False	Named	False

<CommonParameters>

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

Output Object

VBRCloudTenantHwPlanOptions

Examples

New-VBRCloudTenantHwPlanOptions Example 1. Creating Hardware Plan Options Without WAN Acceleration

This example shows how to create a hardware plan options object without WAN acceleration.

$HwPlan = Get-VBRCloudHardwarePlan -Name "VMware Silver"

$options = New-VBRCloudTenantHwPlanOptions -HardwarePlan $HwPlan

Perform the following steps:

Run the Get-VBRCloudHardwarePlan cmdlet. Specify the Name parameter value. Save it to the $HwPlan variable.
Run the New-VBRCloudTenantHwPlanOptions cmdlet. Set the $HwPlan variable as the HardwarePlan parameter value. Save the result to the $options variable for further use.

New-VBRCloudTenantHwPlanOptions Example 2. Enabling WAN Acceleration for VMware Hardware Plan

This example shows how to enable WAN acceleration for a VMware hardware plan.

$HwPlan = Get-VBRCloudHardwarePlan -Platform VMWare -Name "VMware Silver"

$wan = Get-VBRWANAccelerator -Name "Columbus WAN"

$options = New-VBRCloudTenantHwPlanOptions -HardwarePlan $HwPlan -EnableWanAcceleration -WanAccelerator $wan

Perform the following steps:

Run the Get-VBRCloudHardwarePlan cmdlet. Set the VMWare option for the Platform parameter. Specify the Name parameter value. Save it to the $HwPlan variable.
Run the Get-VBRWANAccelerator cmdlet. Specify the Name parameter value. Save it to the $wan variable.
Run the New-VBRCloudTenantHwPlanOptions using the saved variables. Specify the following settings:
- Set the $HwPlan variable as the HardwarePlan parameter value.
- Provide the EnableWanAcceleration parameter.
- Set the $wan variable as the WanAccelerator parameter value.
- Save the result to the $options variable for further use.

New-VBRCloudTenantHwPlanOptions Example 3. Enabling WAN Acceleration for VMware Hardware Plan

This example shows how to enable WAN acceleration for a Hyper-V hardware plan.

$HwPlan = Get-VBRCloudHardwarePlan -Platform HyperV -Name "Hyper-V Silver"

$wan = Get-VBRWANAccelerator -Name "Columbus WAN"

$options = New-VBRCloudTenantHwPlanOptions -HardwarePlan $HwPlan -EnableWanAcceleration -WanAccelerator $wan

Perform the following steps:

Run the Get-VBRCloudHardwarePlan cmdlet. Set the HyperV option for the Platform parameter. Specify the Name parameter value. Save it to the $HwPlan variable.
Run the Get-VBRWANAccelerator cmdlet. Specify the Name parameter value. Save it to the $wan variable.
Run the New-VBRCloudTenantHwPlanOptions using the saved variables. Specify the following settings:
- Set the $HwPlan variable as the HardwarePlan parameter value.
- Provide the EnableWanAcceleration parameter.
- Set the $wan variable as the WanAccelerator parameter value.
- Save the result to the $options variable for further use.