共用方式為

CIM_Job類別

  • 發行項

邏輯專案，表示執行的工作單位，例如腳本或列印作業。 作業與進程不同，其中作業可以排程或排入佇列，而且其執行不限於單一系統。

下列語法已經過受管理物件格式 (MOF) 程式碼簡化，並包含所有已繼承的屬性。

語法

[UMLPackagePath("CIM::Core::CoreElements"), Abstract, Version("2.10.0"), AMENDMENT]
class CIM_Job : CIM_LogicalElement
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   JobStatus;
  datetime TimeSubmitted;
  datetime ScheduledStartTime;
  datetime StartTime;
  datetime ElapsedTime;
  uint32   JobRunTimes = 1;
  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;
};

成員

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

方法

CIM_Job 類別具有這些方法。

方法 描述
KillJob KillJob 已被取代，因為有條不紊的關機和立即終止之間沒有區別。

屬性

CIM_Job 類別具有這些屬性。

標題

數據類型： 字串

存取類型：唯讀

限定符： MaxLen （64）

包含物件的簡短文字描述。

此屬性繼承自 CIM_ManagedElement。

CommunicationStatus

數據類型： uint16

存取類型：唯讀

表示檢測能夠與這個項目通訊。 NULL 值表示檢測不支援此屬性。

此屬性繼承自 CIM_ManagedSystemElement。

值 意義
Unknown
0
 表示檢測目前無法報告 CommunicationStatus 屬性。
無法使用
1
 表示檢測能夠報告這個屬性，但刻意不會針對這個專案。
通訊正常
2
 僅表示與專案建立通訊。
遺失通訊
3
 表示過去已連絡專案，但目前無法連線。
無連絡人
4
 表示檢測具有這個專案的連絡資訊，但從未能夠與其通訊。
DMTF 保留
5 32767
 已保留。
廠商保留
32768 = value
已保留。

DeleteOnCompletion

數據類型： 布爾值

存取類型：讀取/寫入

指出作業是否應該在完成時自動刪除。 請注意，週期性作業的「完成」是由其 JobRunTimes 或 UntilTime 屬性所定義，或是當作業以手動介入終止時。 如果此屬性設定為 false 且作業完成，則必須使用 extrinsic 方法 DeleteInstance 來刪除作業，而不是更新此屬性。

說明

數據類型： 字串

存取類型：唯讀

提供物件的文字描述。

此屬性繼承自 CIM_ManagedElement。

DetailedStatus

數據類型： uint16

存取類型：唯讀

限定符： ModelCorrespondence （“CIM_EnabledLogicalElement.PrimaryStatus”、“CIM_ManagedSystemElement.HealthState”）

指出補充 PrimaryStatus 屬性的其他狀態詳細數據。 NULL 值表示檢測不支援這個屬性。

此屬性繼承自 CIM_ManagedSystemElement。

值 意義
無法使用
0
 表示檢測能夠報告這個屬性，但刻意不會報告這個項目的檢測。
沒有其他資訊
1
 指出沒有詳細數據必須新增至 PrimaryStatus 屬性，例如，當 PrimaryStatus 設定為 [確定] 時。
強調
2
 表示專案函式，但需要注意。 超載和過熱是壓力狀態的範例。
預測性失敗
3
 表示項目名義上運作，但會預測近期的失敗。
無法復原的錯誤
4
 表示此元素處於需要人為介入的錯誤狀況。
支援錯誤中的實體
5
 指出這個專案相依的項目發生錯誤。 此元素可能 沒問題 ，但因相依專案的狀態而無法運作。 例如，網路服務或端點因低層網路問題而無法運作。
DMTF 保留
6 32767
 已保留。
廠商保留
32768 = value
已保留。

ElapsedTime

數據類型： datetime

存取類型：唯讀

作業已執行的時間間隔，如果作業完成，則為總運行時間。 請注意，這個屬性也會出現在JobProcessingStatistics類別中。 這個類別必須擷取週期性作業的處理資訊，因為只有 'last' 運行時間可以儲存在這個單一值屬性中。

ElementName

數據類型： 字串

存取類型：唯讀

包含物件的使用者易記名稱。 這個屬性可讓每個實例除了定義其索引鍵屬性、身分識別數據和描述資訊之外，還定義使用者易記的名稱。

此屬性繼承自 CIM_ManagedElement。

ErrorCode

數據類型： uint16

存取類型：唯讀

限定符： ModelCorrespondence （“CIM_Job.ErrorDescription”）

