機能説明
パラメーター収集定義の新規追加、更新、削除、一覧表示、および、取得をします。また、パラメーター収集定義のスクリプトパッケージに関連付けられたスクリプトパッケージを、アップロードまたはダウンロードします。
新規追加、更新、取得は、入力ファイルにパラメーター収集定義入力ファイルを使用します。パラメーター収集定義入力ファイルはXML形式です。詳細は、「2.2 収集するパラメーターの定義」を参照してください。
アップロードとダウンロードは、スクリプトパッケージを使用します。スクリプトパッケージはZIP形式のファイルです。詳細は、「2.2.3 パッケージファイル」を参照してください。
記述形式
【Windows】
swcfmg_param_collectingdef.exe ｛ -add -file "パラメーター収集定義ファイルパス" | -update -id "パラメーター収集定義ID" -file "パラメーター収集定義ファイルパス" | -delete -id "パラメーター収集定義ID",・・・ | -list [-file "出力ファイルパス"] [-e "文字コード"] | -get -id "パラメーター収集定義ID" -file "出力ファイルパス" | -upload -id "パラメーター収集定義ID" -file "スクリプトパッケージファイルパス" | -download -id "パラメーター収集定義ID" -dir "出力ディレクトリパス" } |
【Linux】
swcfmg_param_collectingdef ｛ -add -file "パラメーター収集定義ファイルパス" | -update -id "パラメーター収集定義ID" -file "パラメーター収集定義ファイルパス" | -delete -id "パラメーター収集定義ID",・・・ | -list [-file "出力ファイルパス"] [-e "文字コード"] | -get -id "パラメーター収集定義ID" -file "出力ファイルパス" | -upload -id "パラメーター収集定義ID" -file "スクリプトパッケージファイルパス" | -download -id "パラメーター収集定義ID" -dir "出力ディレクトリパス" } |
オプション
指定されたパラメーター収集定義ファイルに記載された内容で、パラメーター収集定義を新規追加します。入力ファイルは、XML形式のパラメーター収集定義ファイルです。
追加されたパラメーター収集定義に対してパラメーター収集定義IDが生成されます。このIDを標準出力に出力します。
生成するIDの形式
パラメーター収集定義IDは、以下の規則で自動採番します。
SC(プレフィックス) + 8桁の番号 例： SC00000001
標準出力の出力形式
パラメーター収集定義IDを以下の形式で出力します。
[パラメーター収集定義ID]
パラメーター収集定義IDのパラメーター収集定義を、指定されたパラメーター収集定義ファイルに記載された内容で更新します。入力ファイルは、XML形式のパラメーター収集定義ファイルです。
パラメーター収集定義IDのパラメーター収集定義を削除します。また、ソフトウェアとパラメーター収集定義との関連付けがある場合は、この関連付けを削除します。パラメーター収集定義IDは‘,'（カンマ）で区切って複数指定できます。
登録されているパラメーター収集定義の一覧表示を、CSV形式のパラメーター収集定義一覧ファイルで出力します。
-file “出力ファイルパス”が省略された場合、情報はコマンドの標準出力に出力されます。
指定したファイルが存在しない場合はファイルを新規作成し、存在する場合は既存のファイルへ上書きします。
エラーのため、ファイル出力できなかった場合、新規作成時は、新たなファイルは作成しません。既存ファイルへの上書きの場合は、既存ファイルを保証します。
標準出力の出力形式
パラメーター収集定義の一覧表示を以下の形式で出力します。
項番 | 項目名 | 備考 |
|---|---|---|
1 | パラメーター収集定義ID | パラメーター収集定義IDを出力します。 |
2 | 製品で事前定義したパラメーター収集定義か | パラメーター収集定義が製品で事前定義したものであるかを出力します。 |
3 | パラメーター収集定義の名前 | パラメーター収集定義の名前を出力します。 |
4 | パラメーター収集の方式 | パラメーター収集の方式を出力します。 |
3 | スクリプトパッケージのファイル名 | スクリプトパッケージのファイル名を出力します。 |
ヘッダーの形式
CSVファイルの先頭には、以下の形式でヘッダーを挿入します。出力する情報がない場合でも、ヘッダーを出力します。
#Definition ID,Product predefined,Definition name,Method,Package name |
パラメーター収集定義IDのパラメーター収集定義を、指定された出力ファイルパスに出力します。出力ファイルは、XML形式のパラメーター収集定義ファイルです。
指定したファイルが存在しない場合はファイルを新規作成し、存在する場合は既存のファイルへ上書きします。
エラーのため、ファイル出力できなかった場合、新規作成時は、新たなファイルは作成しません。既存ファイルへの上書きの場合は、既存ファイルを保証します。
パラメーター収集定義IDのパラメーター収集定義に、スクリプトパッケージをアップロードします。入力ファイルは、ZIP形式のスクリプトパッケージファイルです。
アップロードできるスクリプトパッケージは、以下の条件のものです。条件以外の場合は、エラーになります。
拡張子はZIPにする
ファイルの拡張子はZIPにしてください。
ファイルサイズは2MB以下にする
アップロードできるファイルサイズは、2MB以下です。
ディスカバリスクリプトはルートに格納する
ディスカバリスクリプト(discover.cmdまたはdiscover.sh)は、ディレクトリの下ではなく、ZIPファイルのルートに格納してください。
パラメーター収集定義IDのパラメーター収集定義に登録されているスクリプトパッケージをダウンロードします。出力ディレクトリパスにZIP形式のスクリプトパッケージファイルを出力します。
出力ディレクトリにファイルが存在しないことを確認してください。出力ディレクトリにファイルが存在した場合はエラーになります。
ファイルの文字コードを指定します。
以下の文字コードが指定できます。半角英大文字で指定します。
[Windows]
SJIS
[Linux]
UTF-8
EUC
本オプションを省略した場合、本コマンドの実行環境の文字コードで動作します。
復帰値
復帰値 | 意味 |
|---|---|
0 | 正常終了しました。 |
10 | パラメーター異常です。 |
20 | 指定された入出力パスのエラーです。 |
30 | 指定された文字コードに誤りがあります。 |
40 | ファイルが解析できません。 |
50 | ファイルの記述に誤りがあります。 |
70 | 指定されたIDが存在しません。 |
71 | 指定されたIDは製品で事前定義したものです。 |
72 | 指定されたIDにパッケージが登録されていません。 |
73 | 指定されたIDにパッケージが正常に登録されていません。 |
100 | Systemwalker Software Configuration Manager は起動していません。 |
101 | 同時実行できないコマンドが実行されています。 |
102 | コマンド実行権限がありません。 |
110 | 書き込みエラーです。 |
120 | メディアライブラリでディスク容量不足が発生しました。 |
200 | セットアップされていません。 |
255 | システムエラーです。 |
コマンド格納場所
管理サーバ
【Windows】
[Systemwalker Software Configuration Managerインストールディレクトリ]\SWCFMGM\bin |
【Linux】
/opt/FJSVcfmgm/bin |
実行に必要な権限/実行環境
【Windows】
Administrator権限が必要です。ご利用OSがWindows Server 2008以降の場合は、管理者として実行してください。
管理サーバで実行可能です。
【Linux】
システム管理者（スーパーユーザー）のみが実行できます。
管理サーバで実行可能です。
注意事項
本コマンドは同時に実行する事はできません。コマンド実行中に他のコマンドを実行すると、排他エラーとなります。
Systemwalker Software Configuration Managerが起動した状態で本コマンドを実行してください。
ソフトウェアとパラメーター収集定義が関連付けられている場合やスクリプトパッケージが登録されている場合は、方式を変更できません。
1つのソフトウェアに複数のパラメーター収集定義が関連付けられている場合は、それらのパラメーター一覧に重複したキーを指定できません。
Systemwalker Software Configuration Managerで管理する必要がなくなったパラメーター収集定義は、本コマンドを使用して情報を削除してください。
パラメーター収集定義が登録されていない場合は、ヘッダー情報だけを出力します。
#Definition ID,Product predefined,Definition name,Method,Package name |
パラメーター収集定義ファイルに誤りがある場合は、パラメーター収集定義の登録・更新を中止します。以下のエラーメッセージを出力します。
XMLファイルの検証でエラーが発生しました。[詳細:(原因)] |
使用例
新規追加
【Windows】
swcfmg_param_collectingdef.exe -add -file C:\work\paramcollectingdef.xml |
【Linux】
swcfmg_param_collectingdef -add -file /tmp/paramcollectingdef.xml |
更新
【Windows】
swcfmg_param_collectingdef.exe -update -id SC00000001 -file C:\work\paramcollectingdef.xml |
【Linux】
swcfmg_param_collectingdef -update -id SC00000001 -file /tmp/paramcollectingdef.xml |
削除
【Windows】
swcfmg_param_collectingdef.exe -delete -id SC00000001 |
【Linux】
swcfmg_param_collectingdef -delete -id SC00000001 |
一覧表示
【Windows】
swcfmg_param_collectingdef.exe -list |
【Linux】
swcfmg_param_collectingdef -list |
取得
【Windows】
swcfmg_param_collectingdef.exe -get -id SC00000001 -file C:\work\paramcollectingdef.xml |
【Linux】
swcfmg_param_collectingdef -get -id SC00000001 -file /tmp/paramcollectingdef.xml |
アップロード
【Windows】
swcfmg_param_collectingdef.exe -upload -id SC00000001 -file C:\work\paramcollectingdef.zip |
【Linux】
swcfmg_param_collectingdef -upload -id SC00000001 -file /tmp/paramcollectingdef.zip |
ダウンロード
【Windows】
swcfmg_param_collectingdef.exe -download -id SC00000001 -dir C:\work\paramcollectingdef |
【Linux】
swcfmg_param_collectingdef -download -id SC00000001 -dir /tmp/paramcollectingdef |
