Msvm_MigrationJob 類別

發行項
06/12/2023

這個類別代表虛擬系統移轉服務為儲存體或虛擬系統移轉所建立的移轉作業作業。

下列語法是簡化 Managed Object Format (MOF) 程式碼，其中包含所有繼承的屬性。

語法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_MigrationJob : CIM_ConcreteJob
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "OK" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   JobStatus;
  datetime TimeSubmitted;
  datetime ScheduledStartTime;
  datetime StartTime;
  datetime ElapsedTime;
  uint32   JobRunTimes;
  uint8    RunMonth;
  sint8    RunDay;
  sint8    RunDayOfWeek;
  datetime RunStartInterval;
  uint16   LocalOrUtcTime;
  datetime UntilTime;
  string   Notify;
  string   Owner;
  uint32   Priority;
  uint16   PercentComplete;
  boolean  DeleteOnCompletion;
  uint16   ErrorCode;
  string   ErrorDescription;
  uint16   RecoveryAction;
  string   OtherRecoveryAction;
  uint16   JobState;
  datetime TimeOfLastStateChange;
  datetime TimeBeforeRemoval = 00000000000500.000000:000;
  boolean  Cancellable;
  string   ErrorSummaryDescription;
  uint16   MigrationType;
  string   VirtualSystemName;
  string   DestinationHost;
  string   NewSystemSettingData;
  string   NewResourceSettingData[];
  uint16   JobType;
};

成員

Msvm_MigrationJob類別具有下列類型的成員：

方法
屬性

方法

Msvm_MigrationJob類別具有這些方法。

方法	Description
GetError	如果有的話，擷取移轉作業的錯誤物件。
GetErrorEx	如果有的話，擷取移轉作業的錯誤物件。
KillJob	不支援這個方法。
RequestStateChange	要求移轉作業的狀態變更為指定的狀態。

屬性

Msvm_MigrationJob類別具有這些屬性。

可取消

資料類型： 布林值
存取類型：唯讀

指出是否可以取消作業。此屬性的值不保證取消作業的要求將會成功。

標題

資料類型：字串
存取類型：唯讀

物件的簡短描述。此屬性繼承自 CIM_ManagedElement。

CommunicationStatus

資料類型： uint16
存取類型：唯讀

指出檢測能夠與基礎 Managed 元素通訊。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

DeleteOnCompletion

資料類型： 布林值
存取類型：唯讀

指定作業是否應該在完成時自動刪除。此屬性繼承自 CIM_Job。

說明

資料類型：字串
存取類型：唯讀

對物件的描述。此屬性繼承自 CIM_ManagedElement。

DestinationHost

資料類型：字串
存取類型：唯讀

虛擬系統要移轉至之目的地虛擬化平臺的主機名稱。這是儲存體移轉的 Null 。

DetailedStatus

資料類型： uint16
存取類型：唯讀

以其他狀態詳細資料來補充 PrimaryStatus 屬性。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

ElapsedTime

資料類型： datetime
存取類型：唯讀

作業已執行的時間間隔，如果作業完成，則為總執行時間。此屬性繼承自 CIM_Job。

ElementName

資料類型：字串
存取類型：唯讀

物件的顯示名稱。此屬性繼承自 CIM_ManagedElement。

ErrorCode

資料類型： uint16
存取類型：唯讀

廠商特定的錯誤碼。如果作業完成且沒有錯誤，則必須將值設定為零。此屬性繼承自 CIM_Job。

ErrorDescription

資料類型：字串
存取類型：唯讀

包含廠商錯誤描述的字串。此屬性繼承自 CIM_Job。

ErrorSummaryDescription

資料類型：字串
存取類型：唯讀
限定詞： ModelCorrespondence (「CIM_Job。ErrorCode「)

如果存在，則為錯誤的摘要描述。

HealthState

資料類型： uint16
存取類型：唯讀

專案的目前健全狀況。這個屬性工作表示這個專案的健康情況，但不一定是其子元件的健康情況。可能的值為 0 到 30，其中 5 表示元素狀況完全良好，而 30 表示元素完全非功能。此屬性繼承自 CIM_ManagedSystemElement，而且一律會設定為 5。

InstallDate

資料類型： datetime
存取類型：唯讀

建立虛擬機器組態的日期和時間。此屬性繼承自 CIM_ManagedSystemElement。

InstanceID

資料類型：字串
存取類型：唯讀
限定詞：金鑰

唯一識別這個類別的實例。此屬性繼承自 CIM_ManagedElement，而且一律設定為 Null。

JobRunTimes

資料類型： uint32
存取類型：唯讀

應該執行作業的次數。值為 1 表示作業不是週期性作業，而任何非零值都表示作業將遞迴的次數限制。零表示作業可以處理的次數沒有限制，但會在到達 UntilTime 之後終止，或手動終止作業。此屬性繼承自 CIM_Job。

JobState

資料類型： uint16
存取類型：唯讀

