Powercfg 命令列選項

發行項
07/03/2024

使用 powercfg.exe 來控制「電源計劃」 (也稱為「電源配置」)，以使用可用的睡眠狀態、控制個別裝置的電源狀態，以及分析系統是否有常見的能源效率和電池壽命問題。

語法

Powercfg 命令列使用下列語法：

powercfg /option [arguments] [/?]

其中 option 是下表所列的其中一個選項，而 arguments 是套用至所選選項的一或多個引數。 在命令列中包含 /？ 會顯示指定選項的說明。本主題稍後會詳細說明選項和引數。

命令列選項

選項	描述
/?, -help	顯示命令列參數的相關資訊。
/list, /L	列出所有電源配置。
/query, /Q	顯示電源配置的內容。
/change, /X	修改目前電源配置裡的設定值。
/changename	修改電源配置的名稱和描述。
/duplicatescheme	複製電源配置。
/delete, /D	刪除電源配置。
/deletesetting	刪除電源設定。
/setactive, /S	讓電源配置在系統上變成使用中。
/getactivescheme	擷取目前使用中的電源配置。
/setacvalueindex	設定當系統由 AC 電源供電時，與電源設定相關聯的值。
/setdcvalueindex	設定當系統由 DC 電源供電時，與電源設定相關聯的值。
/import	從檔案匯入所有電源設定。
/export	將電源配置匯出至檔案。
/aliases	顯示所有別名及其對應的 GUID。
/getsecuritydescriptor	取得與指定電源設定、電源配置或動作關聯的安全性描述元。
/setsecuritydescriptor	設定與電源設定、電源配置或動作關聯的安全性描述元。
/hibernate, /H	啟用和停用休眠功能。
/availablesleepstates, /A	報告系統上可用的睡眠狀態。
/devicequery	傳回符合指定條件的裝置清單。
/deviceenableawake	讓裝置能夠將系統從睡眠狀態喚醒。
/devicedisablewake	讓裝置無法將系統從睡眠狀態喚醒。
/lastwake	報告將系統從上次睡眠轉換喚醒的相關資訊。
/waketimers	列舉使用中的喚醒計時器。
/requests	列舉應用程式和驅動程式的電源要求。
/requestsoverride	設定特定程序、服務或驅動程式的電源要求覆寫。
/energy	分析系統是否有常見的能源效率和電池壽命問題。
/batteryreport	產生電池使用量報告。
/sleepstudy	產生診斷系統電源轉換報告。
/srumutil	從系統資源使用量監視器 (SRUM) 傾印能源估計資料。
/systemsleepdiagnostics	產生系統睡眠轉換的診斷報告。
/systempowerreport	產生診斷系統電源轉換報告。

命令列選項描述

下列各節說明 Powercfg 命令列選項和引數。

-help or /?

顯示命令列參數的相關資訊。

語法：

powercfg /?

/list or /L

列出所有電源配置。

語法：

powercfg /list

/query or /Q

顯示指定電源配置的內容。

語法：

powercfg /query [scheme_GUID] [sub_GUID]

如果未提供 scheme_GUID 或 sub_GUID參數，則會顯示目前使用中電源配置的設定。如果未指定 sub_GUID參數，則會顯示指定電源配置中的所有設定。

引數：

scheme_GUID

指定電源配置 GUID。執行 powercfg /list 可傳回電源配置 GUID。

sub_GUID

指定電源設定子群組 GUID。執行 powercfg /query 可傳回電源設定子群組 GUID。

範例：

powercfg /query
powercfg /query 381b4222-f694-41f0-9685-ff5bb260df2e 238c9fa8-0aad-41ed-83f4-97be242c8f20

/change or /X

修改目前電源配置裡的設定值。

語法：

/change 設定值

引數：

setting

指定下列其中一個選項：

monitor-timeout-ac
monitor-timeout-dc
disk-timeout-ac
disk-timeout-dc
standby-timeout-ac
standby-timeout-dc
hibernate-timeout-ac
hibernate-timeout-dc

value

指定新值 (以分鐘為單位)。

範例：

