This is an archive version of the document. To get the most up-to-date information, see the current version.

Set-VBRHvCloudHardwarePlan

On This Page

Short Description
Applies to
Syntax
Detailed Description
Parameters
Return Type
Example 1
Example 2
Example 3

Short Description

Modifies Hyper-V hardware plans.

Applies to

Platform: Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

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 enter the corresponding parameters with new values. The parameters that you omit will remain unchanged.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Hardware Plan	Specifies the hardware plan you want to modify. Accepts the VBRHvCloudHardwarePlan object.	True	Named	True (by Value FromPipeline, ValueFromPipeline ByPropertyName)	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 the CHost object or string (name of server).	False	Named	False	False
CPU	Specifies the quote of CPU resources you want to assign to the hardware plan (MHz).	False	Named	False	False
Memory	Specifies the quote of memory resources you want to assign to the hardware plan (Mb).	False	Named	False	False
Memory	Specifies the quote 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
Number OfNetWith Internet	Specifies the number of networks with access to the Internet that you want to assign to the hardware plan.	False	Named	False	False
Number OfNet Without Internet	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.	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

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Related Commands

Get-VBRServer

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".

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

PS C:\PS> $hardwareplan = Get-VBRCloudHardwarePlan -Name "Hyper-V Gold"

PS C:\PS> 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".

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

PS C:\PS> $hardwareplan = Get-VBRCloudHardwarePlan -Name "Hyper-V Silver"

PS C:\PS> 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".

Pre-configure the new cloud storage. For details, see New-VBRHvCloudHWPlanDatastore. Save the storage to the $newcloudstorage variable.
Run Get-VBRCloudHardwarePlan to get the hardware plan and save it to the $hardwareplan variable.
Get the array of cloud storages that are currently used in the hardware plan. Save the array to the $cloudstorages variable.
Add the new cloud storage object to the array.
Run Set-VBRHvCloudHardwarePlan using the $hardwareplan variable and the updated array of the cloud storages.

PS C:\PS> $hardwareplan = Get-VBRCloudHardwarePlan -Name "Hyper-V Silver"

PS C:\PS> $cloudstorages = $hardwareplan.Datastore

PS C:\PS> $cloudstorages += $newcloudstorage

PS C:\PS> Set-VBRCloudHardwarePlan -HardwarePlan $hardwareplan -Datastore $cloudstorages