JobState 是整數列舉，表示作業的操作狀態。它也可以指出這些狀態之間的轉換，例如「關機」和「開始」。此屬性繼承自 CIM_ConcreteJob。

值	意義
新增 2	作業從未啟動。
啟動中 3	作業會從 2 (New) 、5 (Suspended) ，或 11 (Service) 狀態移至 4 (執行) 狀態。
執行中 4	工作正在執行。
已暫停 5	作業已停止，但可以順暢地重新開機。
關閉 6	作業會移至 7 (Completed) 、8 (Terminated) 或 9 (Killed) 狀態。
Completed 7	作業已正常完成。
已終止 8	作業已由「終止」狀態變更要求停止。作業及其所有基礎程式都會結束，而且只能以新作業的形式重新開機。只有以新作業的形式重新開機作業的需求是特定作業。
殺 9	作業已由「終止」狀態變更要求停止。基礎進程可能仍在執行中，而且可能需要清除才能釋放資源。
例外狀況 10	作業處於異常狀態，可能表示錯誤狀況。作業的實際狀態可能可透過作業特定物件取得。
服務 11	作業處於廠商特定的狀態，可支援問題探索或解決，或兩者皆可。
DMTF 保留 12 32767	保留的。
廠商保留 32768 65535	保留的。

JobStatus

資料類型：字串
存取類型：唯讀

表示作業狀態的字串。此屬性繼承自 CIM_Job。

JobType

資料類型： uint16
存取類型：唯讀

指出這個物件正在追蹤的作業類型。

未知 (0)

建立遠端虛擬機器 (300)

檢查虛擬機器相容性 (301)

檢查虛擬機器和儲存體相容性 (302)

檢查儲存體相容性 (303)

檢查儲存體移 轉 (304)

移動虛擬機器 (305)

移動虛擬機器和儲存體 (306)

移動儲存體 (307)

LocalOrUtcTime

資料類型： uint16
存取類型：唯讀

此屬性繼承自 CIM_Job。

指出 RunStartInterval 和 UntilTime 屬性中所代表的時間是否代表當地時間或 UTC 時間。

當地時間 (1)
UTC 時間 (2 )

MigrationType

資料類型： uint16
存取類型：唯讀
限定詞： ModelCorrespondence (「Msvm_VirtualSystemMigrationSettingData。MigrationType「)

這個工作物件所代表的移轉類型。這會是針對Msvm_VirtualSystemMigrationSettingData類別之MigrationType屬性定義的其中一個值。

名稱

資料類型：字串
存取類型：唯讀
限定詞： Key、 MaxLen ( 256 )

此作業實例的顯示名稱。此外，顯示名稱可以當做搜尋或查詢的屬性使用。此屬性繼承自 CIM_ManagedSystemElement。

NewResourceSettingData

資料類型：字串陣列
存取類型：唯讀

針對即時移轉，這一律會設定為 Null。

針對儲存體移轉，如果這是 Null，則不會移動虛擬機器的虛擬硬碟 (VHD) 。否則，這會包含 Msvm_StorageAllocationSettingData 類別的內嵌實例陣列，這些實例代表要移動的 VHD。這些實例的 Connection 屬性會指定 VHD 的目的地位置。

NewSystemSettingData

資料類型：字串
存取類型：唯讀

針對即時移轉，這一律會設定為 Null。

針對儲存體移轉，如果這是 Null，則虛擬機器的資料根目錄不會移動。否則，這會包含 Msvm_VirtualSystemSettingData 類別的內嵌實例，其中 ExternalDataRoot、 SnapshotDataRoot和 SwapFileDataRoot 屬性會指定新的資料根目錄。

通知

資料類型：字串
存取類型：唯讀

作業完成或失敗時收到通知的使用者。此屬性繼承自 CIM_Job。

OperatingStatus

資料類型： uint16
存取類型：唯讀

提供專案作業條件的目前狀態資訊，並可用來提供 與 EnabledState 屬性值相關的詳細資料。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

OperationalStatus

資料類型： uint16 陣列
存取類型：唯讀

物件的目前狀態。此屬性繼承自 CIM_ManagedSystemElement，而且每個陣列元素一律會設定為 2 (OK) 。

OtherRecoveryAction

資料類型：字串
存取類型：唯讀

當實例的 RecoveryAction 屬性為 1 (Other) 時，描述復原動作的字串。此屬性繼承自 CIM_Job。

擁有者

資料類型：字串
存取類型：唯讀

提交作業的使用者。此屬性繼承自 CIM_Job。

PercentComplete

資料類型： uint16
存取類型：唯讀
限定詞： MinValue ( 0 ) 、 MaxValue ( 100 ) 、單位 ( 「Percent」 )

作業的完成百分比。此屬性繼承自 CIM_Job。

PrimaryStatus

資料類型： uint16
存取類型：唯讀

提供高階狀態資訊。這個屬性應該與 DetailedStatus 屬性搭配使用，以提供元素及其子元件的高階和詳細健全狀態。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

優先順序

資料類型： uint32
存取類型：唯讀

