Set-VBRViCloudHardwarePlan

Short Description

Modifies VMware hardware plans.

Applies to

Platform: VMware

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

Requires a VCP license.

Syntax

Set-VBRViCloudHardwarePlan -HardwarePlan <VBRViCloudHardwarePlan> [-Name <string>] [-Description <string>] [-Server <Object>] [-CPU <int32>] [-Memory <int32>] [-UnlimitedCPU] [-UnlimitedMemory] [-NumberOfNetWithInternet <int32>] [-NumberOfNetWithoutInternet <int32>] [-Datastore <VBRViCloudHardwarePlanDatastore[]>] [-Force] [<CommonParameters>]

Detailed Description

This cmdlet modifies settings of an existing hardware plan.

Note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
HardwarePlan	Specifies the hardware plan you want to modify.	Accepts the VBRViCloudHardwarePlan object. To get this object, run the Get-VBRCloudHardwarePlan cmdlet.	True	Named	True (ByValue, ByProperty Name)
Name	Specifies the name you want to assign to the hardware plan.	String	True	Named	False
Description	Specifies the description of the hardware plan.	String	False	Named	False
Server	Specifies the ESXi host or cluster. The resources of this host or cluster will be exposed to the tenant by the hardware plan.	Accepts the CHost (standalone host) or CViClusterItem (cluster) object. To get this object, run the Get-VBRServer cmdlet.	True	Named	False
CPU	Specifies the quota of CPU resources you want to assign to the hardware plan (MHz).	Int32	False	Named	False
Memory	Specifies the quota of memory resources you want to assign to the hardware plan (Mb).	Int32	False	Named	False
UnlimitedCPU	Defines that the quota of CPU resources is unlimited. If you provide this parameter, the tenant will be able to use all CPU resources of the host.	SwitchParameter	False	Named	False
UnlimitedMemory	Defines that the quota of CPU memory is unlimited. If you provide this parameter, the tenant will be able to use all memory resources of the host.	SwitchParameter	False	Named	False
NumberOfNetWithInternet	Specifies the number of networks with access to the Internet that you want to assign to the hardware plan.	Int32	False	Named	False
NumberOfNetWithoutInternet	Specifies the number of networks without access to the Internet that you want to assign to the hardware plan.	Int32	False	Named	False
Datastore	Specifies the array of the datastores that will be used for storing tenant data.	Accepts the VBRViCloudHardwarePlanDatastore[] object. To get this object, run the New-VBRViCloudHWPlanDatastore cmdlet.	False	Named	False
Force	Defines that the cmdlet will modify the hardware plan without showing warnings in the PowerShell console.	SwitchParameter	False	Named	False

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

Output Object

VBRViCloudHardwarePlan

Examples

Set-VBRViCloudHardwarePlan Example 1. Modifying Hardware Plan to Add Ability to Use Several Networks

This example shows how to add the ability to use 2 networks with access to the Internet to a hardware plan named VMware Gold.

$hardwareplan = Get-VBRCloudHardwarePlan -Name "VMware Gold"

Set-VBRViCloudHardwarePlan -HardwarePlan $hardwareplan -NumberOfNetWithInternet 2

Perform the following steps:

Run the Get-VBRCloudHardwarePlan cmdlet. Specify the Name parameter value. Save the result to the $hardwareplan variable.
Run the Set-VBRViCloudHardwarePlan cmdlet. Set the $hardwareplan variable as the HardwarePlan parameter value. Specify the NumberOfNetWithInternet parameter value.

Set-VBRViCloudHardwarePlan Example 2. Modifying CPU and Memory Quotas of Hardware Plan

This example shows how to modify the CPU and memory quotas of a hardware plan named VMware Gold.

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

Set-VBRViCloudHardwarePlan -HardwarePlan $hardwareplan -CPU 5000 -Memory 4000

Perform the following steps:

Run the Get-VBRCloudHardwarePlan cmdlet. Specify the Name parameter value. Save the result to the $hardwareplan variable.
Run the Set-VBRViCloudHardwarePlan cmdlet. Set the $hardwareplan variable as the HardwarePlan parameter value. Specify the CPU and the Memory parameter values.

Set-VBRViCloudHardwarePlan Example 3. Modifying Harware Plan to Add More Cloud Storage

This example shows how to add one more cloud storage to a hardware plan named VMware Silver.

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

$cloudstorage = $hardwareplan.Datastore

$cloudstorage += $newcloudstorage

Set-VBRViCloudHardwarePlan -HardwarePlan $hardwareplan -Datastore $cloudstorage

Perform the following steps:

Pre-configure the new cloud storage. For details, see the New-VBRViCloudHWPlanDatastore cmdlet. Save the storage to the $newcloudstorage variable.
Run the Get-VBRCloudHardwarePlan cmdlet. Specify the Name parameter value. Save the result to the $hardwareplan variable.
Get the array of cloud storage objects that are currently used in the hardware plan. Save the array to the $cloudstorage variable.
Add a new cloud storage object to the array.
Run the Set-VBRViCloudHardwarePlan cmdlet. Set the $hardwareplan variable as the HardwarePlan parameter value. Set the $cloudstorage variable as the Datastore parameter value.

Related Commands