廠商特定的錯誤碼。 如果作業完成且沒有錯誤，則必須將值設定為零。 請注意，這個屬性也會出現在JobProcessingStatistics類別中。 這個類別需要擷取週期性作業的處理資訊，因為只有 'last' 執行錯誤可以儲存在這個單一值屬性中。

ErrorDescription

數據類型： 字串

存取類型：唯讀

限定符： ModelCorrespondence （“CIM_Job.ErrorCode”）

包含廠商錯誤描述的自由格式字串。 請注意，這個屬性也會出現在JobProcessingStatistics類別中。 這個類別需要擷取週期性作業的處理資訊，因為只有 'last' 執行錯誤可以儲存在這個單一值屬性中。

HealthState

數據類型： uint16

存取類型：唯讀

表示專案的目前健康情況。 這個屬性表示這個專案的健康情況，但不一定表示其子元件的健康情況。

此屬性繼承自 CIM_ManagedSystemElement。

值 意義
Unknown
0
 目前無法報告 HealthState 的實作。
確定
5
 元素功能完整，且在一般操作參數內運作，且沒有錯誤。
降級/警告
10
 元素是工作順序，而且會提供所有功能。 不過，元素無法發揮其最佳功能。 例如，元素可能無法以最佳效能運作，或可能報告可復原的錯誤
次要失敗
15
 所有功能都可供使用，但有些功能可能會降級。
主要失敗
20
 項目失敗。 此元件的某些或所有功能可能已降級或無法運作。
重大失敗
25
 項目無法運作，而且可能無法復原。
無法復原的錯誤
30
 元素已完全失敗，而且無法復原。 這個專案提供的所有功能都已遺失。
DMTF 保留
31 = value
DMTF 已保留持續性的未使用部分，以供未來其他 HealthStates 值使用。

InstallDate

數據類型： datetime

存取類型：唯讀

指出物件安裝的時間。 缺少值並不表示未安裝 物件。

此屬性繼承自 CIM_ManagedSystemElement。

InstanceID

數據類型： 字串

存取類型：唯讀

唯一且不透明地識別這個類別在包含命名空間的範圍內實例。

[!重要]為了確保命名空間內的唯一性，應該以下列模式建構 InstanceID 的值：

OrgID：LocalID

OrgID 必須包含由定義 InstanceID 之商業實體所擁有的著作權、商標或其他唯一名稱，或是由已辨識的全域授權單位指派的已註冊標識符。 這類似於 Schema 類別名稱的結構。 此外，為了確保 InstanceID 中的第一個冒號必須介於 OrgID 和LocalID 之間。 在那裡，OrgID 不得包含冒號 （'：'）。

LocalID 是由商業實體選擇，不應重新用來識別不同的基礎真實世界元素。

如果未使用上述模式，定義實體必須確保由此或這個命名空間的其他提供者所產生的任何 InstanceID 不會重複使用產生的 InstanceID。

針對分散式管理工作組 （DMTF） 定義的實例，模式必須與設定為 CIM 的 OrgID 搭配使用。

此屬性繼承自 CIM_ManagedElement。

JobRunTimes

數據類型： uint32

存取類型：讀取/寫入

作業應該執行的次數。 值為 1 表示作業不是週期性，而任何非零值則表示作業會遞歸的次數限制。 零表示作業可以處理的次數沒有限制，但會在 UntilTime 之後或手動介入終止。 根據預設，作業會處理一次。

JobStatus

數據類型： 字串

存取類型：唯讀

限定符： ModelCorrespondence （“CIM_ManagedSystemElement.OperationalStatus”）

自由格式字串，表示作業的狀態。 主要狀態會反映在繼承的 OperationalStatus 屬性中。 JobStatus 提供其他實作特定詳細數據。

LocalOrUtcTime

數據類型： uint16

存取類型：讀取/寫入

這個屬性表示 RunStartInterval 和 UntilTime 屬性中的時間是否代表本地時間或 UTC 時間。 使用列舉值 2，“UTC 時間”，在全球同步處理時間值。

當地時間 （1）

UTC 時間 （2）

名稱

數據類型： 字串

存取類型：唯讀

限定符： MaxLen （1024）

指出此作業實例的使用者易記名稱。 此外，使用者易記的名稱也可以當做搜尋或查詢的屬性使用。

[!提示]
名稱 在命名空間內不一定是唯一的。

此屬性繼承自 CIM_ManagedSystemElement。

