Help Center
Choose product document...
Veeam Backup & Replication 9.5
PowerShell Reference

Set-VBRViCloudHardwarePlan

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 VBRViCloudHardwarePlan type.

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 CHost (standalone host) or CViClusterItem (cluster) type.

True

Named

False

False

CPU

Specifies the quota of CPU resources you want to assign to the hardware plan (MHz).

False

Named

False

False

Memory

Specifies the quota 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.

Accepts VBRViCloudHardwarePlanDatastore type.

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.

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

Related Commands

Get-VBRServer

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Backup Explorers User Guide

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide

Veeam Backup for Microsoft Office 365

Veeam ONE Documentation

Veeam Endpoint Backup Documentation

Veeam Management Pack Documentation