New-ResourcePool
This cmdlet creates a new resource pool with the provided inputs on the location that is specified by the Location parameter.
Syntax
-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 |
|
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 |
|
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.ResourcePoolExamples
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.