ImportHostsコマンドは,ホストの情報を入力ファイル(CSV形式のホスト情報ファイル,およびマッピング定義ファイル)からインポートします。また,入力ファイルの情報をチェックします。
ここでは,ImportHostsコマンドの書式やパラメーターについて説明しています。入力ファイルの作成方法やImportHostsコマンドを使用したインポート機能の運用方法については,「7. インポート機能」を参照してください。
書式
入力ファイルをチェックする場合:
HiCommandCLI [URL] ImportHosts [オプション]
inputfile=ホスト情報ファイル名
[mappingfile=マッピング定義ファイル名]
[resultfilepath=チェック結果出力ファイルおよびエラー情報出力ファイルの出力先]
[function=check]
ホストの情報をインポートする場合:
HiCommandCLI [URL] ImportHosts [オプション]
inputfile=ホスト情報ファイル名
[mappingfile=マッピング定義ファイル名]
[resultfilepath=エラー情報出力ファイルの出力先]
function=import [overwrite={true|false}]
パラメーター
表4-89 ImportHostsコマンドのパラメーター
パラメーター名 | 指定のレベル | 説明 |
---|---|---|
inputfile | 必須 | ホスト情報ファイル名 ホストの情報を記載したCSV形式のファイルを,絶対パスまたは相対パスで指定します。 Device Managerに登録できないホストが記載されていた場合,そのレコードを無視して後続のレコードが登録されます。ただし,ホスト情報ファイル内に同じ名前のホストが複数記述されている場合は,最初のホストだけが登録されます。最初のホストがエラーになった場合も,以降の同名ホストは登録されません。 |
mappingfile | 任意 | マッピング定義ファイル名 ホスト情報ファイルの内容とインポートするホスト情報を対応付けたプロパティ形式のファイルを,絶対パスまたは相対パスで指定します。 このパラメーターを省略した場合,Device Manager CLIのインストール先にあるimport.propertiesがマッピング定義ファイルとして使用されます。 |
resultfilepath | 任意 | チェック結果出力ファイルおよびエラー情報出力ファイルの出力先 チェック機能を実行した場合に出力されるチェック結果出力ファイルや,チェック機能またはインポート機能で警告やエラーが発生した場合に出力されるエラー情報出力ファイルの出力先を,絶対パスまたは相対パスで指定します。 このパラメーターを省略した場合,Device Manager CLIのインストール先に出力されます。 |
function | 任意 | 実行する処理の種別
|
overwrite | 任意 | すでに同じ名前のホストがDevice Managerに登録されていた場合に,そのホストの情報を更新(上書き)するかどうかを指定します。
このパラメーターを省略した場合,falseが指定されたと見なされます。 パラメーターfunctionにcheckを指定した場合,このパラメーターの指定は無視されます。 |
事前に取得するパラメーター値
ありません。
コマンド実行例1
この例では,パラメーターfunctionにcheckを指定して入力ファイルをチェックします。
HiCommandCLI ImportHosts "function=check" "inputfile=D:¥work¥hostImport.csv" "mappingfile=D:¥work¥import.properties" "resultfilepath= D:¥work"
コマンド実行結果1
RESPONSE:
Verification of records from 1 to 15
in "D:¥work¥hostImport.csv" is complete.
Number of hosts that can be imported = 10
Number of hosts that cannot be imported = 5
Number of hosts that can be imported but for which a warning was given = 1
See "D:¥work¥ImportHostsCheckResult-20120515113355.txt" for information about the hosts that can be imported.
See "D:¥work¥ImportHostsResult-20120515113355.log" for details about errors and warnings.
コマンド実行結果は標準出力に表示されます。表示されるメッセージに従って出力ファイルの内容を確認してください。
出力項目の意味を次に示します。
コマンド実行例2
この例では,パラメーターfunctionにimportを指定して,ホストの情報をインポートします。
HiCommandCLI ImportHosts "function=import" "inputfile=D:¥work¥hostImport.csv" "mappingfile=D:¥work¥import.properties" "resultfilepath= D:¥work" "overwrite=true"
コマンド実行結果2
RESPONSE:
The import of records from 1 to 10
in "D:¥work¥hostImport.csv" is complete.
Number of hosts added = 5
Number of hosts updated = 2
Number of hosts that failed = 3
Number of hosts added or updated with a warning = 2
See "D:¥work¥ImportHostsResult-20120515113355.log" for details about errors and warnings.
コマンド実行結果は標準出力に表示されます。出力ファイルがある場合,表示されるメッセージに従ってファイルの内容を確認してください。
出力項目の意味を次に示します。