前のトピック: dpmhv-getHostSwitches(Funclet)コマンド -- Hyper-V ホストのホスト スイッチを表示する次のトピック: dpmhv-getJobStatus(Funclet)コマンド -- ジョブ ステータスを表示する


dpmhv-getJobInfo(Funclet)コマンド -- ジョブ情報を表示する

dpmhv-getJobInfo コマンドは、完了した割合、エラー情報、および開始時刻などの非同期ジョブに関連するすべての情報を取得します。

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

dpmhv-getJobInfo 
-jobref job 
[-silent] 
[-retval] 
[-detail]
-jobref job

非同期ジョブのジョブ ID を指定します。

注: 非同期ジョブの実行を完了する際、Hyper-V はジョブ情報を数分間(5 分間)保持します。この保持時間が経過するとこの情報は無効になります。

-silent

画面に出力しないように指定します。

-retval

後で処理できるように値を返します。

-detail

(オプション)非同期ジョブの詳細情報を表示します。

戻り値

dpmhv-getJobInfo コマンドは、現在のジョブの状態を表す各オブジェクトを返します。

Hyper-V のジョブの場合

標準モードでは、ローカルの Hyper-V の以下のプロパティが返されます。

詳細モードでは、ローカルの Hyper-V の以下のプロパティが返されます。

Microsoft System Center Virtual Machine Manager(SCVMM)のジョブの場合

標準モードでは、SCVMM の以下のプロパティが返されます。

詳細モードでは、SCVMM の以下のプロパティが返されます。

例: ジョブ情報を表示する

この例では、エクスポート ジョブの完了のステータスを表示します。

jref = dpmhv-exportVMEx -host hvserver -vm TestVM -dest c:¥Ex-async
    do
    {
      sleep(5000)
      job = dpmhv-getJobInfo -jobref (jref) -silent -retval
      ? "Completion:", job.PercentComplete+"%"
    } while(job.ErrorCode==0 && job.PercentComplete<100)
    ? job.StatusDescriptions
    if(job.ErrorCode!=0)
    {
      ? job.ErrorDescription
    }

例: SCVMM のジョブ情報を表示する

この例では、SCVMM テンプレートを使用して作成された新しい VM の完了のステータスを表示します。

jref=dpmhv-createVMFromTemplate -host hvserver -vm NewVM -dest c:¥VMs¥NewBox -template Win2k3Clean -scvmmHost SCVMMLibSrv -async
    do
    {
       sleep(5000)
       job = dpmhv-getJobInfo -jobref (jref) -silent -retval
       ? "Completion:", job.ProgressValue+"%"
    } while(!job.IsCompleted)
    ? job.StatusString
    s = job.ErrorInfo;
    errorCode = parseInt(s.substr(s.lastIndexOf('(')+1).left(-1));
    if(errorCode!==0)
    {
      ? job.ErrorInfo
    }