NetVault 12.1 - リファレンス・ガイド

formatオプションの使用

ターミナル・ウィンドウでレポートが実行される場合、デフォルトでは、レポートは定義済みレイアウトで表示されます。 ‑formatオプションを使用すると、列に表示されている文字数の指定、改行の挿入、列の追加または削除を実行できます。 以降のセクションでは、フォーマット・オプションについて説明します。

-formatオプションを使用する場合は、フィールドの実際の名前を使用する必要があります。 各名前の先頭には「%」記号を付ける必要があります。 実際の名前に「%」記号が含まれている場合は、その名前を指定するときにエスケープ・シーケンス「%%」を使用します。 また、すべての必須フィールドを構文に指定する必要があります。 いずれかフィールドを構文に指定しない場合、そのフィールドは出力で表示されません。

列の最大文字数を指定するには、2つのコロンとその数を実際の名前に追加します。

例：

レポート出力の各エントリ間に改行を含めるには、-formatオプションで指定したフィールドのリストの末尾に「%\n」を追加します。

例：

一部のテンプレート・ファイルには、-formatオプションを使用して出力に含めることのできる追加フィールドがあります。 列を追加するには、nvreport -help field <class name>コマンドを使用してテンプレート・ファイルで使用できるフィールドの完全なリストを取得します。 各フィールドの説明列で提供されている情報を確認し、適用可能なフィールドを含めてください。 必ず、フィールドの実際の名前を使用します。

以下の例では、「ドライブ」定義済みレポートを使用しています。 このレポートには、デフォルト・フィールドがすべて含まれており、さらに、ドライブの書き込みエラー数が表示されます。

例：

sortオプションの使用

-sortオプションを使用して選択したフィールドのエントリをソートできます。 ソート式は、以下の形式で指定します。

レポートは、クラスが提供するどのフィールドでもソートできます。 出力には表示されないフィールドの実際の名前も出力のソートに使用できます。

-sortオプションを使用する場合は、フィールドの実際の名前を使用する必要があります。 各名前の先頭には「%」記号を付ける必要があります。 実際の名前に「%」記号が含まれている場合は、その名前を指定するときにエスケープ・シーケンス「%%」を使用します。

例：

「-sort」オプションでは、複数のフィールドを指定できます。 出力されたレポートでは、構文のフィールド名の順に基づいてソートの優先順位が決定されます。 複数のソート・フィールドを使用する場合は、すべてのフィールドを引用符（“ ”）で囲みます。

例：

includeオプションの使用

-includeオプションを使用すると、レポートのデータをフィルタリングできます。 フィルタ式は、以下の形式で指定します。

複数のフィルタ式を指定するには、「AND」および「OR」を使用します。 また、引数の優先度を示すには、括弧を使用します。

例：

titleオプションの使用

レポートがコマンドラインから実行、表示された場合、出力のタイトルは、デフォルトの「CLI Report」になります。 -titleオプションを使用するとレポート・タイトルを変更できます。 -titleオプションは、以下の形式で指定します。

タイトルにスペースを含めるには、値全体を引用符で囲む必要があります。 「-title」オプションを使用すると、CLI出力のレポートにラベルを付けることができますが、ファイルに出力され、CLI で表示されるレポートにラベルを付けるのにより適しています。