Параметры командной строки Powercfg
Используйте powercfg.exe для управления планами питания ( также называемыми схемами питания) для использования доступных состояний сна, управления состояниями питания отдельных устройств, а также для анализа системы для распространенных проблем с эффективностью энергетики и батареи.
Синтаксис
Командные строки Powercfg используют следующий синтаксис:
параметр powercfg /[аргументы] [/?]
Где параметр является одним из параметров, перечисленных в следующей таблице, и аргументы являются одним или несколькими аргументами , которые применяются к выбранному параметру. В том числе /? в командной строке отображается справка по указанному параметру. Параметры и аргументы подробно описаны далее в этом разделе.
Параметры командной строки
Вариант | Описание |
---|---|
/?-Справка | Отображает сведения о параметрах командной строки. |
/list, /L | Перечисляет все схемы питания. |
/query, /Q | Отображает содержимое схемы питания. |
/change, /X | Изменяет значение параметра в текущей схеме питания. |
/changename | Изменяет имя и описание схемы питания. |
/duplicatescheme | Дублирует схему питания. |
/delete, /D | Удаляет схему питания. |
/deletesetting | Удаляет параметр питания. |
/setactive, /S | Делает схему питания активной в системе. |
/getactivescheme | Извлекает текущую активную схему питания. |
/setacvalueindex | Задает значение, связанное с параметром питания, в то время как система работает с питанием AC. |
/setdcvalueindex | Задает значение, связанное с параметром питания, в то время как система работает с питанием контроллера домена. |
/импорт | Импортирует все параметры питания из файла. |
/экспорт | Экспорт схемы питания в файл. |
/Псевдонимы | Отображает все псевдонимы и соответствующие идентификаторы GUID. |
/getsecuritydescriptor | Возвращает дескриптор безопасности, связанный с указанным параметром питания, схемой питания или действием. |
/setsecuritydescriptor | Задает дескриптор безопасности, связанный с параметром питания, схемой питания или действием. |
/hibernate, /H | Включает и отключает функцию гибернации. |
/availablesleepstates, /A | Сообщает о состояниях сна, доступных в системе. |
/devicequery | Возвращает список устройств, удовлетворяющих указанным критериям. |
/deviceenableawake | Позволяет устройству проснуть систему из состояния спящего режима. |
/devicedisablewake | Отключает устройство от пробуждения системы из состояния спящего режима. |
/lastwake | Сообщает сведения о том, что проснулась система от последнего перехода сна. |
/waketimers | Перечисляет активные таймеры пробуждения. |
/Запросы | Перечисляет приложения и драйвер Power Requests. |
/requestsoverride | Задает переопределение Power Request для определенного процесса, службы или драйвера. |
/энергия | Анализирует систему для распространенных проблем с эффективностью энергии и заряда батареи. |
/batteryreport | Создает отчет об использовании батареи. |
/sleepstudy | Создает отчет о переходе питания системы диагностики. |
/srumutil | Дамп данных оценки энергии из монитора использования системных ресурсов (SRUM). |
/systemsleep диагностика | Создает диагностический отчет о переходе в спящий режим системы. |
/systempowerreport | Создает отчет о переходе питания системы диагностики. |
Описания параметров командной строки
В следующих разделах описаны параметры и аргументы командной строки Powercfg.
-help или /?
Отображает сведения о параметрах командной строки.
Синтаксис
powercfg /?
/list или /L
Перечисляет все схемы питания.
Синтаксис
powercfg /list
/query или /Q
Отображает содержимое указанной схемы питания.
Синтаксис
powercfg /query [
scheme_GUID
] [
sub_GUID
]
Если параметр scheme_GUID или sub_GUID не указан, отображаются параметры текущей активной схемы питания. Если параметр sub_GUID не указан, отображаются все параметры в указанной схеме питания.
Аргументы.
scheme_GUID
Указывает GUID схемы питания. При выполнении powercfg /list возвращается GUID схемы питания.
sub_GUID
Указывает GUID подгруппы параметров питания. Guid подгруппы параметров питания возвращается путем выполнения powercfg /query.
Примеры:
powercfg /query
powercfg /query 381b4222-f694-41f0-9685-ff5bb260df2e 238c9fa8-0aad-41ed-83f4-97be242c8f20
/change или /X
Изменяет значение параметра в текущей схеме питания.
Синтаксис
/change setting value
Аргументы.
оправа
Указывает один из следующих параметров:
- monitor-timeout-ac
- monitor-timeout-dc
- disk-timeout-ac
- disk-timeout-dc
- резервный тайм-аут-ac
- резервный тайм-аут-dc
- hibernate-timeout-ac
- hibernate-timeout-dc
значение
Задает новое значение в минутах.
Примеры:
powercfg /change monitor-timeout-ac 5
/changename
Изменяет имя схемы питания и при необходимости его описание.
Синтаксис
powercfg /changename *scheme_GUID * name [description]
Аргументы.
scheme_GUID
Указывает GUID схемы питания. При выполнении powercfg /list возвращается GUID схемы питания.
name
Указывает новое имя схемы питания.
описание
Задает новое описание схемы питания. Если описание не указано, изменится только имя.
Примеры:
powercfg /changename 381b4222-f694-41f0-9685-ff5bb260df2e "Customized Balanced"
/duplicatescheme
Дублирует указанную схему питания. Отображается результирующий GUID, представляющий новую схему.
Синтаксис
powercfg /duplicatescheme scheme_GUID [destination_GUID]
Аргументы.
scheme_GUID
Указывает GUID схемы питания. GUID схемы питания возвращается путем запуска powercfg /list.
destination_GUID
Указывает GUID новой схемы питания. Если guid не указан, создается новый GUID.
Примеры:
powercfg /duplicatescheme 381b4222-f694-41f0-9685-ff5bb260df2e
/delete или /D
Удаляет схему питания с указанным GUID.
Синтаксис
powercfg /delete scheme_GUID
Аргументы.
scheme_GUID
Указывает GUID схемы питания. GUID схемы питания возвращается путем запуска powercfg /list.
Примеры:
powercfg /delete 381b4222-f694-41f0-9685-ff5bb260df2e
/deletesetting
Удаляет параметр питания.
Синтаксис
powercfg /deletesetting sub_GUID setting_GUID
Аргументы.
sub_GUID
Указывает GUID подгруппы параметров питания. Guid подгруппы параметров питания возвращается путем выполнения powercfg /query.
setting_GUID
Указывает GUID параметра питания. Guid параметра питания возвращается путем выполнения powercfg /query.
Примеры:
powercfg /deletesetting 238c9fa8-0aad-41ed-83f4-97be242c8f20 29f6c1db-86da-48c5-9fdb-f2b67b1f44da
/setactive или /S
Делает указанную схему питания активной в системе.
Синтаксис
powercfg /setactive scheme_GUID
Аргументы.
scheme_GUID
Указывает GUID схемы питания. GUID схемы питания возвращается путем запуска powercfg /list.
Примеры:
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 схемы питания. GUID схемы питания возвращается путем запуска powercfg /list.
sub_GUID
Указывает GUID подгруппы параметров питания. При выполнении powercfg /query возвращается GUID подгруппы параметров питания.
setting_GUID
Указывает GUID параметра питания. Guid параметра питания возвращается путем выполнения powercfg /query.
setting_index
Указывает, какое возможное значение этого параметра задано. Список возможных значений возвращается с помощью powercfg /query.
Примеры:
powercfg /setacvalueindex 381b4222-f694-41f0-9685-ff5bb260df2e 238c9fa8-0aad-41ed-83f4-97be242c8f20 29f6c1db-86da-48c5-9fdb-f2b67b1f44da 0
/setdcvalueindex
Задает значение, связанное с указанным параметром питания, в то время как система работает с питанием контроллера домена.
Синтаксис
powercfg /setdcvalueindex scheme_GUID sub_GUID setting_GUID setting_index
Аргументы.
scheme_GUID
Указывает GUID схемы питания. GUID схемы питания возвращается путем запуска powercfg /list.
sub_GUID
Указывает GUID подгруппы параметров питания. Guid подгруппы параметров питания возвращается путем выполнения powercfg /query.
setting_GUID
Указывает GUID параметра питания. Guid параметра питания возвращается путем выполнения powercfg /query.
setting_index
Указывает, какое возможное значение этого параметра задано. Список возможных значений возвращается с помощью powercfg /query.
Примеры:
powercfg /setdcvalueindex 381b4222-f694-41f0-9685-ff5bb260df2e 238c9fa8-0aad-41ed-83f4-97be242c8f20 29f6c1db-86da-48c5-9fdb-f2b67b1f44da 300
/импорт
Импортирует схему питания из указанного файла.
Синтаксис
powercfg /import file_name [GUID]
Аргументы.
file_name
Указывает полный путь к файлу, возвращенный с помощью powercfg /export.
GUID
Указывает GUID для импортированной схемы. Если guid не указан, создается новый GUID.
Примеры:
powercfg /import c:\scheme.pow
/экспорт
Экспортирует схему питания, представленную указанным GUID, в указанный файл.
Синтаксис
POWERCFG /export file_name GUID
Аргументы.
file_name
Указывает полный путь к целевому файлу.
GUID
Указывает GUID схемы питания. GUID схемы питания возвращается путем запуска powercfg /list.
Примеры:
powercfg /export c:\scheme.pow 381b4222-f694-41f0-9685-ff5bb260df2e
/Псевдонимы
Отображает список псевдонимов и соответствующие идентификаторы GUID. Эти псевдонимы можно использовать вместо GUID в любой команде.
Синтаксис
powercfg /aliases
Примечание.
Некоторые параметры не содержат псевдонимов. Для полного списка идентификаторов GUID используйте powercfg /query.
/getsecuritydescriptor
Возвращает дескриптор безопасности, связанный с указанным параметром питания, схемой питания или действием.
Синтаксис
Действие GUID powercfg | /getsecuritydescriptor
Аргументы.
GUID
Указывает схему питания или GUID параметра питания. GUID схемы питания возвращается путем запуска powercfg /list. Guid параметра питания возвращается путем выполнения powercfg /query.
action
Указывает одно из следующих действий:
- ActionSetActive
- ActionCreate
- ActionDefault
Примеры:
powercfg /getsecuritydescriptor 381b4222-f694-41f0-9685-ff5bb260df2e<br />
powercfg /getsecuritydescriptor ActionSetActive
/setsecuritydescriptor
Задает дескриптор безопасности, связанный с указанным параметром питания, схемой питания или действием.
Синтаксис
powercfg /setsecuritydescriptor GUID action | SDDL
Аргументы.
GUID
Указывает схему питания или GUID параметра питания. GUID схемы питания возвращается путем запуска powercfg /list. Guid параметра питания возвращается путем выполнения powercfg /query.
action
Указывает одно из следующих действий:
- ActionSetActive
- ActionCreate
- ActionDefault
SDDL
Указывает допустимую строку дескриптора безопасности в формате SDDL. Пример строки SDDL можно получить, выполнив powercfg /getsecuritydescriptor.
Примеры:
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
Включает или отключает функцию гибернации; также задает размер гиберфайла.
Синтаксис
powercfg /hibernate
powercfg /hibernate [ on | off ]
powercfg /hibernate [ /size percent_size]
powercfg /hibernate [ /type reduced | full ]
Аргументы.
Вкл.
Включает функцию гибернации.
Выключено
Отключает функцию гибернации.
/size percent_size
Указывает требуемый размер гиберфайла в процентах от общего размера памяти. Размер по умолчанию не может быть меньше 50. Этот параметр также приводит к включению гибернации.
/type сокращен полный |
Указывает нужный тип гиберфайла. Сокращенный гиберфайл поддерживает только гибербот.
Примечание.
Гиберфайл, имеющий настраиваемый размер по умолчанию или HiberFileSizePercent >= 40, считается полным гиберфайлом. HiberFileSizePercent устанавливается в реестре в HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Power.
Чтобы изменить тип гиберфайла на уменьшенный, ОС должна управлять размером гиберфайлов по умолчанию. Для этого выполните следующие команды.
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 "Microsoft USB IntelliMouse Optical"
/devicedisablewake
Отключает указанное устройство от пробуждения системы из состояния спящего режима.
Синтаксис
powercfg /devicedisablewake device_name
Аргументы.
device_name
Указывает устройство. Это имя устройства можно получить с помощью powercfg /devicequery wake_armed.
Примеры:
powercfg /devicedisablewake "Microsoft USB IntelliMouse Optical"
/lastwake
Сообщает сведения о том, что проснулась система от последнего перехода сна.
Синтаксис
powercfg /lastwake
/waketimers
Перечисляет активные таймеры пробуждения. Если этот параметр включен, срок действия таймера пробуждения просыпается от состояний спящего режима и гибернации.
Синтаксис
powercfg /waketimers
/Запросы
Перечисляет приложения и драйвер Power Requests. Запросы на питание не позволяют компьютеру автоматически отключать экран или вводить режим спящего режима с низким питанием.
Синтаксис
powercfg /requests
/requestsoverride
Задает переопределение Power Request для определенного процесса, службы или драйвера. Если параметры не указаны, эта команда отображает текущий список переопределения Power Request.
Синтаксис
powercfg /requestoverride [запрос имени caller_type]
Аргументы.
Caller_type
Указывает один из следующих типов вызывающего объекта: процесс, служба, драйвер. Это получается путем запуска powercfg /requests.
name
Указывает имя вызывающего объекта. Это имя, возвращаемое с помощью powercfg /requests.
request
Указывает один или несколько следующих типов Power Request:
- Отображать
- Системные
- Awaymode
Примеры:
powercfg /requestsoverride process wmplayer.exe display system
/энергия
Анализирует систему для распространенных проблем с эффективностью энергии и батареей и создает отчет, HTML-файл в текущем пути.
Синтаксис
powercfg /energy [ /output file_name] [ /xml ] [ /длительность секунд ]
powercfg /energy /trace [ /d file_path] [ /xml ] [ /длительность секунд]
Параметр /energy следует использовать, если компьютер неактивен и не имеет открытых программ или документов.
Аргументы.
/output file_name
Укажите путь и имя файла для хранения HTML-файла отчета энергии или XML-файла.
/xml
Форматирует файл отчета как XML.
/duration в секундах
Указывает количество секунд для наблюдения за системным поведением. По умолчанию значение 60 секунд.
/след
Записывает системное поведение и не выполняет анализ. Файлы трассировки создаются в текущем пути, если параметр /D не указан.
/d file_path
Укажите каталог для хранения данных трассировки. Может использоваться только с параметром /trace .
Примеры:
powercfg /energy<br />
powercfg /energy /output "longtrace.html" /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 "batteryreport.html"<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
Укажите путь и имя файла для хранения HTML-кода отчета Sleepstudy.
/output file_name /xml
Форматирует файл отчета Sleepstudy в формате XML.
/duration days
Указывает количество дней для анализа отчета.
/transformxml file_name.xml /output file_name.html
Преобразует отчет Sleepstudy из XML в HTML.
Примеры:
powercfg /sleepstudy /output "sleepstudy.html"<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 "srumreport.xml" /xml
/systemsleep диагностика
Создает отчет о интервалах, когда пользователь не присутствовал за последние три дня в системе, и если система пошла в спящий режим. Этот параметр создает отчет, HTML-файл в текущем пути.
Эта команда требует прав администратора и должна выполняться из командной строки с повышенными привилегиями.
Синтаксис
powercfg /systemsleep диагностика [ /output file_name ] [ /xml ]
Аргументы.
/output file_name
Указывает путь и имя файла отчета диагностика.
/xml
Сохраните отчет в виде XML-файла.
/duration days
Указывает количество дней для анализа отчета.
/transformxml file_name
Создает отчет в HTML из отчета, созданного ранее в XML.
Примеры:
powercfg /systemsleepdiagnostics<br/>
powercfg /systemsleepdiagnostics /output "system-sleep-diagnostics.html"<br/>
powercfg /systemsleepdiagnostics /output "system-sleep-diagnostics.xml" /XML<br/>
powercfg /systemsleepdiagnostics /transformxml "system-sleep-diagnostics.xml"
/systempowerreport или /spr
Создает отчет о переходе питания системы за последние три дня в системе, включая подключенную резервную эффективность питания. Этот параметр создает отчет, HTML-файл в текущем пути.
Эта команда требует прав администратора и должна выполняться из командной строки с повышенными привилегиями.
Синтаксис
Действие GUID powercfg | /getsecuritydescriptor
Аргументы.
/output file_name
Указывает путь и имя файла отчета диагностика.
/xml
Сохраните отчет в виде XML-файла.
/duration days
Указывает количество дней для анализа отчета.
/transformxml file_name
Создает отчет в HTML из отчета, созданного ранее в XML.
Примеры:
powercfg /systempowerreport<br/>
powercfg /systempowerreport /output "sleepstudy.html"<br/>
powercfg /systempowerreport /output "sleepstudy.xml" /XML<br/>
powercfg /systempowerreport /transformxml "sleepstudy.xml"
Поддержка схемы наложения и профиля PPM
Теперь можно настроить схемы питания наложения и профили PPM с помощью powercfg.exe. Важно отметить, что схемы наложения теперь ограничены настройкой параметров, влияющих на производительность и экономию энергии. В настоящее время это связано с параметрами в подгруппах параметров питания PPM и графики (с псевдонимами SUB_PROCESSOR и SUB_GRAPHICS в powercfg). Попытки записи в другие подгруппы подложек приводят к ошибке.
Чтение из схем наложения
Команды powercfg, используемые ранее для чтения схем питания, теперь поддерживают схемы наложения, а также для операций чтения и записи.
Синтаксис
powercfg /q overlay_scheme_alias subgroup_alias setting_alias
Все аргументы после флага /q являются необязательными. Если псевдоним параметра не указан, все параметры в указанной схеме наложения и подгруппе будут перечисляться. Если подгруппа не указана, будут перечислены все параметры для всех подгрупп в указанной схеме наложения. Если схема наложения не указана, предполагается, что она является активной схемой наложения (если она активна) или текущей схемой питания (если наложение не активно).
Запись на схемы наложения
Команды setacvalueindex и setdcvalueindex теперь поддерживают схемы наложения.
Синтаксис
значение setting_alias powercfg /setacvalueindex overlay_scheme_alias subgroup_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.
Синтаксис
значение setting_alias powercfg /setacprofileindex overlay_or_scheme_alias profile_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-коде. По умолчанию: 1.0
/name: при необходимости указывает значение поля "Name" в созданном XML- коде. По умолчанию: CustomOEM.Power.Settings.Control
/id: при необходимости указывает строку GUID, которая используется в поле "ID" в созданном XML. По умолчанию создается новый GUID
/owner: при необходимости укажите значение поля OwnerType в созданном XML- файле. По умолчанию: OEM