機能
VMware ESXから仮想化構成情報を取得し,仮想化構成情報ファイルに出力します。
ただし,VMware ESXからゲストOSの仮想ホスト名を取得するには,ゲストOSでVMware Toolsが動作している必要があります。VMware Toolsがインストールされていない,またはインストールされていても動作していない場合,仮想ホスト名は取得できません。
また,ゲストOS自体が起動していない場合も,仮想ホスト名は取得できません。
このコマンドは,VMware Infrastructure SDKのインターフェースを使用して通信します。
形式
jcfcolvmesx
[-m 通信種別]
-u ユーザーID
[-p パスワード]
-c ホスト名 [ホスト名]
-o 出力ファイル名
実行権限
Windowsの場合:Administrators権限(WindowsのUAC機能が有効な場合は管理者コンソールから実行)
UNIXの場合:スーパーユーザー権限
格納ディレクトリ
Managerパス¥bin¥imcf¥
/opt/jp1imm/bin/imcf/
引数
-m 通信種別
VMware ESXとの通信方法を指定します。
httpsを指定した場合,VMware ESXとhttps通信をします。httpを指定した場合,VMware ESXとhttp通信をします。
このオプションを指定しなかった場合,httpsで通信をします。
-u ユーザーID
接続先VMware ESXのアカウントのユーザーIDを指定します。
ユーザーIDは,256バイト以内の半角文字列で指定します。空白,タブは指定できません。
-p パスワード
-uオプションで指定したユーザーIDのパスワードを指定します。
パスワードは,256バイト以内の半角文字列で指定します。空白,タブは指定できません。
このオプションを指定しなかった場合,パスワードなしが仮定されます。
-c ホスト名 [ホスト名]
VMware ESXが動作しているホストのホスト名を指定します。ホスト名は,255文字以内で指定します。オプションのあとに空白,またはタブ区切りで複数記述します。
-o 出力ファイル名
VMware ESXから取得した構成情報を格納する仮想化構成情報ファイルのファイル名を,相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は,「"」で囲みます。
戻り値
0 | 正常終了※1 |
1 | 引数エラー |
2 | メモリー不足 |
3 | JavaVMの起動エラーが発生した |
4 | 実行権限エラー(Windows限定) |
5 | 管理者コンソールから実行されなかった(Windows限定) |
6 | 出力ファイルがすでに存在する |
7 | 仮想化構成情報の取得に失敗※2 |
8 | 入出力エラーが発生した |
99 | その他のエラー |
仮想化構成情報ファイルの形式
表1-8 ヘッダー情報(1行目)
項目 | 出力値 |
---|---|
仮想化構成情報ファイルの識別文字列 | #VM |
ファイルフォーマットバージョン | 090100 |
文字コード | UTF-8固定 |
表1-9 ヘッダー情報(2行目)
項目 | 出力値 |
---|---|
ホスト名 | Host_name |
VMMホスト名 | VMM_host_name |
仮想化管理種別 | Virtual_manager_type |
仮想化管理製品のバージョン | Manager_version |
仮想化構成管理ホスト | Virtual_host_manager |
表1-10 出力項目(3行目以降)
項目 | 説明 |
---|---|
ホスト名 | ホスト名。 |
VMMホスト名 | 仮想化環境ソフトウェアが稼働するホストのホスト名。 ゲストOSが存在しないVMMホストの場合,仮想ホスト名が空白で,VMMホスト名だけ設定される。 |
仮想化管理種別 | 仮想化構成を管理する製品の種別。 VMware ESXの場合,「ESX」を出力する。 |
仮想化管理製品のバージョン | 仮想化構成を管理する製品のバージョン。 |
仮想化構成管理ホスト | VMMホストを管理するホスト名。 jcfcolvmesxコマンドの場合,常に空白。 |
出力例
#VM,090100,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
Vm1,ESX1,,,
Vm2,ESX1,,,
ESX1,,ESX,4.0,