Msvm_StorageJob 類別

發行項
06/13/2023

表示Microsoft Hyper-V映射管理服務所建立的儲存體作業作業。

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

語法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_StorageJob : CIM_ConcreteJob
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  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;
  string   ErrorSummaryDescription;
  uint16   RecoveryAction;
  string   OtherRecoveryAction;
  uint16   JobState;
  datetime TimeOfLastStateChange;
  datetime TimeBeforeRemoval = 00000000000500.000000:000";
  boolean  Cancellable;
  string   Child;
  UINT32   JobCompletionStatusCode;
  string   Parent;
  uint16   JobType;
};

成員

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

方法
屬性

方法

Msvm_StorageJob類別具有這些方法。

方法	Description
GetError	擷取錯誤，描述作業失敗的原因。
GetErrorEx	當作業執行中或已終止且沒有錯誤時，此方法不會傳回任何Msvm_Error 實例。不過，如果作業因為某些內部問題而失敗，或因為作業已由用戶端終止，則會傳回一或多個 Msvm_Error 實例。
KillJob	不支援這個方法。
RequestStateChange	要求狀態變更。

屬性

Msvm_StorageJob類別具有這些屬性。

可取消

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

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

標題

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

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

孩子

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

非同步作業失敗時，這個屬性包含此作業所影響之 VHD 子系的完整路徑。

CommunicationStatus

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

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

DeleteOnCompletion

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

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

說明

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

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

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「)

如果存在，則為錯誤的摘要描述。此屬性繼承自 CIM_Job。

HealthState

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

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

InstallDate

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

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

InstanceID

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

唯一識別這個類別的實例。此屬性繼承自 CIM_ManagedElement。

JobCompletionStatusCode

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

描述非同步作業完成狀態的 HRESULT 程式碼。

JobRunTimes

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

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

JobState

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

作業的操作狀態。它也可以指出這些狀態之間的轉換，例如 6 個 (關閉) 和 3 個 (開始) 。此屬性繼承自 CIM_ConcreteJob。

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

JobStatus

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

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

JobType

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

這個實例所追蹤的非同步操作類型 Msvm_StorageJob。

未知 (0)

VHD 建立 (1)

(VHD) 映射建立虛擬硬碟。

磁碟片建立 (2)

(VFD) 建立虛擬磁片映射。

壓縮 (3)

壓縮 VHD 映射的大小。

擴充 (4)

擴充 VHD 映射的大小。

合併 (5)

將多個 VHD 映射合併成單一映射。

轉換 (6)

轉換虛擬硬碟映射的類型。

回送掛接 (7)

在父磁碟分割上掛接虛擬硬碟

取得 VHD 資訊 (8)

在管理作業系統上掛接 VHD。

驗證 VHD 映射 (9)

LocalOrUtcTime

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

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

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

名稱

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

已知物件的標籤。此屬性繼承自 CIM_ManagedSystemElement。

通知

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

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

OperatingStatus

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

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

OperationalStatus

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

物件的目前狀態。此屬性繼承自 CIM_ManagedSystemElement。

OtherRecoveryAction

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

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

擁有者

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

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

父系

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

非同步作業失敗時，這個屬性會包含此作業所影響之 VHD 父系的檔案路徑。

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。

TimeBeforeRemoval

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

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

TimeOfLastStateChange

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

上次修改虛擬機器狀態的時間。此屬性繼承自 CIM_EnabledLogicalElement。

TimeSubmitted

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

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

UntilTime

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

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

備註

Msvm_StorageJob類別的存取可能會受限於 UAC 篩選。如需詳細資訊，請參閱使用者帳戶控制和 WMI。

規格需求

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

另請參閱

CIM_ConcreteJob
CIM_ConcreteJob
儲存類別

共用方式為

Msvm_StorageJob 類別

語法

成員

方法

屬性

備註

規格需求

另請參閱

意見反應

其他資源