MSFT_StorageJob 类
表示存储作业。
托管对象格式 (MOF) 代码简化了以下语法。
存储作业表示存储子系统上长时间运行的操作。 可以通过以下任一方式启动这些操作：
- 由用户，通过此 MOF 定义的各种管理接口。
- 通过智能存储子系统自动执行。
语法
class MSFT_StorageJob : MSFT_StorageObject
{
String Name;
String Description;
Datetime ElapsedTime;
UInt16 ErrorCode;
String ErrorDescription;
UInt16 JobState;
String JobStatus;
UInt16 LocalOrUtcTime;
UInt16 OperationalStatus[];
String StatusDescriptions[];
UInt16 PercentComplete;
Datetime StartTime;
Datetime TimeBeforeRemoval;
Datetime TimeOfLastStateChange;
Datetime TimeSubmitted;
Boolean DeleteOnCompletion;
Boolean IsBackgroundTask;
UInt16 RecoveryAction;
String OtherRecoveryAction;
};
成员
MSFT_StorageJob 类具有以下类型的成员：
方法
MSFT_StorageJob 类具有这些方法。
| 方法 | 说明 |
|---|---|
| GetExtendedStatus | 检索不成功的存储作业的扩展状态信息。 |
| RequestStateChange | 请求将作业的状态更改为 RequestedState 参数中指定的值。 |
属性
MSFT_StorageJob 类具有这些属性。
DeleteOnCompletion
数据类型： 布尔值
访问类型：只读
如果 为 TRUE，则存储作业将在短时间间隔后自动删除。
说明
数据类型： 字符串
访问类型：只读
存储作业正在跟踪的操作的文本说明。
ElapsedTime
数据类型： Datetime
访问类型：只读
如果作业仍在执行，则此属性指示它已执行了多长时间。 如果作业完成，则为总执行时间。
ErrorCode
数据类型： UInt16
访问类型：只读
如果此存储作业跟踪的操作失败，提供程序会将此属性设置为由调用操作的方法定义的错误代码。 如果此存储作业正在跟踪后台任务，则可以将错误代码设置为以下值映射中定义的任何有效的存储管理错误代码。 如果没有错误，则必须将此属性设置为 Success。 在操作完成之前，此属性应为 NULL 。
ErrorDescription
数据类型： 字符串
访问类型：只读
包含供应商的错误说明的自由格式字符串。
IsBackgroundTask
数据类型： 布尔值
访问类型：只读
限定符： 必需
如果 为 TRUE，则此存储作业表示由存储子系统启动的自动后台任务。 对于所有用户或管理发起的操作，此值应设置为 FALSE。
JobState
数据类型： UInt16
访问类型：只读
限定符： 必需
作业的状态。
新 (2)
从 (3)
运行 (4)
暂停 (5)
关闭 (6)
已完成 (7)
已终止 (8)
(9) 被杀
异常 (10)
服务 (11)
查询挂起 (12)
Microsoft 保留 (13..32767)
供应商预留 (32768..65535)
JobStatus
数据类型： 字符串
访问类型：只读
一个自由格式的字符串，表示作业的状态。 主要状态反映在 OperationalStatus 属性中。 JobStatus 提供了其他特定于实现的详细信息。
LocalOrUtcTime
数据类型： UInt16
访问类型：只读
限定符： 值 (“本地时间”、“UTC 时间”) 、 ValueMap (“1”、“2”)
指示 RunStartInterval 和 UntilTime 属性中的时间值是表示本地时间还是 UTC 时间。 通过将此属性设置为 UTC 时间，可在全球范围内同步时间值。
名称
数据类型： 字符串
访问类型：只读
限定符： 必需
存储作业的系统定义名称。
OperationalStatus
数据类型： UInt16 数组
访问类型：只读
限定符： 必需
指示参与存储作业的每个存储子系统的当前状态。
| 值 | 含义 |
|---|---|
| 未知 0 | 操作状态未知。 |
| 其他 1 | 在 OtherOperationalStatusDescription 属性中指定了特定于供应商的 OperationalStatus。 |
| 确定 2 | 存储子系统正在响应命令，并且处于正常运行状态。 |
| 降级 3 | 存储子系统正在响应命令，但未以最佳运行状态运行。 |
| 压力 4 | 存储子系统正常运行，但需要注意。 例如，它可能过载或过热。 |
| 预测性故障 5 | 存储子系统正常运行，但在不久的将来可能会发生故障。 |
| 错误 6 | 出现错误。 |
| 不可恢复的错误 7 | 发生了不可恢复的错误。 |
| 开始 8 | 存储子系统正在启动。 |
| 正在停止 9 | 存储子系统正在停止。 |
| 已停止 10 | 存储子系统以干净有序的方式停止或关闭。 |
| 在服务 11 中 | 正在配置、维护、清理或管理存储子系统。 |
| 无联系人 12 | 存储提供程序知道存储子系统，但从未能够与其通信。 |
| 丢失通信 13 | 存储提供程序知道存储子系统，并且过去曾与之通信，但目前无法与其通信。 |
| 中止 14 | 存储子系统突然停止，可能需要配置或维护。 |
| 休眠 15 | 存储提供程序能够联系存储子系统，但存储子系统当前不处于活动状态。 |
| 错误 16 中的支持实体 | 此值指示存储子系统所依赖的另一个设备或连接可能需要注意。 这不一定表示存储子系统本身出现问题。 |
| 已完成 17 | 存储子系统已完成操作。 此值应与“确定”、“错误”或“已降级”组合，具体取决于操作的结果。 |
| 电源模式 18 | 该值已预留供系统使用。 |
| DMTF 保留 。 | 介于 18 和 0x8000 (独占) 之间的值是为 DMTF 保留的。 |
| 供应商预留 0x8000。 | 大于或等于 0x8000 的值是为供应商保留的。 |
OtherRecoveryAction
数据类型： 字符串
访问类型：只读
要对未成功运行的作业执行的特定于供应商的恢复操作。 仅当 RecoveryAction 设置为 Other 时，才应设置此属性。
PercentComplete
数据类型： UInt16
访问类型：只读
请求此值时已完成的作业的百分比。
RecoveryAction
数据类型： UInt16
访问类型：只读
描述要对未成功运行的作业采取的恢复操作。 以下值之一。
| “值” | 含义 |
|---|---|
| 未知 0 | 所需的恢复操作未知。 |
| 其他 1 | 恢复操作在 OtherRecoveryAction 属性中指定。 |
| 不继续 2 | 停止执行存储作业并相应地更新其状态。 |
| 继续下一个作业 3 | 继续执行队列中的下一个作业。 |
| 重新运行作业 4 | 重新运行作业。 |
StartTime
数据类型： Datetime
访问类型：只读
启动作业的时间。
StatusDescriptions
数据类型： 字符串 数组
访问类型：只读
OperationalStatus 值的说明。 例如，如果 停止 是 OperationalStatus 中的值， 则 StatusDescriptions 的相应数组元素可能会解释停止对象的原因。
TimeBeforeRemoval
数据类型： Datetime
访问类型：只读
作业完成执行后保留的时间量（以秒为单位），执行成功或失败。 无论 DeleteOnCompletion 属性的值如何，该作业都必须保留一段时间。
TimeOfLastStateChange
数据类型： Datetime
访问类型：只读
作业状态上次更改的时间。 如果作业的状态未更改，并且此属性没有值，则必须将其设置为零。 如果请求了状态更改，但遭到拒绝或尚未处理，则不得更新此属性的值。
TimeSubmitted
数据类型： Datetime
访问类型：只读
提交作业以供执行的时间。 所有零的值表示拥有元素无法报告日期和时间。 因此， ScheduledStartTime 和 StartTime 作为相对于请求其值的时间间隔进行报告。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
| 命名空间 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |