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

Set-VBRViCloudHardwarePlan

In this article

    Short Description

    Modifies VMware hardware plans.

    Applies to

    Platform: VMware

    Product Edition: Standard, Enterprise, Enterprise Plus

    Requires a VCP license.

    Syntax

    Set-VBRViCloudHardwarePlan -HardwarePlan <VBRViCloudHardwarePlan> [-Name <string>] [-Description <string>] [-Server <Object>] [-CPU <int>] [-Memory <int>] [-UnlimitedCPU] [-UnlimitedMemory] [-NumberOfNetWithInternet <int>] [-NumberOfNetWithoutInternet <int>] [-Datastore <VBRViCloudHardwarePlanDatastore[]>] [-Force] [<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.

    True

    Named

    False

    False

    Description

    Specifies the description of the hardware plan.

    False

    Named

    False

    False

    Server

    Specifies the ESX(i) host or cluster. The resources of this host or cluster will be exposed to the tenant by the hardware plan.

    Accepts the CHost (standalone host) or CViClusterItem (cluster) object.

    True

    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

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

    <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

    Return Type

    VBRViCloudHardwarePlan

    Example 1

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

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

    PS C:\PS> $hardwareplan = Get-VBRCloudHardwarePlan -Name "VMware 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 "VMware Silver".

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

    PS C:\PS> $hardwareplan = Get-VBRCloudHardwarePlan -Name "VMware 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 "VMware Silver".

    1. Pre-configure the new cloud storage. For details, see New-VBRViCloudHWPlanDatastore. 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 storages that are currently used in the hardware plan. Save the array to the $cloudstorages variable.
    4. Add the new cloud storage object to the array.
    5. Run Set-VBRViCloudHardwarePlan using the $hardwareplan variable and the updated array of the cloud storages.

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

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

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

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