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>]
[-Server <VIServer[]>]
[CommonParameters]
-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>]
[-Server <VIServer[]>]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required |
|
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 |
|
String | named |
|
Specifies a name for the new resource pool. | optional |
|
Boolean | named |
|
Indicates that the CPU reservation can grow beyond the specified value if the parent resource pool has unreserved resources. | optional |
|
Int64 | named |
|
Specifies a CPU usage limit in MHz. Utilization will not exceed this limit even if there are available resources. | optional |
|
Int64 | named |
|
Specifies the CPU size in MHz that is guaranteed to be available. | optional |
|
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 |
|
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 |
|
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 |
|
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 |
|
Decimal | named |
|
Specifies the guaranteed available memory in gigabytes (GB). | optional |
|
Int64 | named |
|
This parameter is obsolete. Use MemReservationGB instead. Specifies the guaranteed available memory in megabytes (MB). | optional |
|
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 |
|
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 |
|
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 |
|
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.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 modifies the properties of the specified resource pool.
This cmdlet removes the specified resource pools from their locations.
This cmdlet creates a new resource pool.
