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

Add-VBRHvCloudHardwarePlan

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

<CommonParameters>

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:

  1. Pre-configure networks without access to the Internet. For details, see Networking Resources.
  2. Pre-configure the cloud storage. For details, see New-VBRHvCloudHWPlanDatastore. Save the storage to the $cloudreplicas variable.
  3. 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.
  4. 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