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. Run New-VBRCloudVLANConfiguration 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 | Accept |
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 server object or string (name of server) type. | 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 | 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 | 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 storage objects. The hardware plan will use these objects to allocate storage space to the tenant under this hardware plan. Accepts VBRHvCloudHardwarePlanDatastore type. | 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
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 New-VBRCloudVLANConfiguration.
- 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.
$server = Get-VBRServer -Type HvServer -Name "Hyper-V Host" Add-VBRHvCloudHardwarePlan -Name "Hyper-V Silver" -Description "Hyper-V Hardware Plan" -Server $server -Datastore $cloudreplicas -CPU 4000 -Memory 2000 -NumberOfNetWithoutInternet 1 |
Related Commands
