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 是否保存休眠文件。休眠文件可用于在计算机进入睡眠状态时断电时还原计算机的状态。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowHybridSleepDC

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowStandbyAC

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowStandbyDC

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CriticalBatteryAC

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

无
睡眠
冬眠
关闭

Type:	PowerSettingAction
Accepted values:	None, Sleep, Hibernate, Shutdown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CriticalBatteryDC

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

无
睡眠
冬眠
关闭

Type:	PowerSettingAction
Accepted values:	None, Sleep, Hibernate, Shutdown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayOffMinAC

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayOffMinDC

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HardDiskIdleMinAC

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HardDiskIdleMinDC

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HibernateMinAC

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HibernateMinDC

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LidDownAC

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

无
睡眠
冬眠
关闭

Type:	PowerSettingAction
Accepted values:	None, Sleep, Hibernate, Shutdown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LidDownDC

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

无
睡眠
冬眠
关闭

Type:	PowerSettingAction
Accepted values:	None, Sleep, Hibernate, Shutdown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LowBatteryAC

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

无
睡眠
冬眠
关闭

Type:	PowerSettingAction
Accepted values:	None, Sleep, Hibernate, Shutdown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LowBatteryDC

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

无
睡眠
冬眠
关闭

Type:	PowerSettingAction
Accepted values:	None, Sleep, Hibernate, Shutdown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoAllowStandby

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoCriticalBattery

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoDisplayOff

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoHardDiskIdle

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoHibernate

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoHybridSleep

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoLidDown

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoLowBattery

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NonPeak

指示这是非高峰计划。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoPowerButton

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoRequirePasswordOnWake

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoSleep

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoSleepButton

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoSleepIdle

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoStartButton

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWakeOnTimer

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Peak

指示这是高峰计划。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PowerButtonAC

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

无
睡眠
冬眠
关闭

Type:	PowerSettingAction
Accepted values:	None, Sleep, Hibernate, Shutdown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PowerButtonDC

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

无
睡眠
冬眠
关闭

Type:	PowerSettingAction
Accepted values:	None, Sleep, Hibernate, Shutdown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequirePasswordOnWakeAC

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequirePasswordOnWakeDC

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SleepButtonAC

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

无
睡眠
冬眠
关闭

Type:	PowerSettingAction
Accepted values:	None, Sleep, Hibernate, Shutdown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SleepButtonDC

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

无
睡眠
冬眠
关闭

Type:	PowerSettingAction
Accepted values:	None, Sleep, Hibernate, Shutdown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SleepIdlePctAC

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SleepIdlePctDC

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SleepMinAC

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SleepMinDC

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StartButtonAC

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

无
睡眠
冬眠
关闭

Type:	PowerSettingAction
Accepted values:	Sleep, Hibernate, Shutdown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StartButtonDC

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

无
睡眠
冬眠
关闭

Type:	PowerSettingAction
Accepted values:	Sleep, Hibernate, Shutdown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WakeOnTimerAC

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WakeOnTimerDC

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

None

输出

Microsoft.ConfigurationManagement.AdminConsole.CollectionProperty.PowerSchema

Set-CMCollectionPowerManagement

Share via