立即与支持人员聊天
与支持团队交流

NetVault 12.2 - 参考指南

简介 入门指南 使用命令行实用程序 使用 nvreport 实用程序

使用格式选项

默认情况下,报告在终端窗口中运行时以预定义的布局显示。您可以使用 ‑format 选项指定列中显示的字符数,插入换行符,添加或删除列。以下各节介绍了格式选项:

当您使用 -format 选项时,您必须使用字段的实际名称。每个名称必须以“%”符号为前缀。如果实际名称包含“%”符号,则在指定名称时使用转义序列“%%”。而且,您必须指定语法中的所有必填字段。如果省略语法中的任何字段,则不会在输出中显示。

要指定列的最大字符数,请将两个冒号和一个数字添加到实际名称:

示例:

要在报告输出中的每个条目之间包含一个换行符,请将“%\n”添加到使用 -format 选项命名的字段列表的末尾:

示例:

某些模板文件提供了几个附加字段,可以使用 -format 选项将其包含在输出中。要添加列,请使用 nvreport
-help field <class name>
命令获取模板文件可用字段的完整列表。查看每个字段“说明”列中提供的信息,并包含适用的字段。请确保使用字段的实际名称。

以下示例使用“驱动器”预设报告。它包含所有默认字段,并还显示驱动器写入错误的数量。

示例:

使用排序选项

-sort 选项可用于对选定字段上的条目进行排序。用以下格式指定排序表达式:

[field name]: 用于对报告排序的字段。
[+/-]:使用 + 按照指定字段的升序对输出进行排序,或者使用 - 按降序对输出进行排序。

报告可以按类别提供的任何字段进行排序。即使输出中未显示的字段的实际名称也可用于对输出进行排序。

当您使用 -sort 选项时,您必须使用字段的实际名称。每个名称必须以“%”符号为前缀。如果实际名称包含“%”符号,则在指定名称时使用转义序列“%%”。

示例:

您可以使用“-sort”选项指定多个字段。生成的报告根据语法中字段名称的顺序来确定排序优先级。使用多个排序字段时,请用引号 (“ ”) 将所有字段引起来。

示例:

使用包含选项

-include 选项可用于过滤报告的数据。用以下格式指定过滤器表达式:

[field name]: 字段的实际名称。
[operator]: 运算符可以是以下类别之一:
[constant]: 与 [field name] 值进行比较的值。例如,要仅包含适用于 ID“42”任务的条目,则应将“42”作为 [constant]。

要加入多个过滤器表达式,请使用“AND”和“OR”。另外,使用括号来表示参数的优先级。

示例:

表 93. 常量类型

Timepassed

用于比较包含时间间隔值的字段。例如,运行备份任务所需的时间。可以使用以下格式指定该值:

Boolean

用于比较包含布尔值的字段。布尔值的示例:

Date

用于比较包含日期值的字段。

示例:

nvreport -class “job history” -include “%STARTDATE >= [Date]”

可以使用以下格式指定该值:

例如,“now-1YE”是一年前。

Daysinweek

用于比较包含一周中某天的字段。

可以使用以下格式指定该值:

Daysinmonth

用于比较月份中包含特定日期的字段。对于多个值,请使用逗号分隔符并将所有值用引号引起来。

hdwmycount

用于比较包含小时、天、周、月和年计数(总数)的字段。

可以使用以下格式指定该值:

[#H] [#D] [#W] [#M] [#Y]

例如,“12H 2W 10M 18Y”表示 12 小时、2 周、10 个月和 18 年。

每次可根据需要添加或省略变量。

Integer(大值)

用于比较包含大整数值(例如,764874497498723497)的字段

Number

用于比较存储数值的字段。

示例:

nvreport -class “job history” -include %INSTANCEID = 2

pluginscreen

N/A

selectiontree

N/A

String

用于比较包含字符串值的字段。

示例:

nvreport -class “job history” -include “%EXITSTATUS !=Failed”

带空格的文本字符串必须用引号引起来。

Systime

用于比较包含系统时间的字段。

可以使用以下格式指定该值:

例如,“now-30mi”是 30 小时前。

时间

用于比较包含任何时间值的字段。

示例

nvreport -class "job history" -include "%STARTTIME >= [Time]"

可以使用以下格式指定该值:

例如,“now-12ho”是 12 小时前。

Unique

N/A

weeksinmonth

用于比较存储月份中特定周的字段。

可以使用以下格式指定该值:

[Week Number]: 所需的周数

“L”表示该月的最后一周。例如,134L 将包括月份中的第一、第三、第四和最后一周。

使用标题选项

当运行报告并从命令行查看报告时,会在输出中显示默认标题报告“CLI 报告”。-title 选项可用于更改报告标题。用以下格式指定 -title 选项:

如果标题要包含任何空格,则整个值必须用引号引起来。尽管可以使用“-title”选项来标记 CLI 输出报告,但它更适合标记输出到文件中并在 CLI 外部查看的报告。

相关文档

The document was helpful.

选择评级

I easily found the information I needed.

选择评级