機能説明
Systemwalker Software Configuration Managerで管理するビューを登録、更新、削除、一覧表示、詳細表示、および、レポーティングを行います。
記述形式
【Windows】
swcfmg_report_view.exe { -add [ -id "ビューID" ] -name "ビュー名" -file "ビュー定義ファイルのパス" | -update -id "ビューID" [ -name "ビュー名" ] [ -file "ビュー定義ファイルのパス" ] | -delete -id "ビューID" | -list [ -file "出力ファイルパス" ] [-e "文字コード"] | -get -id "ビューID" [ -file "出力ファイルパス" ] | -report -id "ビューID" [ -policyid "ポリシーID" ] -file "出力ファイルパス" [-e "文字コード"] }
【Linux】
swcfmg_report_view { -add [ -id "ビューID" ] -name "ビュー名" -file "ビュー定義ファイルのパス" | -update -id "ビューID" [ -name "ビュー名" ] [ -file "ビュー定義ファイルのパス" ] | -delete -id "ビューID" | -list [ -file "出力ファイルパス" ] [-e "文字コード"] | -get -id "ビューID" [ -file "出力ファイルパス" ] | -report -id "ビューID" [ -policyid "ポリシーID" ] -file "出力ファイルパス" [-e "文字コード"] }
オプション
ビューを登録します。登録するビューのビューID、ビュー名を指定してください。ビューIDを省略した場合、IDは自動採番されます。-fileオプションに、ビューの定義を記載したビュー定義ファイルのファイルパスを指定してください。ビュー定義ファイルの詳細については、「2.2.9 ビュー定義ファイル」を参照してください。
ビューIDで指定されたビューを更新します。更新するビュー名を指定してください。ビューの定義を更新する場合は、-fileオプションにビュー定義ファイルのパスを指定してください。ビュー定義ファイルの詳細については、「2.2.9 ビュー定義ファイル」を参照してください。
ビューIDで指定されたビューを削除します。ビューIDは、本コマンドの-listオプションで確認してください。
ビュー情報をCSV形式で出力します。
-file"出力ファイルのパス"が省略された場合、情報はコマンドの標準出力に出力されます。指定されたファイルが存在しない場合はファイルを新規作成し、存在する場合は既存のファイルへ上書きします。エラーのため、ファイル出力できなかった場合、新規作成時は、新たなファイルは作成しません。既存ファイルへの上書きの場合は、既存ファイルを保障します。
出力ファイルの形式については、注意事項を参照してください。
ビューIDで指定されたビューの定義を出力します。
-file"出力ファイルのパス"が省略された場合、情報はコマンドの標準出力に出力されます。指定されたファイルが存在しない場合はファイルを新規作成し、存在する場合は既存のファイルへ上書きします。エラーのため、ファイル出力できなかった場合、新規作成時は、新たなファイルは作成しません。既存ファイルへの上書きの場合は、既存ファイルを保障します。
出力ファイルの詳細については、「2.2.9 ビュー定義ファイル」を参照してください。
ビューIDで指定されたビューに表示される構成情報を出力します。ポリシーIDでポリシーを指定した場合、該当ポリシーに違反している構成情報のみを出力します。ポリシーIDを省略した場合、すべての構成情報を出力します。
指定されたファイルが存在しない場合はファイルを新規作成し、存在する場合は既存のファイルへ上書きします。エラーのため、ファイル出力できなかった場合、新規作成時は、新たなファイルは作成しません。既存ファイルへの上書きの場合は、既存ファイルを保障します。
出力ファイルの詳細については、注意事項を参照してください。
ファイルの文字コードを指定します。
以下の文字コードが指定できます。半角英大文字で指定します。
[Windows]
SJIS
[Linux]
UTF-8
EUC
復帰値
復帰値 | 意味 |
---|---|
0 | 正常終了しました。 |
10 | パラメーター異常です。 |
20 | 指定された入出力ファイルパスのエラーです。 |
30 | 指定された文字コードに誤りがあります。 |
50 | ファイルの記述に誤りがあります。 |
70 | 指定されたビュー、または、ポリシーに誤りがあります。 |
100 | Systemwalker Software Configuration Manager は起動していません。 |
101 | 同時実行できないコマンドが実行されています。 |
102 | コマンド実行権限がありません。 |
110 | 書き込みエラーです。 |
200 | セットアップされていません。 |
255 | システムエラーです。 |
コマンド格納場所
【Windows】
[Systemwalker Software Configuration Managerインストールディレクトリ]\SWCFMGM\bin
【Linux】
/opt/FJSVcfmgm/bin
実行に必要な権限
【Windows】
管理サーバで実行可能です。
【Linux】
管理サーバで実行可能です。
注意事項
Systemwalker Software Configuration Managerで提供するコマンドは、同時に実行する事はできません。コマンド実行中に他のコマンドを実行すると、排他エラーとなります。
Systemwalker Software Configuration Managerが起動した状態で本コマンドを実行してください。
ビューIDは、半角英数字、ハイフン(-)、アンダースコア(_)で構成される32文字以内の半角英数字で始まる文字列を指定してください。
ビュー名は、85文字以内の文字列を指定してください。
ビューIDは、製品内で一意になるように指定してください。
登録済みのビュー情報を修正する場合は、詳細表示したファイルを編集し、編集したファイルを更新の入力とすることをお勧めします。
ビュー情報を更新する前に、該当ビューのポリシーをすべて無効にしてください。有効なポリシーが存在する場合、更新がエラーとなります。更新後、ポリシーの内容を見直し、必要であればポリシーを更新してください。
本製品で利用する必要がなくなったビューは、本コマンドを使用してビューを削除してください。
削除するビューのポリシーが存在する場合、削除がエラーとなります。ポリシーを削除してから、ビューを削除してください。
CSV1行につき、登録されているビュー情報を1つ出力します。CSVファイルの形式は、以下のとおりです。
項番 | 項目名 |
---|---|
1 | ビューID |
2 | ビュー名 |
ビュー情報が登録されていない場合は、ヘッダー情報だけを出力します。
#view-id,view-name
ビューがCSV形式で出力されます。ビューのカラム1つが、CSVファイルのカラム1つとして出力されます。
CSVファイルのヘッダーには、ビューのカラム名に指定した値が出力されます。ヘッダー行の先頭は"#"(シャープ)で開始します。出力する情報がない場合、ヘッダー行のみ出力されます。
属性値が空文字の場合、"__EMPTY__"が出力されます。
ポリシーを指定した場合、ポリシーの対象種別によって以下の情報が出力されます。
CI数
ポリシーに違反した階層のCIと、そのCIと関係(リレーション)があるすべてのCIの属性値
属性値
ポリシーに違反した属性のCIと、そのCIと関係(リレーション)があるすべてのCIの属性値
使用例
登録
【Windows】
swcfmg_report_view.exe -add -name "ビュー1" -file C:\work\viewdef.xml
【Linux】
swcfmg_report_view -add -name "ビュー1" -file /tmp/viewdef.xml
更新
【Windows】
swcfmg_report_view.exe -update -id PGGEG45GR -file C:\work\viewdef.xml
【Linux】
swcfmg_report_view -update -id PGGEG45GR -file /tmp/viewdef.xml
削除
【Windows】
swcfmg_report_view.exe -delete -id PGGEG45GR
【Linux】
swcfmg_report_view -delete -id PGGEG45GR
一覧表示
【Windows】
swcfmg_report_view.exe -list -file C:\work\viewinfo.csv
【Linux】
swcfmg_report_view -list -file /tmp/viewinfo.csv
詳細表示
【Windows】
swcfmg_report_view.exe -get -id PGGEG45GR -file C:\work\viewdef.xml
【Linux】
swcfmg_report_view -get -id PGGEG45GR -file /tmp/viewdef.xml
レポート
【Windows】
swcfmg_report_view.exe -report -file C:\work\viewreport.csv
【Linux】
swcfmg_report_view -report -file /tmp/viewreport.csv