powercfg /change monitor-timeout-ac 5

/changename

修改電源配置的名稱，並選擇性修改其描述。

語法：

powercfg /changename *scheme_GUID * name [description]

引數：

scheme_GUID

指定電源配置 GUID。執行 powercfg /list 可傳回電源配置 GUID。

name

指定電源配置的新名稱。

description

指定電源配置的新描述。如果未指定任何描述，則只會變更名稱。

範例：

powercfg /changename 381b4222-f694-41f0-9685-ff5bb260df2e "Customized Balanced"

/duplicatescheme

複製指定的電源配置。代表新配置的結果 GUID 便會顯示。

語法：

powercfg /duplicatescheme scheme_GUID [destination_GUID]

引數：

scheme_GUID

指定電源配置 GUID。執行 powercfg /list 可傳回電源配置 GUID。

destination_GUID

指定新電源配置的 GUID。若未指定 GUID，則會建立新的 GUID。

範例：

powercfg /duplicatescheme 381b4222-f694-41f0-9685-ff5bb260df2e

/delete or /D

刪除具有指定GUID 的電源配置。

語法：

powercfg /delete scheme_GUID

引數：

scheme_GUID

指定電源配置 GUID。執行 powercfg /list 可傳回電源配置 GUID。

範例：

powercfg /delete 381b4222-f694-41f0-9685-ff5bb260df2e

/deletesetting

刪除電源設定。

語法：

powercfg /deletesetting sub_GUID setting_GUID

引數：

sub_GUID

指定電源設定子群組 GUID。執行 powercfg /query 可傳回電源設定子群組 GUID。

setting_GUID

指定電源設定 GUID。執行 powercfg /query 可傳回電源設定 GUID。

範例：

powercfg /deletesetting 238c9fa8-0aad-41ed-83f4-97be242c8f20 29f6c1db-86da-48c5-9fdb-f2b67b1f44da

/setactive or /S

讓指定的電源配置在系統上變成使用中。

語法：

powercfg /setactive scheme_GUID

引數：

scheme_GUID

指定電源配置 GUID。執行 powercfg /list 可傳回電源配置 GUID。

範例：

powercfg /setactive 381b4222-f694-41f0-9685-ff5bb260df2e

/getactivescheme

擷取目前使用中的電源配置。

語法：

powercfg /getactivescheme

/setacvalueindex

設定當系統由 AC 電源供電時，與指定的電源設定相關聯的值。

語法：

powercfg /setacvalueindex scheme_GUID sub_GUID setting_GUID setting_index

引數：

scheme_GUID

指定電源配置 GUID。執行 powercfg /list 可傳回電源配置 GUID。

sub_GUID

指定電源設定子群組 GUID。執行 powercfg /query 可傳回電源設定子群組 GUID。

setting_GUID

指定電源設定 GUID。執行 powercfg /query 可傳回電源設定 GUID。

setting_index

指定此設定可能的設定值。執行 powercfg /query可傳回可能值清單。

範例：

powercfg /setacvalueindex 381b4222-f694-41f0-9685-ff5bb260df2e 238c9fa8-0aad-41ed-83f4-97be242c8f20 29f6c1db-86da-48c5-9fdb-f2b67b1f44da 0

/setdcvalueindex

設定當系統由 DC 電源供電時，與指定的電源設定相關聯的值。

語法：

powercfg /setdcvalueindex scheme_GUID sub_GUID setting_GUID setting_index

引數：

scheme_GUID

指定電源配置 GUID。執行 powercfg /list 可傳回電源配置 GUID。

sub_GUID

指定電源設定子群組 GUID。執行 powercfg /query 可傳回電源設定子群組 GUID。

setting_GUID

指定電源設定 GUID。執行 powercfg /query 可傳回電源設定 GUID。

setting_index

指定此設定可能的設定值。執行 powercfg /query可傳回可能值清單。

範例：

powercfg /setdcvalueindex 381b4222-f694-41f0-9685-ff5bb260df2e 238c9fa8-0aad-41ed-83f4-97be242c8f20 29f6c1db-86da-48c5-9fdb-f2b67b1f44da 300

