Msvm_MigrationJob 类

项目
06/12/2023

此类表示虚拟系统迁移服务为存储或虚拟系统迁移创建的迁移操作作业。

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

方法	说明
GetError	检索迁移作业的错误对象（如果存在）。
GetErrorEx	检索迁移作业的错误对象（如果存在）。
KillJob	不支持此方法。
RequestStateChange	请求将迁移作业的状态更改为指定状态。

属性

Msvm_MigrationJob 类具有这些属性。

可取消

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

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

Caption

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

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

CommunicationStatus

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

指示检测与基础托管元素通信的能力。 Null 值表示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

DeleteOnCompletion

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

指定是否应在完成后自动删除作业。此属性继承自 CIM_Job。

描述

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

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

DestinationHost

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

虚拟系统要迁移到的目标虚拟化平台的主机名。对于存储迁移，这将为 Null 。

DetailedStatus

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

Compliment the PrimaryStatus property with additional status detail. 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 (新) 、5 (挂起) 或 11 (服务) 状态移动到 4 (正在运行) 状态。
正在运行 4	作业正在运行。
已挂起 5	作业已停止，但可以无缝重启。
关闭 6	作业将移动到 7 (已完成) 、8 (终止) 或 9 (终止) 状态。
已完成 7	作业已正常完成。
终止 8	作业已被“终止”状态更改请求停止。作业及其所有基础进程都将结束，并且只能作为新作业重启。仅作为新作业重启作业的要求特定于作业。
杀 9	作业已被“终止”状态更改请求停止。基础进程可能仍在运行，可能需要清理才能释放资源。
Exception 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 属性定义的值之一。

名称

数据类型： 字符串
访问类型：只读
限定符：密钥、 MaxLen ( 256 )

作业的此实例的显示名称。此外，显示名称可用作搜索或查询的属性。此属性继承自 CIM_ManagedSystemElement。

NewResourceSettingData

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

对于实时迁移，这始终设置为 Null。

对于存储迁移，如果为 Null，则不会移动虚拟机的虚拟硬盘 (VHD) 。否则，这将包含表示要移动的 VHD 的 Msvm_StorageAllocationSettingData 类的嵌入实例数组。这些实例的 Connection 属性将指定 VHD 的目标位置。

NewSystemSettingData

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

对于实时迁移，这始终设置为 Null。

对于存储迁移，如果为 Null，则虚拟机的数据根不会移动。否则，这将包含 Msvm_VirtualSystemSettingData 类的嵌入实例，其中 ExternalDataRoot、 SnapshotDataRoot 和 SwapFileDataRoot 属性将指定新的数据根。

通知

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

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

OperatingStatus

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

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

OperationalStatus

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

对象的当前状态。此属性继承自 CIM_ManagedSystemElement，每个数组元素始终设置为 2 (正常) 。

OtherRecoveryAction

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

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

所有者

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

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

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月 (日
10 月 (9 日)
11 月 (10 日)
12 月 (11 日 )

RunStartInterval

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

应处理作业的午夜后的时间间隔。此属性继承自 CIM_Job。

ScheduledStartTime

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

作业的计划开始时间（如果适用）。此属性继承自 CIM_Job。

StartTime

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

作业开始的时间。此属性继承自 CIM_Job。

Status

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

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

StatusDescriptions

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

描述各种 OperationalStatus 数组值的字符串。此属性继承自 CIM_ManagedSystemElement，并且每个数组元素始终设置为“OK”。

TimeBeforeRemoval

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

作业完成执行后保留的时间量（以分钟为单位），执行成功或失败。无论 DeleteOnCompletion 属性的值如何，该作业都必须保留一段时间。默认值为 5 分钟。此属性继承自 CIM_ConcreteJob，始终设置为 00000000000500.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 类

语法

成员

方法

属性

要求

反馈

其他资源