Add-SCPowerOptimizationRange

Adds a time range to the power optimization schedule in a dynamic optimization configuration.

Description

The Add-SCPowerOptimizationRange cmdet adds a time range to the power optimization schedule in the dynamic optimization configuration. Power optimization is implemented only during the time ranges that have been added. Otherwise, hosts associated with the dynamic optimization configuration are turned on.

For more information about Add-SCPowerOptimizationRange, type: "Get-Help Add-SCPowerOptimizationRange -online".

Parameters

BeginHour

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the hour of the day that power optimization begins. 

Example format to begin power optimization at 3 AM: -BeginHour 3
Example format to begin power optimization at 5 PM: -BeginHour 17

DynamicOptimizationConfiguration

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a dynamic optimization configuration object.

EndHour

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the hour of the day that power optimization ends.

Example format to end power optimization at 8 AM: -EndHour 7
Example format to end power optimization at 3 PM: -EndHour 14

WeeklyScheduleDayOfWeek

Required? true
Accept Pipeline Input? false
Position? named 
Specifies one or more days of the week to run a job. The default value is the current day of the week. Valid values to specify an individual day by using a string: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday. Valid values to specify a set of days in a week: Any set of two or more days separated by commas. Valid values to specify an individual day by using an integer: 1, 2, 3, 4, 5, 6, 7

Example format: -WeeklyScheduleDayOfWeek “Monday”
Example format: -WeeklyScheduleDayOfWeek “Monday, Wednesday, Friday”
Example format: -WeeklyScheduleDayOfWeek 5 (to specify a Friday)

Requirement: Use with StartTimeOfDay.

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.

Examples

1: Add a time range for power optmization to a dynamic optimization configuration. 
PS C:\> $HostGroup = Get-SCVMHostGroup "HostGroup01"
PS C:\> $DOConfig = Get-SCDynamicOptimizationConfiguration -VMHostGroup $HostGroup
PS C:\> Add-SCPowerOptimizationRange -DynamicOptimizationConfiguration $DOConfig -BeginHour 19 -EndHour 23 -WeeklyScheduleDayOfWeek 0

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

The second command gets the dynamic optimization configuration object for the host group stored in $HostGroup and stores the object in the $DOConfig variable.

The last command adds a time range to the dynamic optimization configuration stored in $DOConfig.

See Also