/import

從指定的檔案匯入電源配置。

語法：

powercfg /import file_name [GUID]

引數：

file_name

指定執行 powercfg /export 所傳回之檔案的完整路徑。

GUID

指定已匯入配置的 GUID。若未指定 GUID，則會建立新的 GUID。

範例：

powercfg /import c:\scheme.pow

/export

將指定的 GUID 所代表的電源配置匯出至指定的檔案。

語法：

powercfg /export file_name GUID

引數：

file_name

指定目的檔案的完整路徑。

GUID

指定電源配置 GUID。執行 powercfg /list 可傳回電源配置 GUID。

範例：

powercfg /export c:\scheme.pow 381b4222-f694-41f0-9685-ff5bb260df2e

/aliases

顯示別名及其對應 GUID 的清單。在任何命令中，這些別名可用來取代 GUID。

語法：

powercfg /aliases

注意

有些設定不包含別名。如需完整的 GUID 清單，請使用 powercfg /query。

/getsecuritydescriptor

設定與指定電源設定、電源配置或動作相關聯的安全性描述元。

語法：

powercfg /getsecuritydescriptor GUID | 動作

引數：

GUID

指定電源配置或電源設定 GUID。執行 powercfg /list 可傳回電源配置 GUID。執行 powercfg /query 可傳回電源設定 GUID。

action

指定下列其中一個動作：

ActionSetActive
ActionCreate
ActionDefault

範例：

powercfg /getsecuritydescriptor 381b4222-f694-41f0-9685-ff5bb260df2e<br />
powercfg /getsecuritydescriptor ActionSetActive

/setsecuritydescriptor

設定與指定電源設定、電源配置或動作相關聯的安全性描述元。

語法：

powercfg /setsecuritydescriptor GUID | 動作 SDDL

引數：

GUID

指定電源配置或電源設定 GUID。執行 powercfg /list 可傳回電源配置 GUID。執行 powercfg /query 可傳回電源設定 GUID。

action

指定下列其中一個動作：

ActionSetActive
ActionCreate
ActionDefault

SDDL

以 SDD 格式指定有效的安全性描述元字串。執行 powercfg /getsecuritydescriptor，可以取得範例 SDDL 字串。

範例：

powercfg /setsecuritydescriptor 381b4222-f694-41f0-9685-ff5bb260df2e O:BAG:SYD:P(A;CI;KRKW;;;BU)(A;CI;KA;;;BA)(A;CI;KA;;;SY)(A;CI;KA;;;CO)<br />

powercfg /setsecuritydescriptor ActionSetActive O:BAG:SYD:P(A;CI;KR;;;BU)(A;CI;KA;;;BA)(A;CI;KA;;;SY)(A;CI;KA;;;CO)

/hibernate or /H

啟用或停用休眠功能；此外，也會設定 Hiberfile 大小。

語法：

powercfg /hibernate

powercfg /hibernate [ on | off ]

powercfg /hibernate [ /size percent_size]

powercfg /hibernate [ /type reduced | full ]

引數：

開啟

啟用休眠功能。

關閉

停用休眠功能。

/size percent_size

指定所需的 Hiberfile 大小 (以總記憶體大小的百分比表示)。預設大小不得小於 50。此參數也會導致啟用休眠。

/type 精簡 | 完整

指定所需的 Hiberfile 類型。縮減的 Hiberfile 僅支援 Hiberboot。

注意

具有自定義預設大小的hiberfile或HiberFileSizePercent >= 40，會被視為完整的休眠檔案。 HiberFileSizePercent 已設定於 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Power 中的登錄中。

若要將 Hiberfile 類型變更為 reduced，作業系統必須管理預設 Hiberfile 大小。若要執行這項操作，請執行下列命令：

powercfg /hibernate /size 0

powercfg /hibernate /type reduced

範例：

powercfg /hibernate off<br /> powercfg /hibernate /size 100<br /> powercfg /hibernate /type reduced

/availablesleepstates or /A

報告系統上可用的睡眠狀態。嘗試報告無法使用睡眠狀態的原因。

語法：