作業執行的重要性。此屬性繼承自 CIM_Job。

RecoveryAction

資料類型： uint16
存取類型：唯讀

描述要針對失敗執行作業採取的復原動作。此屬性繼承自 CIM_Job。

未知 (0)
其他 (1)
不要繼續 (2)
繼續進行下一個工作 (3)
重新執行作業 (4)
執行復原作業 (5 )

RunDay

資料類型： sint8
存取類型：唯讀
限定詞： MinValue ( -31 ) 、 MaxValue ( 31 )

應處理作業的月份日期。此屬性有不同的解譯，視 RunDayOfWeek的值而定。

當 RunDayOfWeek 為 0 且 RunDay 為正數時， RunDay 會定義處理作業的月份日期。例如，如果 RunDayOfWeek 為 0，而 RunDay 為 12，則會在月份的第^{12 天} 處理作業。

當 RunDayOfWeek 為 0 且 RunDay 為負數時， RunDay 會定義處理作業之月份最後一天之前的天數。 1 表示月份的最後一天，2 表示月份最後一天，依此類錯。例如，如果 RunDayOfWeek 為 0 且 RunDay 為 1，則會在月份的最後一天處理作業。

當 RunDayOfWeek 不是 0 時， RunDayOfWeek 是相對於 RunDay處理作業的星期幾。例如，如果 RunDay 為 15， 而 RunDayOfWeek 為 7 (+Saturday) ，則會在當月第^{15 天} 或之後的第一個星期六處理作業。如果 RunDay 為 20，且 RunDayOfWeek 為 7 (星期六) ，則工作會在當月第^{20 天} 或之前的第一個星期六處理。如果 RunDay 為 1，而 RunDayOfWeek 為 1 (星期日) ，則會在當月的最後一個星期日處理作業。

此屬性繼承自 CIM_Job。

RunDayOfWeek

資料類型： sint8
存取類型：唯讀

與 RunDay 搭配使用的正整數或負整數，表示處理作業的星期幾或月份。如需詳細資訊，請參閱 RunDay 屬性的描述。此屬性繼承自 CIM_Job。

-星期六 ( 7)
-Friday ( 6)
-星期四 ( 5)
-星期三 ( 4)
-星期二 ( 3)
-Monday ( 2)
-Sunday ( 1)
ExactDayOfMonth (0)
星期日 (1)
星期一 (2)
星期二 (3)
星期三 (4)
星期四 (5)
星期五 (6)
星期六 (7 )

RunMonth

資料類型： uint8
存取類型：唯讀

應處理作業的月份。此屬性繼承自 CIM_Job。

1 月 (0)
2 月 (1)
3 月 2 (日)
4 月 (3)
5 月 (4)
6 月 (5 日)
7 月 (6)
8 月 (7 日)
9 月 (8 日)
10 月 (9)
11 月 (10)
12 月 (11 日)

RunStartInterval

資料類型： datetime
存取類型：唯讀

應該處理作業的午夜之後的時間間隔。此屬性繼承自 CIM_Job。

ScheduledStartTime

資料類型： datetime
存取類型：唯讀

如果適用，則為作業的排程開始時間。此屬性繼承自 CIM_Job。

StartTime

資料類型： datetime
存取類型：唯讀

作業開始的時間。此屬性繼承自 CIM_Job。

狀態

資料類型：字串
存取類型：唯讀

此屬性繼承自 CIM_ManagedSystemElement，但不會使用。

StatusDescriptions

資料類型：字串陣列
存取類型：唯讀

描述各種 OperationalStatus 陣列值的字串。此屬性繼承自 CIM_ManagedSystemElement，而且每個陣列元素一律會設定為「OK」。

TimeBeforeRemoval

資料類型： datetime
存取類型：唯讀

作業在執行完成之後，會保留以分鐘為單位的時間量，該作業會在該執行中成功或失敗。不論 DeleteOnCompletion 屬性的值為何，工作都必須持續存在一段時間。預設為五分鐘。此屬性繼承自 CIM_ConcreteJob，且一律設定為 000000000000500.0000000：000。

TimeOfLastStateChange

資料類型： datetime
存取類型：唯讀

上次變更作業狀態的日期或時間。如果作業的狀態尚未變更，而且已填入此屬性，則必須將它設定為 0 間隔值。如果要求狀態變更，但已拒絕或尚未處理，則屬性不得更新。此屬性繼承自 CIM_ConcreteJob。

TimeSubmitted

資料類型： datetime
存取類型：唯讀

提交作業的時間。此屬性繼承自 CIM_Job。

UntilTime

資料類型： datetime
存取類型：唯讀

作業無效或應該停止的時間。此屬性繼承自 CIM_Job。

VirtualSystemName

資料類型：字串
存取類型：唯讀

受影響虛擬系統的唯一名稱。

規格需求

需求	值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
命名空間	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

共用方式為

Msvm_MigrationJob 類別

語法

成員

方法

屬性

規格需求

意見反應

其他資源