Chat now with support
Chat mit Support

NetVault 12.2 - 参考指南

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

使用格式选项

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

•
指定列的最大字符数
•
插入换行符
•
添加或删除列

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

指定列的最大字符数

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

-format “%<Real Name>::<Max characters>

示例：

nvreport -class “Media Requests” -format “%Date %JOBID %TRANSITION::3”
插入换行符

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

-format “%<Real Name> %<Real Name> %\n

示例：

nvreport -class “Media Requests” -format “%Date %Time %JOBID %TRANSITION %\n”
添加或删除列

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

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

示例：

nvreport -class drives -format “%DriveName %Product %Vendor %Status %DriveMachine %DriveDataWritten %DriveDataRead %DriveWriteErrors”

使用排序选项

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

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

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

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

示例：

nvreport -class “Job History” -sort “%TITLE+”

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

示例：

nvreport -class “Job History” -sort “%TITLE+ %EXITSTATUS

使用包含选项

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

-include %[field name][operator][constant]
•
[field name]: 字段的实际名称。
•
[operator]: 运算符可以是以下类别之一：
•
>（大于）
•
>=（大于或等于）
•
<（小于）
•
<=（小于或等于）
•
=（等于）
•
!=（不等于）
•
[constant]: 与 [field name] 值进行比较的值。例如，要仅包含适用于 ID“42”任务的条目，则应将“42”作为 [constant]。

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

示例：

•
nvreport -class “Job History” -include “%JOBDEFINITIONID = 42
•
nvreport -class “Job History” -include “(%JOBDEFINITIONID > 50 AND %INSTANCEID < 5) OR %TYPE = restore
常量类型
 
表 93. 常量类型
常量类型
说明

Timepassed

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

•
HH:MM:SS
•
HHMMSS

Boolean

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

•
是或否
•
真或假

Date

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

示例：

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

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

•
YYYY/MM/DD
•
YYYYMMDD
•
now-[number value][time variable (YE = Year, MO = Month, WE = Week, DA = Date, HO = Hour, MI = Minute, SE = Second)]

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

Daysinweek

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

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

•
星期日 = “SU”
•
星期一 = “MO”
•
星期二 = “TU”
•
星期三 = “WE”
•
星期四 = “TH”
•
星期五 = “FR”
•
星期六 = “SA”

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

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

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

•
HH:MM:SS
•
HHMMSS (221011)
•
Past Time: now-[number value][time variable (YE = 年、MO = 月、WE = 周、DA = 日期、HO = 小时、MI = 分钟、SE = 秒)]。

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

时间

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

示例

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

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

•
HH:MM:SS
•
HHMMSS (221011)
•
Past Time: now-[number value][time variable (YE = 年、MO = 月、WE = 周、DA = 日期、HO = 小时、MI = 分钟、SE = 秒)]。

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

Unique

N/A

weeksinmonth

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

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

[Week Number]: 所需的周数

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

使用标题选项

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

-title <NewReport Title>

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

Verwandte Dokumente

The document was helpful.

Bewertung auswählen

I easily found the information I needed.

Bewertung auswählen