Home > Commands N-Z > Commands P

POWERCFG


Description | Syntax | Parameters | Switches | Related | Notes | Examples | Errorlevels | Availability

Enables an administrator to control the power settings on a system.


Syntax

POWERCFG /?

POWERCFG [/c[reate] name] [/h[ibernate] [ON | OFF]] [/l[ist]] [[/change settings | /x settings] | /d[elete] name | [/e[xport] name [/file file_name]] | [/i[mport] name [/file file_name]] | /q[uery] [name] | /s[etactive] name [/n[umerical]]] [/g[lobalpowerflag] [ON | OFF] /option:{batteryicon | multibattery | resumepassword | wakeonring | videodim}]]


Parameters

none.


Switches
/? (NT2003)
Displays help.
/change settings (NT2003)
/x settings (NT2003)
Changes settings of the specified power scheme. Settings:
/disk-timeout-ac minutes (NT2003)
Turns the hard disks off after the specified number of minutes when the system is operating on AC power. A value of 0 will disable the time-out.
/disk-timeout-dc minutes (NT2003)
Turns the hard disks off after the specified number of minutes when the system is operating on DC (battery) power. A value of 0 will disable the time-out.
/hibernate-timeout-ac minutes (NT2003)
Saves the contents of the computer's memory to disk and turns off the computer after the specified number of minutes when the system is operating on AC power. A value of 0 will disable the time-out.
/hibernate-timeout-dc minutes (NT2003)
Saves the contents of the computer's memory to disk and turns off the computer after the specified number of minutes when the system is operating on DC (battery) power. A value of 0 will disable the time-out.
/monitor-timeout-ac minutes (NT2003)
Turns the monitor off after the specified number of minutes when the system is operating on AC power. A value of 0 will disable the time-out.
/monitor-timeout-dc minutes (NT2003)
Turns the monitor off after the specified number of minutes when the system is operating on DC (battery) power. A value of 0 will disable the time-out.
/processor-throttle-ac value (NT2003)
Selects the dynamic throttling policy to be used, if your microprocessor supports processor performance state controls, when the system is operating on AC power. Dynamic throttling policy values:
  • adaptive Modifies the performance state dynamically based on the demand the system puts on the microprocessor
  • constant Causes the microprocessor to operate at the lowest performance state at all times
  • degrade Causes the microprocessor to operate at the lowest performance state, and further reduces performance by applying stop clock throttling as the system battery drains
    Note: Typically used when the computer is operating on battery power and is therefore seldom used with /processor-throttle-ac.
  • none Causes the microprocessor to operate at the highest performance state at all times
/processor-throttle-dc value (NT2003)
Selects the dynamic throttling policy to be used, if your microprocessor supports processor performance state controls, when the system is operating on DC (battery) power. Dynamic throttling policy values:
  • adaptive Modifies the performance state dynamically based on the demand the system puts on the microprocessor
  • constant Causes the microprocessor to operate at the lowest performance state at all times
  • degrade Causes the microprocessor to operate at the lowest performance state, and further reduces performance by applying stop clock throttling as the system battery drains
  • none Causes the microprocessor to operate at the highest performance state at all times
/standby-timeout-ac minutes (NT2003)
Puts the computer in standby mode after the specified number of minutes when the system is operating on AC power. A value of 0 will disable the time-out.
/standby-timeout-dc minutes (NT2003)
Puts the computer in standby mode after the specified number of minutes when the system is operating on DC (battery) power. A value of 0 will disable the time-out.
/c[reate] name (NT2003)
Creates the specified power scheme. The new scheme is created with the properties of the currently active scheme.
/d[elete] name (NT2003)
Deletes the specified power scheme.
/e[xport] name (NT2003)
Exports the specified power scheme to a file.
/file [file_name] (NT2003)
If omitted, the default file_name is scheme.pow.
When used with import, if a scheme with file_name already exists, it is replaced with the new one.
/g[lobalpowerflag] [ON | OFF] (NT2003)
Turns the global power flag features on or off.
/h[ibernate] [ON | OFF] (NT2003)
Turns the hibernation feature on or off.
/i[mport] name (NT2003)
Imports the power scheme from the specified file.
/l[ist] (NT2003)
Lists the names of existing power schemes.
/n[umerical] (NT2003)
Requires you to specify the power scheme using its numeric identifier, rather than its name.
/option:batteryicon | multibattery | resumepassword | wakeonring | videodim (NT2003)
/g[lobalpowerflag] feature name to turn on or off.
/q[uery] [name] (NT2003)
Displays the configuration of the specified power scheme. If name omitted, the configuration of the currently active power scheme is displayed.
/s[etactive] name (NT2003)
Activates the specified power scheme.

Related

none.


Notes

none.


Examples

none.


Errorlevels

none.


Availability
External
DOS
none
Windows
none
Windows NT
NT2003

Last Updated: 2003/07/28
Direct corrections or suggestions to: Rick Lively