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

Add-VBRHvCloudHardwarePlan

In this article

Short Description

Creates Hyper-V hardware plans.

Applies to

Platform: Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Requires a VCP license.

Syntax

Add-VBRHvCloudHardwarePlan -Name <string> -Server <CHost> -Datastore <VBRHvCloudHardwarePlanDatastore[]> [-Description <string>] [-CPU <int>] [-Memory <int>] [-UnlimitedCPU] [-UnlimitedMemory] [-NumberOfNetWithInternet <int>] [-NumberOfNetWithoutInternet <int>] [<CommonParameters>]

Detailed Description

This cmdlet creates a new hardware plan for Hyper-V environments.

The hardware plan allocates the following resources to a tenant:

Cloud host. When creating replicas, the tenant will use this host as target host to register the replicated VMs.
Quota of the cloud host CPU and memory.
[Pre-configure] Networks to which the tenant will connect the cloud replicas. Use the cmdlets in the VLANs Configuration section to pre-configure the pool of VLANs.
[Pre-configure] Cloud storage: a quota of datastores allocated to tenants. Run New-VBRHvCloudHWPlanDatastore to create the cloud storage.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Name	Specifies the name you want to assign to the hardware plan.	True	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 (CPU and memory quotas) will be allocated to the tenant by the hardware plan. Accepts the CHost object or string (name of server).	True	Named	False	False
CPU	Specifies the quota of CPU resources you want to allocate to the tenant under this hardware plan (MHz).	False	Named	False	False
Memory	Specifies the quota of CPU memory you want to allocate to the tenant under this hardware plan (Gb).	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
UnlimitedMemory	Indicates that the quota of CPU memory is unlimited. With unlimited memory quota, the tenant will be able to use all memory 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 allocate to the tenant under this hardware plan.	False	Named	False	False
Number OfNet Without Internet	Specifies the number of networks without access to the Internet that you want to allocate to the tenant under this hardware plan.	False	Named	False	False
Datastore	Specifies the array of cloud storages. The hardware plan will use use these storages to allocate storage space to the tenant under this hardware plan. Accepts VBRHvCloudHardwarePlanDatastore.	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

New-VBRHvCloudHWPlanDatastore

Return Type

VBRHvCloudHardwarePlan

Example

This example shows how to create a hardware plan with the following settings:

CPU quota: 4000 MHz
Memory quota: 2000 Gb
Cloud storage: "Cloud Replicas"
Networks without access to the Internet: 1

To create the hardware plan:

Pre-configure networks without access to the Internet. For details, see Networking Resources.
Pre-configure the cloud storage. For details, see New-VBRHvCloudHWPlanDatastore. Save the storage to the $cloudreplicas variable.
Run Get-VBRServer to get the host whose resources will be exposed to the user by the hardware plan. Save the server to the $server variable.
Run Add-VBRHvCloudHardwarePlan to create the hardware plan. Use the saved variables.

PS C:\PS> $server = Get-VBRServer -Type HvServer -Name "Hyper-V Host"

PS C:\PS> Add-VBRHvCloudHardwarePlan -Name "Hyper-V Silver" -Description "Hyper-V Hardware Plan" -Server $server -Datastore $cloudreplicas -CPU 4000 -Memory 2000 -NumberOfNetWithoutInternet 1