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

Description

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

指定當裝置插入時，當計算機的電池達到指定的重要電池通知時所要採取的動作。有效值為：

無
睡
冬眠
Shutdown

類型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CriticalBatteryDC

指定當裝置在電池電力上執行時，當計算機的電池達到指定的電池通知時所要採取的動作。有效值為：

無
睡
冬眠
Shutdown

類型:	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

指定當裝置插入時，使用者關閉可攜式電腦的蓋子時所發生的動作。有效值為：

無
睡
冬眠
Shutdown

類型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LidDownDC

指定當裝置以電池電力執行時，使用者關閉可攜式電腦的蓋子時所發生的動作。有效值為：

無
睡
冬眠
Shutdown

類型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LowBatteryAC

指定當裝置插入時，當計算機的電池達到指定的低電池通知層級時，所發生的動作。有效值為：

無
睡
冬眠
Shutdown

類型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LowBatteryDC

指定當裝置以電池電力執行時，計算機的電池達到指定的低電池通知層級時所發生的動作。有效值為：

無
睡
冬眠
Shutdown

類型:	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 關閉動作」屬性不包含在此電源管理計劃中。

類型:	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

指定在插入裝置時按下電腦電源按鈕時所採取的動作。有效值為：

無
睡
冬眠
Shutdown

類型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PowerButtonDC

指定當裝置以電池電力執行時，按下計算機電源按鈕時所採取的動作。有效值為：

無
睡
冬眠
Shutdown

類型:	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

指定當您在裝置插入時按下電腦的 [睡眠] 按鈕時所發生的動作。有效值為：

無
睡
冬眠
Shutdown

類型:	PowerSettingAction
接受的值:	None, Sleep, Hibernate, Shutdown
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SleepButtonDC

指定當裝置以電池電源執行時，按下計算機的 [睡眠] 按鈕時所發生的動作。有效值為：

無
睡
冬眠
Shutdown

類型:	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

指定當您在裝置插入時按下電腦的 [開始] 選單電源按鈕時所發生的動作。有效值為：

無
睡
冬眠
Shutdown

類型:	PowerSettingAction
接受的值:	Sleep, Hibernate, Shutdown
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-StartButtonDC

指定當裝置以電池電源執行時，按下計算機的 [開始] 功能表電源按鈕時所發生的動作。有效值為：

無
睡
冬眠
Shutdown

類型:	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

共用方式為