< Back

Set-ResourcePool

Sun Jan 19, 2020 7:08 pm

NAME Set-ResourcePool



SYNOPSIS

This cmdlet modifies the properties of the specified resource pool.





SYNTAX

Set-ResourcePool [-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[]>] [-Confirm]

[-WhatIf] [<CommonParameters>]





DESCRIPTION

This cmdlet modifies the properties of the specified resource pool.





PARAMETERS

-CpuExpandableReservation <Boolean>

Indicates that the CPU reservation can grow beyond the specified value if the parent resource pool has

unreserved resources.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-CpuLimitMhz <Int64>

Specifies a CPU usage limit in MHz. If this parameter is set, utilization will not exceed this limit even if

there are available resources.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-CpuReservationMhz <Int64>

Specifies the guaranteed available CPU in MHz.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-CpuSharesLevel <SharesLevel>

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.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-MemExpandableReservation <Boolean>

Indicates that the memory reservation can grow beyond the specified value if the parent resource pool has

unreserved resources.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-MemLimitGB <Decimal>

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.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-MemLimitMB <Int64>

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.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-MemReservationGB <Decimal>

Specifies the guaranteed available memory in gigabytes (GB).



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-MemReservationMB <Int64>

This parameter is obsolete. Use MemReservationGB instead. Specifies the guaranteed available memory in

megabytes (MB).



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-MemSharesLevel <SharesLevel>

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.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Name <String>

Specifies a new name for the resource pool.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-NumCpuShares <Int32>

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.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-NumMemShares <Int32>

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.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-ResourcePool <ResourcePool[]>

Specifies the resource pool you want to configure.



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? true



-Server <VIServer[]>

Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is given to this

parameter, the command runs on the default servers. For more information about default servers, see the

description of Connect-VIServer.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? true



-Confirm [<SwitchParameter>]

If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false,

the cmdlet runs without asking for user confirmation.



Required? false

Position? named

Default value $true

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are

modified.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

Zero or more modified ResourcePool objects







NOTES









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

Online Version: https://code.vmware.com/doc/preview?id= ... ePool.html

Get-ResourcePool

Move-ResourcePool

New-ResourcePool

Remove-ResourcePool