Powercfg 命令列選項

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

Syntax

Powercfg 命令列使用下列語法:

powercfg選項[arguments] [/?]

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

命令列選項

選項 Description
/?,-說明 顯示命令列參數的相關資訊。
/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 或/?

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

語法:

powercfg /?

/list 或/L

列出所有的電源配置。

語法:

powercfg /list

/query 或/Q

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

語法:

powercfg /query [scheme_GUID] [sub_GUID]

如果未提供參數 scheme_GUIDsub_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 或/X

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

語法:

 /change 設定

引數:

設置

  指定下列其中一個選項:

  • 監視-timeout-ac
  • 監視-timeout-dc
  • 磁片-timeout-ac
  • 磁片-timeout-dc
  • 待命-timeout-ac
  • 待命-timeout-dc
  • 休眠-timeout-ac
  • 休眠-超時-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 或/D

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

語法:

 powercfg/delete scheme_GUID

引數:

scheme_GUID

  指定電源配置 GUID。 藉由執行 powercfg/list來傳回電源配置 GUID。

範例:

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

/deletesetting

刪除電源設定。

語法:

 powercfg/deletesetting sub_GUIDsetting_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 或/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_GUIDsub_GUIDsetting_GUIDsetting_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_GUIDsub_GUIDsetting_GUIDsetting_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_nameGUID

引數:

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

  以 SDDL 格式指定有效的安全描述項字串。 您可以藉由執行 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 或/H

啟用或停用休眠功能。此外,也會設定 hiberfile 大小。

語法:

 powercfg/hibernate

 powercfg/hibernate [開啟 ]

 powercfg/hibernate [/size percent_size]

 powercfg/hibernate [/type縮減完整]

引數:

開啟

  啟用休眠功能。

 關閉

  停用休眠功能。

 /size percent_size

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

 /type縮減滿

  指定所需的 hiberfile 類型。 減少的 hiberfile 只支援 hiberboot。

注意

具有自訂預設大小或 HiberFileSizePercent = 40 的 hiberfile > 會被視為完整的 hiberfile。 HiberFileSizePercent 是在 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Power 的登錄中設定。

若要將 hiberfile 類型變更為 [已縮減],作業系統必須管理預設的 hiberfile 大小。 若要這樣做,請執行下列命令:

powercfg/hibernate/size 0

powercfg/hibernate/type 減少

範例:

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

/availablesleepstates 或/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所傳回的名稱。

要求

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

  • 顯示
  • 系統
  • 離開模式

範例:

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 ]

 當電腦閒置且沒有開啟的程式或檔時,應使用 /energy 選項。

引數:

 /output file_name

  指定儲存能源報表 HTML 或 XML 檔案的路徑和檔案名。

 /xml

  將報表檔案格式化為 XML。

 /duration 秒數

  指定觀察系統行為的秒數。 預設值為 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

  指定要分析報告的天數。

範例:

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

  指定要分析報告的天數。

 /transformxml file_name.xml /output file_name.html

  將 Sleepstudy 報表從 XML 轉換為 HTML。

範例:

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

/srumutil

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

語法:

 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

  指定要分析報告的天數。

 /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 或/spr

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

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

語法:

 powercfg/getsecuritydescriptor GUID動作

引數:

 /output file_name

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

 /xml

  將報表儲存為 XML 檔案。

 /duration

  指定要分析報告的天數。

 /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 設定檔支援

現在可以透過 powercfg.exe 自訂重迭電源配置和 PPM 設定檔。 要注意的是,重迭配置現在僅限於自訂會影響效能的設定和省電的取捨。 這目前與 [PPM] 和 [圖形電源設定] 子群組下的設定有關, (具有別名 SUB_PROCESSOR 並 SUB_GRAPHICS 在 powercfg) 中。 嘗試寫入重迭配置下的其他子群組將會產生錯誤訊息。

從覆蓋配置讀取

稍早用來讀取電源配置的 powercfg 命令現在也支援重迭配置,以進行讀取和寫入。

語法:

 powercfg/q overlay_scheme_aliassubgroup_aliassetting_alias

/Q 旗標之後的所有引數都是選擇性的。 如果未指定設定別名,則會列舉指定之重迭配置和子群組下的所有設定。 如果未指定子群組,則會列舉指定之重迭配置下所有子群組的所有設定。 如果未指定重迭配置,則會假設為目前作用中的重迭配置 (如果使用中的) 或目前的電源配置 (如果沒有使用中的) 。

寫入至覆蓋配置

Setacvalueindex 和 setdcvalueindex 命令現在也支援重迭配置。

語法:

 powercfg/setacvalueindex overlay_scheme_aliassubgroup_aliassetting_alias

 powercfg/setdcvalueindex overlay_scheme_aliassubgroup_aliassetting_alias

從 PPM 設定檔讀取

這些命令類似于重迭配置和電源配置的命令,不同之處在于它們會使用/qp 旗標。

語法:

 powercfg/queryprofile overlay_or_power_scheme_aliasprofile_aliassetting_alias

 powercfg/qp overlay_or_power_scheme_aliasprofile_aliassetting_alias

藉由執行相同的 powercfg/aliasesh 命令,即可看見 PPM 設定檔別名。 提供遺漏引數的支援,而且行為類似于遺漏引數,且使用/q 旗標。

寫入 PPM 設定檔

若要寫入 PPM 設定檔,可以使用/setacprofileindex 和/setdcprofileindex 命令。

語法:

 powercfg/setacprofileindex overlay_or_scheme_aliasprofile_aliassetting_alias

 powercfg/setdcprofileindex overlay_or_scheme_aliasprofile_aliassetting_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. 設定。控制項

 /id:選擇性地指定在產生的 XML 中,用於 "ID" 欄位的 GUID 字串。 預設值: 已產生新的 GUID

 /owner:選擇性地在產生的 XML 中指定 "" 欄位的值。 預設值: OEM