通知

數據類型： 字串

存取類型：讀取/寫入

在作業完成或失敗時收到通知的使用者。

OperatingStatus

數據類型： uint16

存取類型：唯讀

限定符： ModelCorrespondence （“CIM_EnabledLogicalElement.EnabledState”）

表示專案的目前作業條件。 這個屬性可用來提供專案目前狀態的詳細數據。 它也可以指出過渡狀態。 NULL 值表示檢測不支援這個屬性。

此屬性繼承自 CIM_ManagedSystemElement。

值 意義
Unknown
0
 表示檢測目前無法報告 OperatingStatus 屬性。
無法使用
1
 表示檢測能夠報告這個屬性，但刻意不會報告這個項目的檢測。
服務
2
 表示專案正在處理中，以設定、維護、清除或管理。
正在啟動
3
 表示專案正在初始化。
正在停止
4
 表示專案正被帶至有序停止。
已停止
5
 表示已刻意停止專案。
已中止
6
 表示專案以非預期的方式停止。
休眠
7
 表示專案為非使用中或已靜止。
已完成
8
 表示專案已完成其作業。 建議您使用OK、Error或Degraded的 PrimaryStatus 屬性值，以指出作業成功或失敗。
移轉
9
 表示專案正在主項目之間移動。
移民
10
 表示專案正從主元素移開。
移民
11
 表示專案正在移至新的主專案。
快照集
12
 表示正在建立專案的快照集復本。
關閉
13
 表示專案正在突然停止。
在測試中
14
 表示專案正在執行測試函式。
過渡
15
 表示項目位於狀態之間，且兩種狀態都無法完全使用。 使用另一個值，指出如果有的話，表示更具體的轉換。
在服務中
16
 表示專案在服務中且可運作。
DMTF 保留
17 32767
 已保留。
廠商保留
32768 = value
已保留。

OperationalStatus

數據類型： uint16 陣列

存取類型：唯讀

限定符：ArrayType （“Indexed”），ModelCorrespondence （“CIM_ManagedSystemElement.StatusDescriptions”）

包含專案目前狀態的指標。 OperationalStatus 的第一個值應該包含專案的主要狀態。

注意

OperationalStatus 會取代已被 取代的 Status 屬性。 由於在管理應用程式中廣泛使用現有的 Status 屬性，Microsoft 強烈建議提供者或檢測同時提供 Status 和 OperationalStatus 屬性。 檢測時， Status （因為它是單一值），也應該提供專案的主要狀態。

此屬性繼承自 CIM_ManagedSystemElement。

值 意義
Unknown
0
 表示目前無法報告 OperationalStatus 的實作。
其他
1
 表示未定義的狀態。
確定
2
 表示完整功能，而不會發生錯誤。
已降級
3
 表示專案正在運作，並且會提供所有功能。 不過，元素無法發揮其最佳功能。 例如，元素可能無法以最佳效能運作，或可能報告可復原的錯誤
強調
4
 表示元素正常運作，但需要注意。 超載和過熱是壓力狀態的範例。
預測性失敗
5
 表示項目在名義上運作，但預測近期失敗。
錯誤
6
 表示發生錯誤。
無法復原的錯誤
7
 發生無法復原的錯誤。
正在啟動
8
 作業正在啟動。
正在停止
9
 作業正在停止。
已停止
10
 元素已刻意停止。
在服務中
11
 表示正在設定、維護、清除或管理的專案。
無連絡人
12
 表示監視系統具備此元素的知識，但從未能夠與其建立通訊。
遺失通訊
13
 表示已知作業存在，且過去已成功連絡，但目前無法連線。
已中止
14
 表示作業以非預期的方式停止。 可能需要更新作業的狀態和組態。
休眠
15
 表示作業為非使用中狀態。
支援錯誤中的實體
16
 指出此作業相依的項目發生錯誤。 這個元素可能沒 問題 ，但因為相依專案的狀態而無法運作。 例如，網路服務或端點因低層網路問題而無法運作。
已完成
17
 表示作業已完成其作業。 此值應該與 OK、ErrorError 或 Degraded 結合，讓用戶端可以判斷完成的作業已完成與 OK（已傳遞）、已完成錯誤（失敗），或已完成且已降級的作業（作業已完成，但未完成確定或未回報錯誤）。
Power Mode
18
 “Power Mode” 表示元素具有包含在相關聯 PowerManagementService 關聯中的其他電源模型資訊。
