| Parameter | Description | OS |
|---|
| XP | Other |
|---|
/l[ist] | Lists all power schemes in the current user's environment. | | |
/q[uery] [''scheme_name''] (XP)
/q[uery] [''Scheme_GUID''] [''Sub_GUID''] | Displays the contents of the specified power scheme. ''scheme_name''<br>''SCHEME_GUID'' | (Optional) Specifies the ''scheme_name''/''GUID'' of the power scheme to display. ''GUID'' can be obtained by using the powercfg /l command. | ''SUB_GUID'' | (Optional) Specifies the ''GUID'' of the subgroup to display. Requires a ''SCHEME_GUID'' to be provided.
If neither ''SCHEME_GUID'' or ''SUB_GUID'' are provided, the settings of the current user's active power scheme are displayed.
If ''SUB_GUID'' is not specified, all settings in the specified power scheme are displayed. | |
| | |
| Creates a power scheme with the specified ''scheme_name''. | | |
/change ''setting'' ''value''<br>/x ''setting'' ''value'' | Modifies a setting value in the current power scheme. ''setting'' | Specifies one of the following settings: style="border:0;margin: 0 auto">monitor-timeout-ac minutes
monitor-timeout-dc minutes
disk-timeout-ac minutes
disk-timeout-dc minutes
standby-timeout-ac minutes
standby-timeout-dc minutes
hibernate-timeout-ac minutes
hibernate-timeout-dc minutes
processor-throttle-ac throttle
processor-throttle-dc throttle | ''value'' | Specifies the value in minutes. | - AC settings are used when the system is on AC power. DC settings on battery power.
- Setting any value to 0 will set the
timeout=Never
throttle = NONE, CONSTANT, DEGRADE, or ADAPTIVE.
| |
| | |
/changename ''GUID'' ''PowerSchemeName'' [''scheme_description''] | Modifies the name of a power scheme and, optionally, the scheme description.| Value | Description |
|---|
''GUID'' | Specifies the GUID of the power scheme | ''name'' | Specifies the name of the power scheme. | ''scheme_description'' | Describes the power scheme. | | If the description is omitted, then only the name will be changed. | |
| | |
/duplicatescheme ''GUID'' [''DestinationGUID''] | Duplicates the specified power scheme. The resulting GUID which represents the new scheme will be displayed.| Value | Description |
|---|
''GUID'' | Specifies a scheme ''GUID''. Obtained by using the powercfg /l command. | ''DestinationGUID'' | Specifies the ''GUID'' where the scheme will be copied. | If <DestinationGUID> is omitted, then a new GUID will be created for the duplicated scheme. | |
| | |
/d[elete] ''scheme_name''
/d[elete] ''GUID'' | Deletes the power scheme with the specified GUID. ''scheme_name''<br>''GUID'' | Specifies the ''scheme_name''/''GUID'' of the scheme. ''GUID'' can be obtained by using the powercfg /l command. | |
| | |
/deletesetting ''Sub_GUID'' ''Setting_GUID'' | Deletes a power setting.| Value | Description |
|---|
''Sub_GUID'' | Specifies the subgroup ''GUID''. | ''Setting_GUID'' | Specifies the power setting ''GUID''. | |
| | |
/s[etactive] ''scheme_name''<br>-s[etactive] ''Scheme_GUID'' | Makes the specified power scheme active on the computer. ''scheme_name''<br>''Scheme_GUID'' | Specifies the scheme ''GUID''. | |
| | |
/getactivescheme | Retrieves the currently active power scheme. | | |
/setacvalueindex ''Scheme_GUID'' ''Sub_GUID'' ''Setting_GUID'' ''SettingIndex'' | Sets a value associated with a specified power setting while the computer is powered by AC power.| Value | Description |
|---|
''Scheme_GUID'' | Specifies a power scheme GUID. Obtained by using the powercfg /l command. | ''Sub_GUID'' | Specifies a subgroup of power setting GUID. Obtained by using the powercfg /q command. | ''Setting_GUID'' | Specifies an individual power setting GUID. Obtained by using the powercfg /q command. | ''SettingIndex'' | Specifies which of the list of possible values this power setting will be set to. | Use the /l and /q options to discover the ''GUID''s | |
| | |
/setdcvalueindex ''Scheme_GUID'' ''Sub_GUID'' ''Setting_GUID'' ''SettingIndex'' | Sets a value associated with a specified power setting while the computer is powered by DC power.| Value | Description |
|---|
''Scheme_GUID'' | Specifies a power scheme GUID. Obtained by using the powercfg /l command. | ''Sub_GUID'' | Specifies a subgroup of power setting ''GUID''. Obtained by using the powercfg /q command. | ''Setting_GUID'' | Specifies an individual power setting''GUID''. Obtained by using the powercfg /q command. | ''SettingIndex'' | Specifies which of the list of possible values this power setting will be set to. | |
| | |
/h[ibernate] [''on''|''off''] | Enables or disables the hibernate feature. Hibernate timeout is not supported on all computers. | | |
/n[umerical] | Specify the power scheme to be operated upon with a numerical identifier.
This switch allows a number to be used in place of the ''scheme_name'' in the following commands: /QUERY, /DELETE, /SETACTIVE, /CHANGE, /EXPORT, and /IMPORT | | |
/g[lobalpowerflag] [''on''|''off'']] | Turn one of the following global power flags on or off:''BatteryIcon'' | Turn the battery meter icon in the system tray on/off. | ''MultiBattery'' | Turns on/off multiple battery display in system Power Meter. | ''ResumePassword'' | Prompt for password on resuming the system. | ''WakeOnRing'' | Turn on/off wake on ring support. | ''VideoDim'' | Turn on/off support for dimming video display on battery power. | |
| | |
/b[atteryalarm] [''low''|''critical''] [''settings''] | Configure the battery alarm.
Settings:/activate [''on''|''off''] | Enable or disable the alarm. | /level [percentage (''0'' – ''100'')] | The alarm will be activated when the power level reaches this percentage. | /text [''on''|''off''] | Turns the text notification on or off. | /sound [''on''|''off''] | Turns the audible notification on or off. | /action [''none''|''shutdown''|''hibernate''|''standby''] | Specifies the action to take when this alarm goes off. Not all actions are always available. | /forceaction [''on''|''off''] | Force stand by or shutdown even if a program stops responding. | /program [''on''|''off''] | Specifies a program to run. schtasks.exe /change may be used to configure the program. | |
| | |
/a[vailablesleepstates] | Reports the sleep states available on the computer. Attempts to report reasons why sleep states are unavailable. | | |
/devicequery [''query_flags'']] | Returns a list of devices that meet the specified flags:''wake_from_S1_supported'' | Returns all devices that support waking the computer from a light sleep state. | ''wake_from_S2_supported'' | Returns all devices that support waking the computer from a deeper sleep state. | ''wake_from_S3_supported'' | Returns all devices that support waking the computer from the deepest sleep state. | ''wake_from_any'' | Returns all devices that support waking the computer from any sleep state. | ''S1_supported'' | Lists devices supporting light sleep. | ''S2_supported'' | Lists devices supporting deeper sleep. | ''S3_supported'' | Lists devices supporting deepest sleep. | ''S4_supported'' | Lists devices supporting hibernation. | ''wake_programmable'' | Lists devices that are user/configurable to wake the computer from a sleep state. | ''wake_armed'' | Lists devices that are currently configured to wake the computer from any sleep state. | ''all_devices'' | Returns all devices present in the computer. | ''all_devices_verbose'' | Returns a verbose list of devices. | |
| | |
/deviceenablewake ''devicename'' | Enables the device to wake the computer from a sleep state. ''devicename'' | Specifies a device retrieved by using the powercfg /devicequery wake_programmable command. | |
| | |
/devicedisablewake <devicename> | Disables the device from waking the computer from a sleep state. ''devicename'' | Specifies a device retrieved by using the powercfg /devicequery wake_armed command. | |
| | |
/import ''scheme_name'' [/FILE ''filename'']<br>-import ''filename'' [''GUID''] | Imports all power settings from the specified file. ''filename'' | Specifies a fully qualified path to a file generated by using the powercfg /export command-line option. | ''GUID'' | (optional) Represents the settings loaded into a power scheme. If not supplied, powercfg will generate and use a new GUID | |
| | |
/export ''scheme_name'' [/FILE ''filename'']<br>-export ''filename'' [''GUID''] | Exports a power scheme, represented by the specified GUID, to the specified file. ''filename'' | Specifies a fully qualified path to a destination file. | ''GUID'' | Specifies a power scheme GUID. Obtained by using the /l command-line option. | |
| | |
/lastwake | Reports information about the event that woke the computer from the last sleep transition. | | |
/aliases | Displays all aliases and their corresponding GUIDs. The user may use these aliases in place of any GUID at the command prompt | | |
/setsecruitydescriptor [''GUID''|''Action''] ''SDDL'' | Sets a security descriptor associated with a specified power setting, power scheme, or action. ''GUID'' | Specifies a power scheme or a power setting GUID. | ''Action'' | Specifies one of the following strings: ActionSetActive, ActionCreate, ActionDefault | ''SDDL'' | Specifies a valid security descriptor string in SDD format. Use powercfg /getsecuritydescriptor to see an example SDDL STRING. | |
| | |
/getsecuritydescriptor [GUID|<Action>] | Gets a security descriptor associated with a specified power setting, power scheme, or action. GUID | Specifies a power scheme or a power setting GUID. | <Action> | Specifies one of the following strings: ActionSetActive, ActionCreate, ActionDefault | |
| | |
/requests | Enumerate application and driver Power Requests. Power requests prevent the computer from automatically powering off the display or entering a low-power sleep mode. | | |
/requestsoverride ''Caller_type'' ''Name'' ''Request'' | Sets a Power Request override for a particular Process, Service, or Driver. If no parameters are specified, this command displays the current list of Power Request Overrides. NOTE: No documentation exists to remove a request override entry once entered, however leaving off the request type will do so. powercfg -requestsoverride Caller_type Name (Request left blank to remove entry)| Value | Description |
|---|
''Caller_type'' | Specifies one of the following caller types: PROCESS, SERVICE, DRIVER. This is obtained by calling the powercfg /requests command. | ''Name'' | Specifies the caller name. This is the name returned from calling powercfg /requests command. | ''Request'' | Specifies one or more of the following Power Request Types: Display, System, Awaymode *Leave blank to remove an entry. | |
| | |
/energy | Analyzes the system for common energy-efficiency and battery life problems. The /energy command should be used when the computer is idle and with no open programs or documents. The /energy command will generate an HTML report file in the current path. Windows 7 and certain Windows 10 Insider builds only.| Value | Description |
|---|
/output ''filename'' | Specifies the path and filename to store the energy report HTML file (default="energy-report.html"). | /xml | Formats the report file as XML. | /trace | Records system behavior and does not perform analysis. Trace files will be generated in the current path unless the /d parameter is specified. | /d ''filepath'' | Specifies the directory to store trace data. May only be used with the /trace parameter. | /duration <seconds> | Specifies the number of seconds to observe system behavior. Default is 60 seconds | |
| | |
| Enumerates the active wake timers. If enabled, the expiration of a wake timer wakes the system from sleep and hibernate states. | | |
| Displays Help at the command prompt. | | | |
The other GUIDs have aliases as well.
