PwrTest Syntax

从命令提示符窗口运行 PwrTest。 You can select and configure PwrTest Scenarios using command options.

PwrTest 工具的语法为:

pwrtest /scenario [/scenario_options] [/common_options]

/ scenario

Scenarios Description
sleep 通过睡眠/恢复转换来循环计算机。 (Windows 7 及更高版本)
battery 提供电池信息和监视。 (Windows 7 及更高版本)
info 提供系统电源信息。 (Windows 7 及更高版本)
es 监视线程执行状态。 (Windows 7 及更高版本)
idle 监视系统空闲事件。 (Windows 7 及更高版本)
ppm 监视处理器电源管理。 (Windows 7 及更高版本)
计时器 监视系统计时器解析更改。 (Windows 7 及更高版本)
disk 监视磁盘空闲统计信息和自旋事件。 (Windows 7 及更高版本)
设备 监视设备空闲统计信息和关闭事件。 (Windows 7 及更高版本)
monitor 记录与监视/显示自动变暗和空白相关的用户空闲统计信息。(Windows 7 及更高版本)
requests 显示未完成的电源请求和新电源请求。 (Windows 7 及更高版本)
thermal 监视 ACPI 热区域信息和统计信息。 这仅在报告热区域和温度变化的系统上受支持。 (Windows 7 及更高版本)。
processidle 强制执行后台维护任务(现在而不是按计划时间执行),并监视其进度。 (Windows 7 及更高版本)
cs 如果系统支持连接待机转换,则通过连接待机转换来循环计算机。 (Windows 8 及更高版本)
platidle 监视和尝试记录平台空闲转换计数(如果系统支持)。 (Windows 8 及更高版本)
directedfx 监视与 定向电源管理框架(DFx)相关的低功率空闲状态开关。 (Windows 10 版本 1903 及更高版本)

/ scenario_options
To see the options available for each Pwrtest scenario, type: pwrtest.exe /scenario/?

例如: pwrtest.exe /sleep /?

/ common_options

common_options Description
/lf:folder 指定日志文件的文件夹。 例如,c:\myfolder 或 \\server\share。 默认日志位置与 pwrtest.exe文件夹相同。
/ln:name 指定日志文件的名称以及 Windows 事件跟踪(ETW)跟踪会话的名称。 会自动添加日志文件扩展名(.wtl、.xml等)。 默认名称为 pwrtestlog。
/etwbuffersize:n 如果 ETW 缓冲区大小大于默认大小,则指定 KB 中的 ETW 缓冲区大小。 默认值为当前页大小或 256KB(以更大者为准)。
/etwminbuffers:n 指定分配给 ETW 会话的最小缓冲区数(如果大于每个逻辑处理器的最小 2 个)。 默认值为每个逻辑处理器 2 个缓冲区。
/etwmaxbuffers:n Specifies the maximum number of buffers allocated for the ETW session if that number is larger than the minimum of 2 per logical processor and larger than the etwminbuffers setting. The default is the etwminbuffers value + 20.
/delaywrite 指定日志数据在内存中缓冲,以减少磁盘写入。 此选项会影响包括 ETL 在内的所有日志类型。

Examples

pwrtest /?  
pwrtest /requests  /?
pwrtest /requests  /t:60

备注

支持 ETW 跟踪的执行要求:

  • Pwrtest must run from an administrator or elevated Command Prompt window (Run as administrator).

  • Pwrtest 必须以本机方式运行(不支持 WoW64)。

系统管理员实施的组策略设置可能会干扰某些需要暂时修改电源设置值(如睡眠方案)的方案。

PwrTest 在.log(纯文本)、.xml(格式因方案而异)、.wtl(WTTLog)和 .etl (ETW 跟踪)日志格式中的每个执行自动生成多个日志。

若要能够使用所有 PwrTest 方案,必须先预配测试计算机以使用 Visual Studio 和 WDK 进行测试。 有关详细信息,请参阅预配计算机进行驱动程序部署和测试(WDK 8.1),为驱动程序部署和测试预配计算机(WDK 8)。 某些方案需要属于 Windows 驱动程序测试框架(WDTF)的电源按钮驱动程序。 预配系统以使用 Visual Studio 和 WDK 进行测试时,将自动安装 WDTF(和包含的电源按钮驱动程序)。 有关 WDTF 的信息,请参阅 Windows 设备测试框架 (WDTF) (Windows 驱动程序)。

PwrTest Scenarios

PwrTest 日志文件