DMTF 保留
19 32767
 DMTF 已保留此範圍的這個部分，以供日後的其他 OperationalStatus 值使用。
廠商保留
32768 65535
 Microsoft 已保留範圍中未使用的部分，以供日後的其他 OperationalStatus 值使用。

OtherRecoveryAction

數據類型： 字串

存取類型：唯讀

限定符： ModelCorrespondence （“CIM_Job.RecoveryAction”）

字串，描述實例的 RecoveryAction 屬性為 1 時復原動作（「其他」）。

負責人

數據類型： 字串

存取類型：唯讀

限定符： ModelCorrespondence （“CIM_OwningJobElement”）

提交作業的使用者，或導致建立作業的服務或方法名稱。

PercentComplete

數據類型： uint16

存取類型：唯讀

限定符：MinValue （“0”），MaxValue （“101”），PUnit （“percent”），單位（“Percent”）

要求此值時已完成之作業的百分比。 請注意，這個屬性也會出現在JobProcessingStatistics類別中。 此類別必須擷取週期性作業的處理資訊，因為只有 \'last\' 執行數據可以儲存在這個單一值屬性中。

請注意，值 101 未定義，而且在規格的下一個主要修訂中將不允許。

PrimaryStatus

數據類型： uint16

存取類型：唯讀

限定符： ModelCorrespondence （“CIM_ManagedSystemElement.DetailedStatus”、“CIM_ManagedSystemElement.HealthState”）

表示高階狀態值。

此屬性繼承自 CIM_ManagedSystemElement。

可能的值為 。

未知 （0）

確定 （1）

降級 （2）

錯誤 （3）

DMTF 保留 （4 32767）

廠商保留 （32768 = 值 ）

優先順序

數據類型： uint32

存取類型：讀取/寫入

表示作業執行的緊迫性或重要性。 編號愈低，優先順序愈高。 請注意，這個屬性也會出現在JobProcessingStatistics類別中。 這個類別是必要的，才能擷取會影響作業結果的設定資訊。

RecoveryAction

數據類型： uint16

存取類型：唯讀

限定符： ModelCorrespondence （“CIM_Job.OtherRecoveryAction”）

描述要針對未成功執行作業採取的復原動作。

值 意義
Unknown
0
 目前還不清楚要採取的復原動作。
其他
1
 復原動作將會在 OtherRecoveryAction 屬性中指定。
不要繼續
2
 停止執行作業，並適當地更新其狀態。
繼續進行下一個作業
3
 繼續進行佇列中的下一個作業。
重新執行作業
4
 作業應該重新執行。
執行復原作業
5
 使用 RecoveryJob 關聯性執行相關聯的作業。 請注意，復原作業必須已經在將執行作業的佇列中。

RunDay

數據類型： sint8

存取類型：讀取/寫入

限定符：MinValue （“-31”），MaxValue （“31”），ModelCorrespondence （“CIM_Job.RunMonth”， “CIM_Job.RunDayOfWeek”， “CIM_Job.RunStartInterval”）

應處理作業月份的日期。 此屬性有兩個不同的解譯，視 DayOfWeek 的值而定。 在一種情況下，RunDay 會定義處理作業的月份。 當 DayOfWeek 為 0 時，會使用此解譯。 正整數或負整數表示 RunDay 是否應該從月份的開頭或結尾計算。 例如，5 表示 RunMonth 中的第五天，而 -1 表示 RunMonth 的最後一天。

當 RunDayOfWeek 不是 0 時，RunDay 是處理作業的當月日，會與 RunDayOfWeek 一起定義。 例如，如果 RunDay 是 15，而 RunDayOfWeek 是星期六，則作業會在 RunMonth 的第 15 天或之後的第一個星期六處理（例如，當月的第三個星期六）。 如果 RunDay 為 20，且 RunDayOfWeek 為 -Saturday，則表示 RunMonth 的第一個星期六或第 20 天之前。 如果 RunDay 為 -1 且 RunDayOfWeek 為 -Sunday，則這表示 RunMonth 的最後一個星期日。

RunDayOfWeek

數據類型： sint8

存取類型：讀取/寫入

限定符： ModelCorrespondence （“CIM_Job.RunMonth”、“CIM_Job.RunDay”、“CIM_Job.RunStartInterval”）