powercfg /availablesleepstates

/devicequery

傳回符合指定條件的裝置清單。

語法：

powercfg /devicequery query_flag

引數：

query_flag

指定下列其中一個條件：

wake_from_S1_supported傳回支援從輕睡眠狀態喚醒系統的所有裝置。

wake_from_S2_supported 傳回支援從更深層睡眠狀態喚醒系統的所有裝置。

wake_from_S3_supported傳回支援從最深睡眠狀態喚醒系統的所有裝置。

wake_from_any傳回支援從任何睡眠狀態喚醒系統的所有裝置。

S1_supported 列出支援輕睡眠的裝置。

S2_supported 列出支援更深層睡眠的裝置。

S3_supported 列出支援最深睡眠的裝置。

S4_supported 列出支援休眠的裝置。

wake_programmable 列出用戶可設定的裝置，以從睡眠狀態喚醒系統。

wake_armed 列出目前設定為從任何睡眠狀態喚醒系統的裝置。

all_devices傳回系統中所有裝置。

範例：

powercfg /devicequery wake_armed

/deviceenableawake

讓指定的裝置能夠將系統從睡眠狀態喚醒。

語法：

powercfg /deviceenableawake device_name

引數：

device_name

指定裝置。您可使用 powercfg /devicequery wake_programmable 來擷取此裝置名稱。

範例：

powercfg /deviceenableawake &quot;Microsoft USB IntelliMouse Optical&quot;

/devicedisablewake

讓指定的裝置無法將系統從睡眠狀態喚醒。

語法：

powercfg /devicedisablewake device_name

引數：

device_name

指定裝置。您可使用 powercfg /devicequery wake_armed 來擷取此裝置名稱。

範例：

powercfg /devicedisablewake &quot;Microsoft USB IntelliMouse Optical&quot;

/lastwake

報告將系統從上次睡眠轉換喚醒的相關資訊。

語法：

powercfg /lastwake

/waketimers

列舉使用中的喚醒計時器。若已啟用，喚醒計時器到期會將系統從睡眠和休眠狀態喚醒。

語法：

powercfg /waketimers

/requests

列舉應用程式和驅動程式的電源要求。電源要求會防止電腦自動關閉顯示器電源或進入低功耗睡眠模式。

語法：

powercfg /requests

/requestsoverride

設定特定程序、服務或驅動程式的電源要求覆寫。若未指定任何參數，此命令會顯示目前的電源要求覆寫清單。

語法：

powercfg /requestsoverride [caller_type名稱要求]

引數：

Caller_type

指定下列其中一個呼叫端類型：進程、服務、 驅動程式。這是藉由執行 powercfg /requests 取得。

name

指定呼叫者名稱。這是藉由執行 powercfg /requests 所傳回的名稱。

request

指定下列一或多個電源要求類型：

顯示器
系統
Awaymode

範例：

powercfg /requestsoverride process wmplayer.exe display system

/energy

分析系統是否有常見的能源效率和電池壽命問題，並在目前的路徑中產生一份報告 (HTML 檔案)。

語法：

powercfg /energy [ /output file_name] [ /xml ] [ /duration seconds ]

powercfg /energy /trace [ /d file_path] [ /xml ] [ /duration seconds]

當計算機閑置且沒有開啟的程式或檔時，應該使用 /energy 選項。

引數：

/output file_name

指定用來儲存能源報告 HTML 或 XML 檔案的路徑和檔案名稱。

/xml

將報告檔案格式化為 XML。

/duration seconds

指定要觀察系統行為的秒數。預設值為 60 秒。

/trace

記錄系統行為，但不執行分析。除非指定了 /D 參數，否則會在目前的路徑中產生追蹤檔案。

/d file_path

指定要儲存追蹤資料的目錄。只能與 /trace 參數搭配使用。

範例：

powercfg /energy<br />
powercfg /energy /output &quot;longtrace.html&quot; /duration 120

/batteryreport

產生系統存留期內的電池使用特性報告。執行 powercfg /batteryreport 可在目前的路徑中產生 HTML 報告檔案。

語法：

