Typeperf



把性能计数器数据写到命令窗口或支持该功能的日志文件格式中。要停止 Typeperf，请按 CTRL+C。


语法



Typeperf [Path [path ...]] [-cf FileName]  [-f {csv|tsv|bin}] [-si interval] [-o  FileName] [-q [object]] [-qx [object]] [-sc  samples] [-config FileName] [-s  computer_name]

参数



-c {Path [path ...] | -cf FileName}

指定用来登录的性能计数器路径。要列出多个计数器路径，请用空格将每个命令路径隔开。

-cf FileName

指定包含要监视的计数器路径的文件的名称，每行一个文件名。

-f {csv|tsv|bin}

指定输出文件格式。文件格式包括 csv（以逗号分隔）、tsv（以制表符分隔）以及 bin（二进制）。默认格式为 csv。

-si interval [mm:]ss

指定范例之间的时间间隔，以 [mm:]ss 格式。默认值为一秒钟。

-o FileName

指定输出文件的路径名。默认为 stdout。

-q [object]

显示和查询不包含实例的可用计数器。显示一个对象的计数器，包括该对象的名称。

-qx [object]

显示和查询包含实例的所有可用计数器。显示一个对象的计数器，包括该对象的名称。

-sc samples

指定要收集的范例的数量。默认为一直采样，直到按 CTRL+C 时为止。

-config FileName

指定包含命令行参数的设置文件的路径名。

-s computer_name

如果在计数器路径中未指定服务器，则指定要监视的系统。

/?
在命令提示符显示帮助。





注释


 计数器路径格式

计数器路径的通用格式如下：[\\Computer]\object[parent/instance#index]\counter] where:

父节点、事例、索引和格式的计数器组件可以是有效名或通配符。不是所有计数器都必须具有计算机、父节点、事例和索引组件。

可以根据计数器本身决定计数器路径。例如，LogicalDisk 对象具有事例 index，所以必须提供 #index 或通配符。因此，可以使用如下格式：

\LogicalDisk(*/*#*)\*

相对而言，Process 对象不需要事例 index。因此，可以使用如下格式：

\Process(*)\ID Process

可用格式列表如下：

\\machine\object(parent/instance#index)\counter
\\machine\object(parent/instance)\counter
\\machine\object(instance#index)\counter
\\machine\object(instance)\counter
\\machine\object\counter
\object(parent/instance#index)\counter
\object(parent/instance)\counter 
\object(instance#index)\counter
\object(instance)\counter
\object\counter



如果在父节点名称中指定了通配符，则将返回指定对象的所有与指定事例和计数器域匹配的事例。

如果在事例名称中指定通配符，则将返回指定对象和父节点对象中的所有事例（如果指定索引相应的所有事例名称与通配符匹配）。

如果在计数器名称中指定通配符，则将返回指定对象的所有计数器。

不支持部分计数器字符匹配。


 查询格式

对于计数器路径查询，请使用此格式：Typeperf [{-q | -qx [\\Computer\] [object] [-o outputfile}]。

对于完整查询，请使用如下命令行：

Typeperf [\\Computer]\object[instance]\counter]

Typeperf -cf input file

 使用 -config 选项

与 -config 选项一起使用的设置文件的内容应具有如下格式：

[command_option]

value 其中 command_option 是命令行选项，然后在 value 指定其值。例如：

-c

\Windows\mypath

[-o]

report.csv

[-s]

mysystem




有关如何将 Typeperf 合并到 Windows 管理工具 (WMI) 脚本的详细信息，请参阅 Microsoft Windows 资源库网站上的“脚本日志和监视”。(http://www.microsoft.com/)




范例



要显示处理器和内存计数器，请键入：


typeperf "\Memory\Available bytes" "\processor(_total)\% processor time"


要以 CSV 输出格式每三秒钟显示一次 Explorer 进程，请键入：


typeperf "\Process(Explorer)\Thread Count" -si 3 -o typeperf.csv


要在计算机 Server_name 上显示 50 个 RAS 计数器的范例，请键入：


typeperf "\RAS port(LPT1)\Bytes Transmitted" -sc 50 -s Server_name


要以 120 秒的范例显示间隔，显示 input.txt 文件中列出的 50 个计数器范例的计数器值，请键入：


typeperf -cf input.txt -si 120 -sc 50 -f TSV -o domain2.tsv


要查询包含实例的已安装计数器，请键入如下命令。注意：-qx 参数将返回比 -q 参数大很多的性能计数器数目。


typeperf -qx


要在计算机 Server5 上查询不包含实例的物理磁盘计数器，并将它们写到名为 diskctrs.txt 的文件中，请键入：


typeperf -q \\Server5\PhysicalDisk -o diskctrs.txt

XOX