Set-SCHostReserve

Modifies the host reserve settings for a host group.

Description

The Set-SCHostReserve cmdlet modifies the host reserve settings for a host group. To modify the host reserve settings for a host group, that host group must not be inheriting its settings from a parent host group.

When you set the host reserve levels, the unit parameters, such as GB or Percentage, dictate the units in which the other levels, such as StartOptimizationLevel and PlacementLevel, are expressed.

The values for VMHostReserveLevel, StartOptimizationLevel and PlacementLevel must be represented in order. For example, the value for StartOptimizationLevel cannot be less than the value for VMHostReserveLevel, and the value for PlacementLevel cannot be less than the value for StartOptimizationLevel.

When the host has less than the specified amount for StartOptimizationLevel available, Dynamic Optimization will automatically try to rebalance the load.

A host will never be forced by Power Optimization to have less than the specified amount for PlacementLevel available because of another node being powered off.

For more information about Set-SCHostReserve, type: "Get-Help Set-SCHostReserve -online".

Parameters

CPU

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve CPU resource type.

Enabled

Required? true
Accept Pipeline Input? false
Position? named 
Enables an object when set to $True, or disables an object when set to $False. For example, if you want to upgrade software on a virtual machine template, you can disable the template object in the VMM library to temporarily prevent users from using that object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

CPU

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve CPU resource type.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

PlacementLevel

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the host reserve level above which placement is acceptable.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

CPU

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve CPU resource type.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

StartOptimizationLevel

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the host reserve level at which dynamic optimization is started.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

CPU

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve CPU resource type.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

VMHostReserveLevel

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the host reserve level at which placement returns an error if starting a virtual machine would require dropping below this level.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

DiskIO

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve Disk I/O resource type.

Enabled

Required? true
Accept Pipeline Input? false
Position? named 
Enables an object when set to $True, or disables an object when set to $False. For example, if you want to upgrade software on a virtual machine template, you can disable the template object in the VMM library to temporarily prevent users from using that object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

DiskIO

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve Disk I/O resource type.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

IOPS

Required? true
Accept Pipeline Input? false
Position? named 
Indicates that the unit for a host reserve resource is expressed in disk input/output operations per second (IOPS).

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

DiskIO

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve Disk I/O resource type.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Percent

Required? true
Accept Pipeline Input? false
Position? named 
Indicates that the unit for a host reserve resource is expressed in percent (%).

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

DiskIO

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve Disk I/O resource type.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

PlacementLevel

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the host reserve level above which placement is acceptable.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

DiskIO

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve Disk I/O resource type.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

StartOptimizationLevel

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the host reserve level at which dynamic optimization is started.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

DiskIO

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve Disk I/O resource type.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

VMHostReserveLevel

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the host reserve level at which placement returns an error if starting a virtual machine would require dropping below this level.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

DiskSpace

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve disk space resource type.

Enabled

Required? true
Accept Pipeline Input? false
Position? named 
Enables an object when set to $True, or disables an object when set to $False. For example, if you want to upgrade software on a virtual machine template, you can disable the template object in the VMM library to temporarily prevent users from using that object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

DiskSpace

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve disk space resource type.

GB

Required? true
Accept Pipeline Input? false
Position? named 
Indicates that the unit for a host reserve resource is expressed in gigabytes (GB).

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

DiskSpace

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve disk space resource type.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

MB

Required? true
Accept Pipeline Input? false
Position? named 
Indicates that the unit for a host reserve resource is expressed in megabytes (MB).

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

DiskSpace

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve disk space resource type.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Percent

Required? true
Accept Pipeline Input? false
Position? named 
Indicates that the unit for a host reserve resource is expressed in percent (%).

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

DiskSpace

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve disk space resource type.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

PlacementLevel

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the host reserve level above which placement is acceptable.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

DiskSpace

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve disk space resource type.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

VMHostReserveLevel

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the host reserve level at which placement returns an error if starting a virtual machine would require dropping below this level.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

Enabled

Required? true
Accept Pipeline Input? false
Position? named 
Enables an object when set to $True, or disables an object when set to $False. For example, if you want to upgrade software on a virtual machine template, you can disable the template object in the VMM library to temporarily prevent users from using that object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Memory

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve memory resource type.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

GB

Required? true
Accept Pipeline Input? false
Position? named 
Indicates that the unit for a host reserve resource is expressed in gigabytes (GB).

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Memory

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve memory resource type.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

MB

Required? true
Accept Pipeline Input? false
Position? named 
Indicates that the unit for a host reserve resource is expressed in megabytes (MB).

Memory

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve memory resource type.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Memory

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve memory resource type.

Percent

Required? true
Accept Pipeline Input? false
Position? named 
Indicates that the unit for a host reserve resource is expressed in percent (%).

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Memory

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve memory resource type.

PlacementLevel

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the host reserve level above which placement is acceptable.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Memory

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve memory resource type.

StartOptimizationLevel

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the host reserve level at which dynamic optimization is started.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Memory

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve memory resource type.

VMHostReserveLevel

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the host reserve level at which placement returns an error if starting a virtual machine would require dropping below this level.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

Enabled

Required? true
Accept Pipeline Input? false
Position? named 
Enables an object when set to $True, or disables an object when set to $False. For example, if you want to upgrade software on a virtual machine template, you can disable the template object in the VMM library to temporarily prevent users from using that object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Network

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve Network I/O resource type.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Mbps

Required? true
Accept Pipeline Input? false
Position? named 
Indicates that the unit for a host reserve resource is expressed in megabits per second (Mbps).

Network

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve Network I/O resource type.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Network

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve Network I/O resource type.

Percent

Required? true
Accept Pipeline Input? false
Position? named 
Indicates that the unit for a host reserve resource is expressed in percent (%).

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Network

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve Network I/O resource type.

PlacementLevel

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the host reserve level above which placement is acceptable.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Network

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve Network I/O resource type.

StartOptimizationLevel

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the host reserve level at which dynamic optimization is started.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Network

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a host reserve Network I/O resource type.

VMHostReserveLevel

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the host reserve level at which placement returns an error if starting a virtual machine would require dropping below this level.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

HostReserve

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a host reserve settings object.

Inherit

Required? true
Accept Pipeline Input? false
Position? named 
Indicates whether settings are inherited from the parent host group.

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a VMM server object.

Examples

1: Modify the CPU host reserve and placement settings for a specified host group. 
PS C:\> $HostGroup = Get-SCVMHostGroup "HostGroup01"
PS C:\> $HostReserve = Get-SCHostReserve -VMHostGroup $HostGroup
PS C:\> $HostReserve | Set-SCHostReserve -CPU -PlacementLevel 75 -StartOptimizationLevel 80 -VMHostReserveLevel 90

The first command gets the host group object named HostGroup01 and stores the object in the $HostGroup variable.

The second command gets the host reserve object for the host group stored in $HostGroup, and then stores the object in the $HostReserve variable.

The last command uses the pipeline operator to pass the host reserve stored in $HostReserve to the Set-SCHostReserve cmdlet which updates the host reerve and placement settings.

See Also