powercfg /batteryreport [ /output file_name ] [ /xml ]

powercfg /batteryreport [ /duration days ]

引數：

/output file_name

指定用來儲存電池報告 HTML 的路徑和檔案名稱。

/output file_name /xml

將電池報告檔案格式化為 XML。

/duration days

指定要針對報告分析的天數。

範例：

powercfg /batteryreport /output &quot;batteryreport.html&quot;<br />
powercfg /batteryreport /duration 4

/sleepstudy

在系統的過去三天內產生新式待命品質的診斷報告。此報告是儲存在目前路徑中的檔案。

語法：

powercfg /sleepstudy [ /output file_name ] [ /xml ]

powercfg /sleepstudy [ /duration days]

powercfg /sleepstudy [ /transformxmL file_name.xml ] [ /output file_name.html ]

引數：

/output file_name

指定用來儲存 Sleepstudy 報告 HTML 的路徑和檔案名稱。

/output file_name /xml

將 Sleepstudy 報告檔案格式化為 XML。

/duration days

指定要針對報告分析的天數。

/transformxml file_name.xml /output file_name.html

將 Sleepstudy 報告從 XML 轉換為 HTML。

範例：

powercfg /sleepstudy /output &quot;sleepstudy.html&quot;<br />
powercfg /sleepstudy /duration 7

/srumutil

在 XML 或 CSV 檔案中列舉系統資源使用量監視器 (SRUM) 中的完整能源估計資料。

語法：

powercfg /srumutil [ /output file_name ] [ /xml ] [ /csv ]

引數：

/output file_name

指定用來儲存 SRUM 資料的路徑和檔案名稱。

/output file_name /xml

將檔案格式化為 XML。

/output file_name /csv

將檔案格式化為 CSV。

範例：

powercfg /batteryreport /output &quot;srumreport.xml&quot; /xml

/systemsleepdiagnostics

當使用者在過去三天內未出現在系統上，而且系統進入睡眠狀態時，產生間隔報告。此選項會在目前的路徑中產生報告 (HTML 檔案)。

此命令需要系統管理員權限，而且必須從提高權限的命令提示字元執行。

語法：

powercfg /systemsleepdiagnostics [ /output file_name ] [ /xml ]

引數：

/output file_name

指定診斷報告的路徑和檔案名稱。

/xml

將報告儲存為 XML 檔案。

/duration days

指定要針對報告分析的天數。

/transformxml file_name

從先前以 XML 格式建立的報告，產生 HTML 格式的報告。

範例：

powercfg /systemsleepdiagnostics<br/>
powercfg /systemsleepdiagnostics /output &quot;system-sleep-diagnostics.html&quot;<br/>
powercfg /systemsleepdiagnostics /output &quot;system-sleep-diagnostics.xml&quot; /XML<br/>
powercfg /systemsleepdiagnostics /transformxml &quot;system-sleep-diagnostics.xml&quot;

/systempowerreport or /spr

在系統上產生過去三天內的系統電源轉換報告，包括已連線的待命電源效率。此選項會在目前的路徑中產生報告 (HTML 檔案)。

此命令需要系統管理員權限，而且必須從提高權限的命令提示字元執行。

語法：

powercfg /getsecuritydescriptor GUID | 動作

引數：

/output file_name

指定診斷報告的路徑和檔案名稱。

/xml

將報告儲存為 XML 檔案。

/duration days

指定要針對報告分析的天數。

/transformxml file_name

從先前以 XML 格式建立的報告，產生 HTML 格式的報告。

範例：

powercfg /systempowerreport<br/>
powercfg /systempowerreport /output &quot;sleepstudy.html&quot;<br/>
powercfg /systempowerreport /output &quot;sleepstudy.xml&quot; /XML<br/>
powercfg /systempowerreport /transformxml &quot;sleepstudy.xml&quot;

覆迭配置和 PPM 配置文件支援

重疊電源配置和 PPM 配置檔現在可以透過powercfg.exe來自定義。請務必注意，重迭配置現在僅限於自定義會影響效能與省電取捨的設定。這目前與 PPM 和圖形電源設定子群組下的設定相關（在 powercfg 中使用別名SUB_PROCESSOR和SUB_GRAPHICS）。嘗試寫入覆迭配置下的其他子群組會導致錯誤訊息。

