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

Set-VBRHvCloudHardwarePlan

Short Description

Modifies Hyper-V hardware plans.

Applies to

Platform: Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Requires a VCP license.

Syntax

Set-VBRHvCloudHardwarePlan -HardwarePlan <VBRHvCloudHardwarePlan> [-Name <String>] [-Description <String>] [-Server <CHost>] [-CPU <Int32>] [-Memory <Int32>] [-NumberOfNetWithInternet <Int32>] [-NumberOfNetWithoutInternet <Int32>] [-Datastore <VBRHvCloudHardwarePlanDatastore[]>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [-PipelineVariable <String>] [<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 VBRHvCloudHardwarePlan type.

True

Named

True (by Value
FromPipeline,
ValueFromPipeline
ByPropertyName)

False

Name

Specifies the name you want to assign to the hardware plan.

False

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 will be exposed to the tenant by the hardware plan.

Accepts CHost or string (name of server) type.

False

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

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

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

VBRHvCloudHardwarePlan

Example 1

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

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

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

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

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

  1. Pre-configure the new cloud storage. For details, see New-VBRHvCloudHWPlanDatastore. 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-VBRHvCloudHardwarePlan using the $hardwareplan variable and the updated array of the cloud storages.

PS C:\PS> $hardwareplan = Get-VBRCloudHardwarePlan -Name "Hyper-V 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