New-ResourcePool Command | Vmware PowerCLI Reference

New-ResourcePool

This cmdlet creates a new resource pool with the provided inputs on the location that is specified by the Location parameter.

Syntax

New-ResourcePool
-Location < VIContainer >
-Name < String >
[-CpuExpandableReservation < Boolean > ]
[-CpuLimitMhz < Int64 > ]
[-CpuReservationMhz < Int64 > ]
[-CpuSharesLevel < SharesLevel > ]
[-MemExpandableReservation < Boolean > ]
[-MemLimitGB < Decimal > ]
[-MemLimitMB < Int64 > ]
[-MemReservationGB < Decimal > ]
[-MemReservationMB < Int64 > ]
[-MemSharesLevel < SharesLevel > ]
[-NumCpuShares < Int32 > ]
[-NumMemShares < Int32 > ]
[-ProgressAction < ActionPreference > ]
[-Server < VIServer[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Location VIContainer named
  • pipeline
  • wildcards
Specifies a container object (ResourcePool, Cluster, or VMHost) where you want to place the new resource pool. If a host or a cluster is specified for the Location parameter, the resource pool is created in the "Resources" resource pool. The "Resources" resource pool is a system resource pool and is guaranteed to exist.
required
Name String named
Specifies a name for the new resource pool.
optional CpuExpandableReservation Boolean named
Indicates that the CPU reservation can grow beyond the specified value if the parent resource pool has unreserved resources.
optional CpuLimitMhz Int64 named
Specifies a CPU usage limit in MHz. Utilization will not exceed this limit even if there are available resources.
optional CpuReservationMhz Int64 named
Specifies the CPU size in MHz that is guaranteed to be available.
optional CpuSharesLevel SharesLevel named
Specifies the CPU allocation level for this pool. This property is used in relative allocation between resource consumers. The valid values are Custom, High, Low, and Normal.
optional MemExpandableReservation Boolean named
If the value is $true, the memory reservation can grow beyond the specified value if the parent resource pool has unreserved resources.
optional MemLimitGB Decimal named
Specifies a memory usage limit in gigabytes (GB). If this parameter is set, utilization will not exceed the specified limit even if there are available resources.
optional MemLimitMB Int64 named
This parameter is obsolete. Use MemLimitGB instead. Specifies a memory usage limit in megabytes (MB). If this parameter is set, utilization will not exceed the specified limit even if there are available resources.
optional MemReservationGB Decimal named
Specifies the guaranteed available memory in gigabytes (GB).
optional MemReservationMB Int64 named
This parameter is obsolete. Use MemReservationGB instead. Specifies the guaranteed available memory in megabytes (MB).
optional MemSharesLevel SharesLevel named
Specifies the memory allocation level for this pool. This property is used in relative allocation between resource consumers. The valid values are Custom, High, Low, and Normal.
optional NumCpuShares Int32 named
Specifies the CPU allocation level for this pool. This property is used in relative allocation between resource consumers. This parameter is ignored unless the CpuSharesLevel parameter is set to Custom.
optional NumMemShares Int32 named
Specifies the memory allocation level for this pool. This property is used in relative allocation between resource consumers. This parameter is ignored unless the MemSharesLevel parameter is set to Custom.
optional ProgressAction ActionPreference named
optional Server VIServer[] named
  • wildcards
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.

Output

VMware.VimAutomation.ViCore.Types.V1.Inventory.ResourcePool

Examples

Example 1

$resourcepool1 = Get-ResourcePool -Location Cluster -Name ResourcePool1

New-ResourcePool -Location $resourcepool1 -Name ResourcePool2 -CpuExpandableReservation $true -CpuReservationMhz 500 -CpuSharesLevel high -MemExpandableReservation $true -MemReservationGB 5 -MemSharesLevel high

Creates a new resource pool named ResourcePool2 in the cluster's root resource pool ResourcePool1.

Related Commands

ResourcePool

This cmdlet retrieves the resource pools available on a vCenter Server system.

This cmdlet moves a resource pool from one location to another.

This cmdlet creates a new resource pool.

This cmdlet removes the specified resource pools from their locations.

This cmdlet modifies the properties of the specified resource pool.