正整數或負整數，與 RunDay 搭配使用，表示處理作業的星期幾。 RunDayOfWeek 設定為 0，表示當月的確切日期，例如 3 月 1 日。 正整數（代表星期日、星期一、...、星期六）表示在指定的 RunDay 或之後找到一周中的一天。 負整數（代表 -Sunday、-Monday、...、-Saturday）表示在 RunDay 或 RunDay 之前找到一周中的一天。

-星期六 （-7）

-星期五 （-6）

-星期四 （-5）

-星期三 （-4）

-星期二 （-3）

-Monday （-2）

-星期日 （-1）

ExactDayOfMonth （0）

星期日 （1）

星期一 （2）

星期二 （3）

星期三 （4）

星期四 （5）

星期五 （6）

星期六 （7）

RunMonth

數據類型： uint8

存取類型：讀取/寫入

限定符： ModelCorrespondence （“CIM_Job.RunDay”、“CIM_Job.RunDayOfWeek”、“CIM_Job.RunStartInterval”）

應處理作業的月份。 針對1月指定0、1代表2月等等。

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

存取類型：讀取/寫入

限定符： ModelCorrespondence （“CIM_Job.RunMonth”、“CIM_Job.RunDay”、“CIM_Job.RunDayOfWeek”、“CIM_Job.RunStartInterval”）

應處理作業的午夜之後的時間間隔。 例如，

00000000020000.000000:000

表示作業應該在兩點鐘、當地時間或UTC時間之後執行（使用LocalOrUtcTime屬性來辨別。

ScheduledStartTime

數據類型： datetime

存取類型：讀取/寫入

限定符： 已 淘汰 （“CIM_Job.RunMonth”、“CIM_Job.RunDay”、“CIM_Job.RunDayOfWeek”、“CIM_Job.RunStartInterval”）

目前作業排程開始的時間。 這個時間可以由實際日期和時間表示，或相對於要求這個屬性的時間的間隔。 所有零的值表示作業已經執行。 屬性取代了更具表現力的排程屬性 RunMonth、RunDay、RunDayOfWeek 和 RunStartInterval。

StartTime

數據類型： datetime

存取類型：唯讀

作業實際啟動的時間。 這個時間可以以實際日期和時間表示，或以相對於要求這個屬性的時間的間隔來表示。 請注意，這個屬性也會出現在JobProcessingStatistics類別中。 這個類別必須擷取週期性作業的處理資訊，因為只有 'last' 運行時間可以儲存在這個單一值屬性中。

狀態

數據類型： 字串

存取類型：唯讀

限定符：已淘汰 （“CIM_ManagedSystemElement.OperationalStatus”），MaxLen （10）

包含字串，指出物件的主要狀態。

注意

這個屬性已被取代，並由 OperationalStatus 屬性取代。 如果您選擇使用 Status 屬性進行回溯相容性，它應該次要於 OperationalStatus 屬性。

此屬性繼承自 CIM_ManagedSystemElement。

可能的值為 。

（“OK”）

（“錯誤”）

（“已降級”）

（“未知”）

（“Pred Fail”）

（“起始”）

（“停止”）

（“服務”）

（“壓力”）

（“NonRecover”）

（“無聯繫人”）

（“Lost Comm”）

（“已停止”）

StatusDescriptions

數據類型： 字串 陣列

存取類型：唯讀

限定符：ArrayType （“Indexed”），ModelCorrespondence （“CIM_ManagedSystemElement.OperationalStatus”）

指出 OperationalStatus 陣列中對應值的描述。 例如，如果 OperationalStatus 屬性中的元素包含 Stopping 值，則此屬性中相同陣列索引的專案可能會包含停止物件原因的說明。

此屬性繼承自 CIM_ManagedSystemElement。

TimeSubmitted

數據類型： datetime

存取類型：唯讀

提交作業執行的時間。 所有零的值表示擁有項目無法報告日期和時間。 因此，ScheduledStartTime 和 StartTime 會回報為相對於要求其值之時間的間隔。

UntilTime

數據類型： datetime

存取類型：讀取/寫入

限定符： ModelCorrespondence （“CIM_Job.LocalOrUtcTime”）

作業無效或應該停止的時間。 這個時間可以以實際日期和時間表示，或以相對於要求這個屬性的時間的間隔來表示。 所有 9 的值都表示作業可以無限期執行。

需求
最低支援的用戶端
 Windows 8
最低支援的伺服器
 Windows Server 2012
Namespace
 Root\standardcimv2
MOF
NetTCPIP.mof
DLL
NetTCPIP.dll

另請參閱

CIM_LogicalElement