Msvm_StorageJob 类

项目
06/13/2023

表示Microsoft Hyper-V映像管理服务创建的存储操作作业。

以下语法是简化的托管对象格式 (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 类具有这些方法。

方法	说明
GetError	检索描述作业失败原因的错误。
GetErrorEx	当作业正在执行或终止且未出错时，此方法不会返回 Msvm_Error 实例。但是，如果作业因某些内部问题或作业已被客户端终止而失败，则返回一个或多个 Msvm_Error 实例。
KillJob	不支持此方法。
RequestStateChange	请求状态更改。

属性

Msvm_StorageJob 类具有这些属性。

可取消

数据类型： 布尔值
访问类型：只读

指示是否可以取消作业。此属性的值不保证取消作业的请求会成功。

Caption

数据类型： 字符串
访问类型：只读

对象的简短说明。此属性继承自 CIM_ManagedElement。

孩子

数据类型： 字符串
访问类型：只读

异步操作失败时，此属性包含受此操作影响的 VHD 子级的完整路径。

CommunicationStatus

数据类型： uint16
访问类型：只读

指示检测与基础托管元素通信的能力。 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

数据类型： string
访问类型：只读

唯一标识此类的实例。此属性继承自 CIM_ManagedElement。

JobCompletionStatusCode

数据类型： UINT32
访问类型：只读

描述异步操作的完成状态的 HRESULT 代码。

JobRunTimes

数据类型： uint32
访问类型：只读

应运行作业的次数。值为 1 表示作业不是重复的，而任何非零值表示对作业的重复次数的限制。零表示可以处理作业的次数没有限制，但在达到 UntilTime 或手动终止作业之后，该作业将终止。此属性继承自 CIM_Job。

JobState

数据类型： uint16
访问类型：只读

作业的操作状态。它还可以指示这些状态之间的转换，例如，6 (关闭) 和 3 (开始) 。此属性继承自 CIM_ConcreteJob。

值	含义
新建 2	作业从未启动。
正在启动 3	作业正在从“新建”、“已挂起”或“服务”状态移动到“正在运行”状态。
正在运行 4	作业正在运行。
已挂起 5	作业已停止，但可以无缝重启。
关闭 6	作业将转换为“已完成”、“已终止”或“已终止”状态。
已完成 7	作业已正常完成。
终止 8	作业已被“终止”状态更改请求停止。作业及其所有基础进程都将结束，并且只能作为新作业重启。仅作为新作业重启作业的要求特定于作业。
杀 9	作业已被“终止”状态更改请求停止。基础进程可能仍在运行，可能需要清理才能释放资源。
Exception 10	作业处于异常状态，这可能指示错误情况。作业的实际状态可能通过特定于作业的对象提供。
服务 11	作业处于供应商特定的状态，支持问题发现或解决问题，或同时支持这两者。
DMTF 保留 12 32767	保留。
供应商预留 32768 65535	保留。

JobStatus

数据类型： string
访问类型：只读

表示作业状态的字符串。此属性继承自 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 )

名称

数据类型： string
访问类型：只读

对象的已知标签。此属性继承自 CIM_ManagedSystemElement。

通知

数据类型： 字符串
访问类型：只读

作业完成或失败时收到通知的用户。此属性继承自 CIM_Job。

OperatingStatus

数据类型： uint16
访问类型：只读

提供元素操作条件的当前状态信息，并可用于提供有关 EnabledState 属性值的更多详细信息。 Null 值表示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

OperationalStatus

数据类型： uint16 数组
访问类型：只读

对象的当前状态。此属性继承自 CIM_ManagedSystemElement。

OtherRecoveryAction

数据类型： 字符串
访问类型：只读

描述当实例的 RecoveryAction 属性为 1 (其他) 时恢复操作的字符串。此属性继承自 CIM_Job。

所有者

数据类型： 字符串
访问类型：只读

提交作业的用户。此属性继承自 CIM_Job。

Parent

数据类型： 字符串
访问类型：只读

异步操作失败时，此属性包含受此操作影响的 VHD 父级的文件路径。

PercentComplete

数据类型： uint16
访问类型：只读
限定符： MinValue ( 0 ) 、 MaxValue ( 100 ) 、单位 (“百分比”)

作业的完成百分比。此属性继承自 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 (+星期六) ，则作业将在当月的第^{15 天} 或之后的第一个星期六处理。如果 RunDay 为 20， RunDayOfWeek 为 7 (星期六) ，则作业将在当月第^{20 天} 或之前的第一个星期六处理。如果 RunDay 为 1， RunDayOfWeek 为 1 ( 星期日) ，则作业将在当月的最后一个星期天处理。

此属性继承自 CIM_Job。

RunDayOfWeek

数据类型： sint8
访问类型：只读

与 RunDay 一起使用的正整数或负整数，用于指示处理作业的星期几或月份。有关详细信息，请参阅 RunDay 属性的说明。此属性继承自 CIM_Job。

-星期六 ( 7)
-星期五 ( 6)
-星期四 ( 5)
-星期三 ( 4)
-星期二 ( 3)
-星期一 ( 2)
-星期日 ( 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。

Status

数据类型： string
访问类型：只读

此属性继承自 CIM_ManagedSystemElement，但不使用它。

StatusDescriptions

数据类型： 字符串 数组
访问类型：只读

描述各种 OperationalStatus 数组值的字符串。此属性继承自 CIM_ManagedSystemElement。

TimeBeforeRemoval

数据类型： datetime
访问类型：只读

作业完成执行后保留的时间（以分钟为单位），执行成功或失败。无论 DeleteOnCompletion 属性的值如何，作业都必须保留一段时间。默认值为 5 分钟。此属性继承自 CIM_ConcreteJob，始终设置为 00000000000500.000000：0000。

TimeOfLastStateChange

数据类型： datetime
访问类型：只读

上次修改虚拟机状态的时间。此属性继承自 CIM_EnabledLogicalElement。

TimeSubmitted

数据类型： datetime
访问类型：只读

提交作业的时间。此属性继承自 CIM_Job。

UntilTime

数据类型： datetime
访问类型：只读

作业无效或应停止的时间。此属性继承自 CIM_Job。

备注

UAC 筛选可能会限制对 Msvm_StorageJob 类的访问。有关详细信息，请参阅用户帐户控制和 WMI。

要求

要求	值
最低受支持的客户端	Windows 8 [仅限桌面应用]
最低受支持的服务器	Windows Server 2012 [仅限桌面应用]
命名空间	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

另请参阅

CIM_ConcreteJob
CIM_ConcreteJob
存储类

通过

Msvm_StorageJob 类

语法

成员

方法

属性

备注

要求

另请参阅

反馈

其他资源