Set-VBRHvCloudHardwarePlan

Short Description

Modifies Hyper-V hardware plans.

Applies to

Platform: Hyper-V

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

Requires a VCP license.

Syntax

Set-VBRHvCloudHardwarePlan -HardwarePlan <VBRHvCloudHardwarePlan> [-Name <String>] [-Description <String>] [-Server <CHost>] [-CPU <Int32>] [-Memory <Int32>] [-NumberOfNetWithInternet <Int32>] [-NumberOfNetWithoutInternet <Int32>] [-Datastore <VBRHvCloudHardwarePlanDatastore[]>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [-PipelineVariable <String>] [<CommonParameters>]

Detailed Description

This cmdlet modifies settings of an existing hardware plan. To modify settings, you need to specify new values for the necessary parameters. The parameters that you omit will remain unchanged.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

HardwarePlan

Specifies the hardware plan you want to modify.

Accepts VBRHvCloudHardwarePlan type.

True

Named

True (ByValue,
ByProperty
Name)

False

Name

Specifies the name you want to assign to the hardware plan.

False

Named

False

False

Description

Specifies the description of the hardware plan.

False

Named

False

False

Server

Specifies the Hyper-V host. The resources of this host will be exposed to the tenant by the hardware plan.

Accepts server object or string (name of server) type.

False

Named

False

False

CPU

Specifies the quota of CPU resources you want to assign to the hardware plan (MHz).

False

Named

False

False

Memory

Specifies the quota of memory resources you want to assign to the hardware plan (Mb).

False

Named

False

False

UnlimitedCPU

Indicates that the quota of CPU resources is unlimited.

With unlimited CPU quota, the tenant will be able to use all CPU resources of the host.

False

Named

False

False

NumberOfNetWithInternet

Specifies the number of networks with access to the Internet that you want to assign to the hardware plan.

False

Named

False

False

NumberOfNetWithoutInternet

Specifies the number of networks without access to the Internet that you want to assign to the hardware plan.

False

Named

False

False

Datastore

Specifies the array of the datastores that will be used for storing tenant data.

Accepts VBRHvCloudHardwarePlanDatastore type.

False

Named

False

False

Force

If set, the cmdlet will modify the hardware plan without notifying the user. Otherwise, the cmdlet will display a warning.

False

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Return Type

VBRHvCloudHardwarePlan

Example 1

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

  1. Run Get-VBRCloudHardwarePlan to get the hardware plan and save it to the $hardwareplan variable.
  2. Run Set-VBRHvCloudHardwarePlan using the $hardwareplan variable.

$hardwareplan = Get-VBRCloudHardwarePlan -Name "Hyper-V Gold"

Set-VBRCloudHardwarePlan -HardwarePlan $hardwareplan -NumberOfNetWithInternet 2

Example 2

This example shows how to modify the CPU and memory quotas of a hardware plan named "Hyper-V Silver".

  1. Run Get-VBRCloudHardwarePlan to get the hardware plan and save it to the $hardwareplan variable.
  2. Run Set-VBRHvCloudHardwarePlan using the $hardwareplan variable.

$hardwareplan = Get-VBRCloudHardwarePlan -Name "Hyper-V Silver"

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

Example 3

This example shows how to add one more cloud storage to a hardware plan named "Hyper-V Silver".

  1. Pre-configure a new cloud storage. For details, see New-VBRHvCloudHWPlanDatastore. Save the storage to the $newcloudstorage variable.
  2. Run Get-VBRCloudHardwarePlan to get the hardware plan and save it 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 Set-VBRHvCloudHardwarePlan using the $hardwareplan variable and the updated array of cloud storage objects.

$hardwareplan = Get-VBRCloudHardwarePlan -Name "Hyper-V Silver"

$cloudstorage = $hardwareplan.Datastore

$cloudstorage = $newcloudstorage

Set-VBRCloudHardwarePlan -HardwarePlan $hardwareplan -Datastore $cloudstorage

Related Commands

Get-VBRServer