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 parameters 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

<CommonParameters>

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

Output Object

VBRViCloudHardwarePlan

Examples

Set-VBRViCloudHardwarePlanExample 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:

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

Set-VBRViCloudHardwarePlanExample 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:

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

Set-VBRViCloudHardwarePlanExample 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:

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

Related Commands