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.
- batteryicon Enables or disables the battery
meter icon in the notification area. When this flag is
cleared, the battery meter icon is not displayed
- multibattery Enables or disables multiple
battery display in the system Power Meter
- resumepassword Enables or disables the
requirement that the user supply a password when the
system resumes from standby or hibernate
- wakeonring Enables or disables Wake on Ring
support
- videodim Enables or disables support for
dimming the video display when the system changes from
AC power to DC (battery) power
- /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