前のトピック: dpmvc datastore コマンド -- データ ストア プロパティの取得次のトピック: dpmvc distributedswitch コマンド -- 分散仮想スイッチの管理


dpmvc delete コマンド -- VM の破棄

dpmvc delete コマンドは、電源オフ状態の VM を削除します。 このコマンドを使用して、未使用のリソースをクリーンアップし、解放します。

重要: このコマンドを発行する前に、重要なデータをバックアップしたことを確認してください。 このコマンドは、ディスク イメージを含め、VM の VM データ ストアとデータ ファイルを削除します。

このコマンドの形式は、以下のとおりです。

dpmvc delete
[-sc sc_url]
-datacenter_name datacentername
-vm_name vmname
[-vc_server vcservername]
[-vc_user vcuser]
[-vc_password vcpassword]
[-auth_file authorizationfilename]
[-auth_comp componentID] [-wait [timeout]]
[-pre]
[-post]
[-ws_user wsuser]
[-ws_password wspassword]
[-prompt {yes|no}]
[-encrypted_password {yes|no}]
[-locale iso639value]
-sc sc_url

(オプション)サービス コントローラ ホスト用の URL を定義します。

例: https://hostname:port/...

hostname

サービス コントローラがインストールされている完全修飾ホスト名を定義します。

例: localhost.ca.com

port

サービス コントローラ ホスト用のリスニング ポートを定義します。

例: 80

-datacenter_name datacentername

VM が存在するデータ センターを指定します。

-vm_name vmname

VM を指定します。

-vc_server vcservername

複数の vCenter Server がある場合にアクセスする vCenter Server を指定します。 単一の vCenter Server 環境の場合はオプションです。

-vc_user vcuser

(オプション) vCenter Server のユーザ ID を指定します。 グローバル認証情報が有効な場合はオプションです。

-vc_password vcpassword

(オプション) vCenter Server のユーザ ID のパスワードを指定します。 このオプションを省略すると、デフォルトの認証ファイルまたは特定の認証ファイル(-auth_file オプション)が指定されている場合は、ユーザ(-vc_user オプション)の暗号化されたパスワードとコンポーネント(-auth_comp オプション)が取得されます。

-auth_file authorizationfilename

(オプション)暗号化されたパスワードの取得に使用する認証ファイルの名前をフル パスで指定します。 このファイルには、dpmutil 認証情報設定コマンドを使用して生成した CA Server Automation 管理者の認証情報が含まれます。 このオプションを指定しないと、デフォルトの認証ファイルが使用されます。

-auth_comp componentID

(オプション)グループ ホストとユーザに対して使用できるコンポーネント ID を指定します。

-wait timeout

(オプション)ジョブ ステータスを表示し、操作が完了、失敗、またはタイムアウト(timeout の値を指定している場合)するまで待機するかどうかを指定します。 このオプションを指定しない場合、CLI は完了を待たずに戻ります。 応答がない場合、オプションの timeout の値(分)がタイムアウトするまでの時間となります。 timeout の値を指定せずに wait オプションを入力すると、CLI は caimgconf.cfg ファイルのデフォルト待機時間の 120 分を使用します。 任意の正の整数のほかに、timeout には以下の値も使用できます。

""

タイムアウト値はありません。

0

完了するまで待機します。

-pre

(オプション)操作を実行する前にイベントを生成するかどうかを指定します。

-post

(オプション)操作を実行した後でイベントを生成するかどうかを指定します。

-ws_user wsuser

(オプション) VC プラットフォーム管理モジュール(PMM)に接続する Web サービスのユーザ名を指定します。

-ws_password wspassword

(オプション) VC プラットフォーム管理モジュール(PMM)に接続する Web サービス ユーザのパスワードを指定します。

-prompt {yes|no}

(オプション) Web サービスのユーザ ID とパスワードの入力を要求するかどうかを指定します。

デフォルト: Yes

-encrypted_password {yes|no}

(オプション) VC ユーザ パスワードを暗号化するかどうかを指定します。

デフォルト: Yes

-locale iso639value

(オプション)デフォルトの英語出力より優先させるロケールを、IS0 639_3166 の組み合わせ(たとえばフランス語の場合は fr_FR)で指定します。コマンド プロンプトのロケールを使用する場合は「native」を指定します。

例: 単一 vCenter Server 環境でグローバル認証情報を使用して、VM を破棄する

以下の例は、VM vm11 を破棄します。

dpmvc delete -vm_name vm11 -datacenter_name "lab 444"

例: 複数 vCenter Server 環境でグローバル認証情報を使用して、VM を破棄する

以下の例は、VM vm11 を破棄します。

dpmvc delete -vm_name vm11 -datacenter_name "lab 444" -vc_server vc_server_1