從重疊配置讀取

先前用來讀取電源配置的 powercfg 命令現在也支援覆迭配置，以及讀取和寫入。

語法：

powercfg /q overlay_scheme_alias subgroup_alias setting_alias

/q 旗標之後的所有自變數都是選擇性的。如果未指定設定別名，則會列舉所指定重疊配置和子群組下的所有設定。如果未指定子群組，則會列舉所指定重疊配置下所有子群組的所有設定。如果未指定重疊配置，則會假設它是目前作用中的重疊配置（如果使用中）或目前的電源配置（如果沒有重迭作用中）。

寫入重疊配置

命令 setacvalueindex 和 setdcvalueindex 現在也支援重疊配置。

語法：

powercfg /setacvalueindex overlay_scheme_alias subgroup_alias setting_alias 值

powercfg /setdcvalueindex overlay_scheme_alias subgroup_alias setting_alias 值

從 PPM 設定檔讀取

這些命令與重疊配置和電源配置類似，不同之處在於它們使用 /qp 旗標。

語法：

powercfg /queryprofile overlay_or_power_scheme_alias profile_alias setting_alias

powercfg /qp overlay_or_power_scheme_alias profile_alias setting_alias

PPM 配置檔別名可藉由執行相同的 powercfg /aliasesh 命令來顯示。提供遺漏自變數的支援，而且行為類似於遺漏自變數且使用 /q 旗標時的行為。

寫入 PPM 設定檔

若要寫入 PPM 配置檔，可以使用 /setacprofileindex 和 /setdcprofileindex 命令。

語法：

powercfg /setacprofileindex overlay_or_scheme_alias profile_alias setting_alias 值

powercfg /setdcprofileindex overlay_or_scheme_alias profile_alias setting_alias 值

列舉非空白 PPM 配置檔

列舉至少已明確設定一個電源設定值的 PPM 配置檔。

語法：

powercfg /listprofiles

powercfg /lp

布建 XML 產生支援

Powercfg 現在支援自動產生布建 XML 檔案，該檔案可作為 Windows 設定設計工具的輸入，以產生包含受測裝置自定義設定的布建套件（.ppkg）。此檔案包含裝置上具有「RUNTIME_OVERRIDE」高度值的所有設定。

語法：

powercfg /pxml /output output_file_path

powercfg /pxml /output output_file_path /version version_number /name package_name /id GUID /owner OwnerType_value

必要自變數：

/output_file_path：指定所產生 XML 的位置和名稱。

選擇性自變數：

/version：選擇性地指定所產生 XML 中 “Version” 字段的值。默認值： 1.0

/name：選擇性地指定所產生 XML 中 “Name” 字段的值。默認值： CustomOEM.Power.Settings.Control

/id：選擇性地指定在所產生 XML 的 “ID” 字段中使用的 GUID 字串。預設值： 產生新的 GUID

/owner：選擇性地指定所產生 XML 中 “OwnerType” 欄位的值。預設值： OEM

共用方式為

Powercfg 命令列選項

語法

命令列選項

命令列選項描述

-help or /?

/list or /L

/query or /Q

/change or /X

/changename

/duplicatescheme

/delete or /D

/deletesetting

/setactive or /S

/getactivescheme

/setacvalueindex

/setdcvalueindex

/import

/export

/aliases

/getsecuritydescriptor

/setsecuritydescriptor

/hibernate or /H

/availablesleepstates or /A

/devicequery

/deviceenableawake

/devicedisablewake

/lastwake

/waketimers

/requests

/requestsoverride

/energy

/batteryreport

/sleepstudy

/srumutil

/systemsleepdiagnostics

/systempowerreport or /spr

覆迭配置和 PPM 配置文件支援

從重疊配置讀取

寫入重疊配置

從 PPM 設定檔讀取

寫入 PPM 設定檔

列舉非空白 PPM 配置檔

布建 XML 產生支援

其他資源