Set-ResourcePool
This cmdlet modifies the properties of the specified resource pool.
Syntax
-ResourcePool
<ResourcePool[]>
[-CpuExpandableReservation <Boolean>]
[-CpuLimitMhz <Int64>]
[-CpuReservationMhz <Int64>]
[-CpuSharesLevel <SharesLevel>]
[-MemExpandableReservation <Boolean>]
[-MemLimitGB <Decimal>]
[-MemLimitMB <Int64>]
[-MemReservationGB <Decimal>]
[-MemReservationMB <Int64>]
[-MemSharesLevel <SharesLevel>]
[-Name <String>]
[-NumCpuShares <Int32>]
[-NumMemShares <Int32>]
[-Server <VIServer[]>]
[CommonParameters]
[-CpuExpandableReservation <Boolean>]
[-CpuLimitMhz <Int64>]
[-CpuReservationMhz <Int64>]
[-CpuSharesLevel <SharesLevel>]
[-MemExpandableReservation <Boolean>]
[-MemLimitGB <Decimal>]
[-MemLimitMB <Int64>]
[-MemReservationGB <Decimal>]
[-MemReservationMB <Int64>]
[-MemSharesLevel <SharesLevel>]
[-Name <String>]
[-NumCpuShares <Int32>]
[-NumMemShares <Int32>]
[-Server <VIServer[]>]
[CommonParameters]
Parameters
Required | Parameter Name | Type | Position | Features | Description |
---|---|---|---|---|---|
required |
|
ResourcePool[] | named |
|
Specifies the resource pool you want to configure. | 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. If this parameter is set, utilization will not exceed this limit even if there are available resources. | optional |
|
Int64 | named |
|
Specifies the guaranteed available CPU in MHz. | optional |
|
SharesLevel | named |
|
Specifies the CPU allocation level for this pool. This property is used in relative allocation between resource consumers. This parameter accepts Custom, High, Low, and Normal values. | optional |
|
Boolean | named |
|
Indicates that 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 the resource pool. This property is used in relative allocation between resource consumers. This parameter accepts Custom, High, Low, and Normal values. | optional |
|
String | named |
|
Specifies a new name for the resource pool. | optional |
|
Int32 | named |
|
Specifies the CPU allocation level for the resource pool. This property is used in relative allocation between resource consumers. This parameter is ignored unless CpuSharesLevel is set to Custom. | optional |
|
Int32 | named |
|
Specifies the memory allocation level for the resource pool. This property is used in relative allocation between resource consumers. This parameter is ignored unless MemSharesLevel 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
Set-ResourcePool -Resourcepool Resourcepool -NumCpuShares 512 -MemLimitGB 4
Sets the CPU allocation level and the limit on memory usage in GB for the resource pool named Resourcepool.
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.