New-CMPowerManagementCustomPlan

模块:

ConfigurationManager

创建自定义电源管理计划。

语法

New-CMPowerManagementCustomPlan
   [-AllowHybridSleepAC <Boolean>]
   [-AllowHybridSleepDC <Boolean>]
   [-AllowStandbyAC <Boolean>]
   [-AllowStandbyDC <Boolean>]
   [-CriticalBatteryAC <PowerSettingAction>]
   [-CriticalBatteryDC <PowerSettingAction>]
   [-Description <String>]
   [-DisplayOffMinAC <Int32>]
   [-DisplayOffMinDC <Int32>]
   [-HardDiskIdleMinAC <Int32>]
   [-HardDiskIdleMinDC <Int32>]
   [-HibernateMinAC <Int32>]
   [-HibernateMinDC <Int32>]
   [-LidDownAC <PowerSettingAction>]
   [-LidDownDC <PowerSettingAction>]
   [-LowBatteryAC <PowerSettingAction>]
   [-LowBatteryDC <PowerSettingAction>]
   [-Name <String>]
   [-NoAllowStandby]
   [-NoCriticalBattery]
   [-NoDisplayOff]
   [-NoHardDiskIdle]
   [-NoHibernate]
   [-NoHybridSleep]
   [-NoLidDown]
   [-NoLowBattery]
   [-NoPowerButton]
   [-NoRequirePasswordOnWake]
   [-NoSleep]
   [-NoSleepButton]
   [-NoSleepIdle]
   [-NoStartButton]
   [-NoWakeOnTimer]
   [-Peak]
   [-PowerButtonAC <PowerSettingAction>]
   [-PowerButtonDC <PowerSettingAction>]
   [-RequirePasswordOnWakeAC <Boolean>]
   [-RequirePasswordOnWakeDC <Boolean>]
   [-SleepButtonAC <PowerSettingAction>]
   [-SleepButtonDC <PowerSettingAction>]
   [-SleepIdlePctAC <Int32>]
   [-SleepIdlePctDC <Int32>]
   [-SleepMinAC <Int32>]
   [-SleepMinDC <Int32>]
   [-StartButtonAC <PowerSettingAction>]
   [-StartButtonDC <PowerSettingAction>]
   [-WakeOnTimerAC <Boolean>]
   [-WakeOnTimerDC <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

New-CMPowerManagementCustomPlan
   [-AllowHybridSleepAC <Boolean>]
   [-AllowHybridSleepDC <Boolean>]
   [-AllowStandbyAC <Boolean>]
   [-AllowStandbyDC <Boolean>]
   [-CriticalBatteryAC <PowerSettingAction>]
   [-CriticalBatteryDC <PowerSettingAction>]
   [-Description <String>]
   [-DisplayOffMinAC <Int32>]
   [-DisplayOffMinDC <Int32>]
   [-HardDiskIdleMinAC <Int32>]
   [-HardDiskIdleMinDC <Int32>]
   [-HibernateMinAC <Int32>]
   [-HibernateMinDC <Int32>]
   [-LidDownAC <PowerSettingAction>]
   [-LidDownDC <PowerSettingAction>]
   [-LowBatteryAC <PowerSettingAction>]
   [-LowBatteryDC <PowerSettingAction>]
   [-Name <String>]
   [-NoAllowStandby]
   [-NoCriticalBattery]
   [-NoDisplayOff]
   [-NoHardDiskIdle]
   [-NoHibernate]
   [-NoHybridSleep]
   [-NoLidDown]
   [-NoLowBattery]
   [-NonPeak]
   [-NoPowerButton]
   [-NoRequirePasswordOnWake]
   [-NoSleep]
   [-NoSleepButton]
   [-NoSleepIdle]
   [-NoStartButton]
   [-NoWakeOnTimer]
   [-PowerButtonAC <PowerSettingAction>]
   [-PowerButtonDC <PowerSettingAction>]
   [-RequirePasswordOnWakeAC <Boolean>]
   [-RequirePasswordOnWakeDC <Boolean>]
   [-SleepButtonAC <PowerSettingAction>]
   [-SleepButtonDC <PowerSettingAction>]
   [-SleepIdlePctAC <Int32>]
   [-SleepIdlePctDC <Int32>]
   [-SleepMinAC <Int32>]
   [-SleepMinDC <Int32>]
   [-StartButtonAC <PowerSettingAction>]
   [-StartButtonDC <PowerSettingAction>]
   [-WakeOnTimerAC <Boolean>]
   [-WakeOnTimerDC <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

说明

New-CMPowerManagementCustomPlan cmdlet 创建自定义电源管理计划。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。

示例

示例 1：为自定义电源管理计划创建参数并将其存储在变量中

PS XYZ:\>$PlanParams = @{
    Name = "test"
    Description = "comments"
    DisplayOffMinAC = 20
    DisplayOffMinDC = 20
    SleepMinAC = 65
    SleepMinDC = 20
    RequirePasswordOnWakeAC = $true
    RequirePasswordOnWakeDC = $false
    PowerButtonAC = "None"
    PowerButtonDC = "Sleep"
    StartButtonAC = "Hibernate"
    StartButtonDC = "Sleep"
    SleepButtonAC= "None"
    SleepButtonDC = "Sleep"
    LidDownAC = "None"
    LidDownDC = "Sleep"
    HardDiskIdleMinAC = 25
    HardDiskIdleMinDC = 10
    HibernateMinAC = 10
    HibernateMinDC = 5
    LowBatteryAC = "None"
    LowBatteryDC = "Sleep"
    CriticalBatteryAC = "None"
    CriticalBatteryDC = "ShutDown"
    AllowHybridSleepAC = $false
    AllowHybridSleepDC = $true
    AllowStandbyAC= $false
    AllowStandbyDC = $true
    SleepIdlePctDC = 10
    SleepIdlePctAC = 15
    WakeOnTimerAC = $true
    WakeOnTimerDC = $false
}

此命令为自定义电源管理计划创建参数及其设置的数组，然后将该数组存储在 $PlanParams 变量中。 此变量现在可用于创建自定义计划。

示例 2：创建自定义峰值电源管理计划以配置设备集合

PS XYZ:\> $PeakPlan = New-CMPowerManagementCustomPlan -Peak @planParams
PS XYZ:\> Set-CMCollectionPowerManagement -CollectionName "deviceCol1" -PeakPlan $PeakPlan

第一个命令使用示例 1 中设置的参数创建自定义峰值电源管理计划对象，然后将其存储在 $PeakPlan 变量中。

第二个命令使用存储在 $PeakPlan 中的自定义计划为名为 deviceCol01 的设备集合配置电源管理设置。

示例 3：创建自定义非峰值电源管理计划来配置设备集合

PS XYZ:\> $NonPeakPlan = New-CMPowerManagementCustomPlan -NonPeak @planParams
PS XYZ:\> Set-CMCollectionPowerManagement -CollectionName "deviceCol2" -NonPeakPlan $NonPeakPlan

第一个命令使用示例 1 中设置的参数创建自定义非峰值电源管理计划对象，然后将其存储在 $NonPeakPlan 变量中。

第二个命令使用存储在 $NonPeakPlan 中的自定义计划来配置名为 deviceCol02 的设备集合的电源管理设置。

参数

-AllowHybridSleepAC

指示在设备接通电源时进入睡眠状态时，Windows 是否保存休眠文件。 休眠文件可用于在计算机进入睡眠状态时断电时还原计算机的状态。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AllowHybridSleepDC

指示当设备使用电池供电运行时进入睡眠状态时，Windows 是否保存休眠文件。 休眠文件可用于在计算机进入睡眠状态时断电时还原计算机的状态。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AllowStandbyAC

指示在设备接通电源时是否允许计算机处于待机状态。 这仍会消耗一些电量，但使计算机能够更快地唤醒。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AllowStandbyDC

指示在设备使用电池电源运行时是否允许计算机处于待机状态。 这仍会消耗一些电量，但使计算机能够更快地唤醒。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CriticalBatteryAC

指定在设备接通电源时，当计算机的电池电量达到指定的严重电池通知时要执行的操作。 有效值包含:

• None
• 睡
• 冬眠
• 关闭

类型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CriticalBatteryDC

指定当设备使用电池供电运行时，当计算机的电池达到指定的严重电池通知时要执行的操作。 有效值包含:

• None
• 睡
• 冬眠
• 关闭

类型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Description

指定电源管理计划的说明。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisplayOffMinAC

指定在设备接通电源时，在显示器关闭之前计算机必须处于非活动状态的时间长度（以分钟为单位）。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisplayOffMinDC

指定在设备使用电池供电运行时，计算机在关闭显示器之前必须处于非活动状态的时间长度（以分钟为单位）。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-HardDiskIdleMinAC

指定在设备接通电源时，计算机硬盘在关闭之前必须处于非活动状态的时间长度（以分钟为单位）。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-HardDiskIdleMinDC

指定在设备使用电池供电运行时，计算机硬盘在关闭之前必须处于非活动状态的时间长度（以分钟为单位）。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-HibernateMinAC

指定在设备接通电源时计算机进入休眠状态之前必须处于非活动状态的时间长度（以分钟为单位）。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-HibernateMinDC

指定在设备使用电池供电运行时，计算机在进入休眠状态之前必须处于非活动状态的时间长度（以分钟为单位）。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LidDownAC

指定当用户在设备接通电源时关闭便携式计算机的机盖时发生的操作。 有效值包含:

• None
• 睡
• 冬眠
• 关闭

类型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LidDownDC

指定当用户在设备使用电池供电时关闭便携式计算机的机盖时发生的操作。 有效值包含:

• None
• 睡
• 冬眠
• 关闭

类型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LowBatteryAC

指定在设备接通电源时，当计算机的电池电量达到指定的低电量通知级别时发生的操作。 有效值包含:

• None
• 睡
• 冬眠
• 关闭

类型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LowBatteryDC

指定在设备使用电池电源运行时，当计算机的电池电量达到指定的电池电量不足通知级别时发生的操作。 有效值包含:

• None
• 睡
• 冬眠
• 关闭

类型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定电源管理计划的名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoAllowStandby

指示此电源管理计划中不包括“睡眠操作时允许待机状态”属性。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoCriticalBattery

指示“关键电池操作”属性未包含在此电源管理计划中。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoDisplayOff

指示“ (分钟后关闭显示) ”属性不包括在此电源管理计划中。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoHardDiskIdle

指示“ (分钟后关闭硬盘) ”属性不包括在此电源管理计划中。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoHibernate

指示“ (分钟后休眠) ”属性不包括在此电源管理计划中。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoHybridSleep

指示“允许混合睡眠”属性未包含在此电源管理计划中。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoLidDown

指示“Lid close action”属性未包含在此电源管理计划中。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoLowBattery

指示“低电池电量操作”属性未包含在此电源管理计划中。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NonPeak

指示这是非高峰计划。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-NoPowerButton

指示“电源按钮操作”属性不包括在此电源管理计划中。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoRequirePasswordOnWake

指示“唤醒时需要密码”属性不包括在此电源管理计划中。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoSleep

指示“ (分钟后睡眠) ”属性不包括在此电源管理计划中。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoSleepButton

指示此电源管理计划中不包括“睡眠按钮操作”属性。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoSleepIdle

指示此电源管理计划中不包括“睡眠所需的空闲 (%) ”属性。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoStartButton

指示“开始”菜单电源按钮“属性不包括在此电源管理计划中。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoWakeOnTimer

指示“为台式计算机启用 Windows 唤醒计时器”属性未包含在此电源管理计划中。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Peak

指示这是高峰计划。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-PowerButtonAC

指定在设备接通电源时按下计算机的电源按钮时执行的操作。 有效值包含:

• None
• 睡
• 冬眠
• 关闭

类型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PowerButtonDC

指定在设备使用电池供电时按下计算机的电源按钮时执行的操作。 有效值包含:

• None
• 睡
• 冬眠
• 关闭

类型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RequirePasswordOnWakeAC

指示当计算机在设备接通电源时从睡眠状态唤醒时是否需要密码才能解锁计算机。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RequirePasswordOnWakeDC

指示当设备使用电池电源运行时，当计算机从睡眠状态唤醒时，是否需要密码才能解锁计算机。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SleepButtonAC

指定在设备接通电源时按下计算机的“睡眠”按钮时发生的操作。 有效值包含:

• None
• 睡
• 冬眠
• 关闭

类型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SleepButtonDC

指定在设备使用电池供电时按下计算机的“睡眠”按钮时发生的操作。 有效值包含:

• None
• 睡
• 冬眠
• 关闭

类型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SleepIdlePctAC

指定设备接通电源时计算机进入睡眠所需的计算机处理器空闲时间百分比。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SleepIdlePctDC

指定设备使用电池电源运行时计算机进入睡眠所需的计算机处理器空闲时间百分比。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SleepMinAC

指定在设备接通电源时计算机进入睡眠状态之前必须处于活动状态的时间长度（以分钟为单位）。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SleepMinDC

指定设备使用电池电源运行时，计算机在进入睡眠状态之前必须处于活动状态的时间长度（以分钟为单位）。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StartButtonAC

指定在设备接通电源时按下计算机的“开始”菜单电源按钮时发生的操作。 有效值包含:

• None
• 睡
• 冬眠
• 关闭

类型:	PowerSettingAction
接受的值:	Sleep, Hibernate, Shutdown
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StartButtonDC

指定在设备使用电池供电时按下计算机的“开始”菜单电源按钮时发生的操作。 有效值包含:

• None
• 睡
• 冬眠
• 关闭

类型:	PowerSettingAction
接受的值:	Sleep, Hibernate, Shutdown
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WakeOnTimerAC

指示在设备接通电源时是否启用内置 Windows 计时器。 电源管理可以使用 Windows 计时器唤醒台式计算机。 当使用 Windows 唤醒计时器唤醒台式计算机时，默认情况下它将保持唤醒状态 10 分钟，以允许计算机有时间安装任何更新或接收策略。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WakeOnTimerDC

指示当设备使用电池供电运行时是否启用内置 Windows 计时器。 电源管理可以使用 Windows 计时器唤醒台式计算机。 当使用 Windows 唤醒计时器唤醒台式计算机时，默认情况下它将保持唤醒状态 10 分钟，以允许计算机有时间安装任何更新或接收策略。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

输出

Microsoft.ConfigurationManagement.AdminConsole.CollectionProperty.PowerSchema

相关链接

• Set-CMCollectionPowerManagement