通过

Msvm_VirtualSystemSettingData 类

  • 项目

表示虚拟机的虚拟化特定设置。

以下语法是简化的托管对象格式 (MOF) 代码，其中包含所有继承的属性。

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualSystemSettingData : CIM_VirtualSystemSettingData
{
  string   InstanceID;
  string   Caption = "Virtual Machine Settings";
  string   Description;
  string   ElementName;
  string   VirtualSystemIdentifier;
  string   VirtualSystemType;
  string   Notes[];
  datetime CreationTime;
  string   ConfigurationID;
  string   ConfigurationDataRoot;
  string   ConfigurationFile;
  string   SnapshotDataRoot;
  string   SuspendDataRoot;
  string   SwapFileDataRoot;
  string   LogDataRoot;
  uint16   AutomaticStartupAction;
  datetime AutomaticStartupActionDelay;
  uint16   AutomaticStartupActionSequenceNumber;
  uint16   AutomaticShutdownAction;
  uint16   AutomaticRecoveryAction;
  string   RecoveryFile;
  string   BIOSGUID;
  string   BIOSSerialNumber;
  string   BaseBoardSerialNumber;
  string   ChassisSerialNumber;
  string   Architecture;
  string   ChassisAssetTag;
  boolean  BIOSNumLock;
  uint16   BootOrder[];
  string   Parent;
  uint16   UserSnapshotType;
  boolean  IsSaved;
  string   AdditionalRecoveryInformation;
  boolean  AllowFullSCSICommandSet;
  uint32   DebugChannelId;
  uint16   DebugPortEnabled;
  uint32   DebugPort;
  string   Version;
  boolean  IncrementalBackupEnabled;
  boolean  VirtualNumaEnabled;
  boolean  AllowReducedFcRedundancy = False;
  string   VirtualSystemSubType;
  string   BootSourceOrder[];
  boolean  PauseAfterBootFailure;
  uint16   NetworkBootPreferredProtocol;
  boolean  GuestControlledCacheTypes;
  boolean  AutomaticSnapshotsEnabled;
  boolean  IsAutomaticSnapshot;
  string   GuestStateFile;
  string   GuestStateDataRoot;
  boolean  LockOnDisconnect;
  string   ParentPackage;
  datetime AutomaticCriticalErrorActionTimeout;
  uint16   AutomaticCriticalErrorAction;
  uint16   ConsoleMode;
  boolean  SecureBootEnabled;
  string   SecureBootTemplateId;
  uint64   LowMmioGapSize;
  uint64   HighMmioGapSize;
  uint16   EnhancedSessionTransportType;
};

成员

Msvm_VirtualSystemSettingData 类具有以下类型的成员：

属性

Msvm_VirtualSystemSettingData 类具有以下属性。

AdditionalRecoveryInformation

数据类型： string

访问类型：读/写

提供给恢复操作的任何其他信息。 此属性的含义由 AutomaticRecoveryAction 中的 操作定义。 如果 AutomaticRecoveryAction 为 0 (“None”) 或 1 (“Restart”) ，则此值为 Null。 如果 AutomaticRecoveryAction 为 2 (“Revert to Snapshot”) ，则这是应在虚拟机工作进程失败时应用的快照的对象路径。

AllowFullSCSICommandSet

数据类型： 布尔值

访问类型：读/写

如果来宾操作系统中的 SCSI 命令传递到直通磁盘，则为 True;否则为 False。 如果 为 True，则不会筛选来宾操作系统向直通磁盘发出的 SCSI 命令。 建议为生产部署保持 SCSI 筛选启用状态。

AllowReducedFcRedundancy

数据类型： 布尔值

访问类型：读/写

指定是否允许使用虚拟光纤通道适配器配置的虚拟机实时迁移到目标光纤通道设备的路径可能不存在或减少的目标计算机。 此属性应在实时迁移后清除。

值 含义
错误
 虚拟机无法实时迁移到目标计算机，而目标光纤通道设备可能没有路径或路径减少。
True
 虚拟机可以实时迁移到目标计算机，该计算机可能没有或减少目标光纤通道设备的路径。 来宾操作系统可能会失去与存储的连接，并可能以不可预知的方式运行。

体系结构

数据类型： string

访问类型：只读

此系统的体系结构。

注意

在 Windows 10 版本 1709 中添加。

x64 ()

arm64 ()

AutomaticCriticalErrorAction

数据类型： uint16

访问类型：读/写

标识在发生严重错误（例如存储断开连接）时在 VM 上执行的操作。

注意

在 Windows 10 和 Windows Server 2016 中添加。

无 (0)

不会对严重错误条件采取任何特定操作。

暂停恢复 (1)

导致 VM 暂停，并在解决严重错误条件时自动恢复。

AutomaticCriticalErrorActionTimeout

数据类型： datetime

访问类型：读/写

限定符： SubType (“interval”)

标识执行 AutomaticCriticalErrorAction 以解决严重错误的最大持续时间。 仅当 AutomaticCriticalErrorAction 属性的值不是 0 (None) 时，这才适用。 超时到期后，VM 将关闭电源。 该值将向上舍入到最接近的分钟。 如果值为 0，则表示 VM 在遇到严重错误条件时应立即关闭电源。

注意

在 Windows 10 和 Windows Server 2016 中添加。

AutomaticRecoveryAction

数据类型： uint16

访问类型：只读

虚拟机执行的软件失败时要对虚拟机执行的操作。 在这种情况下，故障是指主机平台可检测到的故障，例如不间断的等待状态条件。 此属性继承自 CIM_VirtualSystemSettingData。

这可以是以下值之一。

值 含义
2
 无。
3
 重启。
4
 还原为快照。
5..32768
 保留。

AutomaticShutdownAction

数据类型： uint16

访问类型：只读

关闭主机时要对虚拟机执行的操作。 此属性继承自 CIM_VirtualSystemSettingData。

这可以是以下值之一。

值 含义
2
 关闭。
3
 保存状态。
4
 关闭。
5..32768
 保留。

AutomaticSnapshotsEnabled

数据类型： 布尔值

访问类型：读/写

指示此虚拟机是否应启用自动快照。

注意

在 Windows 10 版本 1709 中添加。

AutomaticStartupAction

数据类型： uint16

访问类型：只读

启动主机时要对虚拟机执行的操作。 此属性继承自 CIM_VirtualSystemSettingData。

这可以是以下值之一。

值 含义
2
 无。
3
 如果以前处于活动状态，请重启。
4
 始终“启动”。
5..32768
 保留。

AutomaticStartupActionDelay

数据类型： datetime

访问类型：只读

虚拟机自动启动之前的延迟时间。 此属性继承自 CIM_VirtualSystemSettingData。

AutomaticStartupActionSequenceNumber

数据类型： uint16

访问类型：只读

一个数字，指示启动主机系统时虚拟机激活的相对顺序。 较小的数字表示提前激活。 如果一个或多个配置显示相同的值，则序列依赖于实现。 值为 0 表示序列依赖于实现。 此属性继承自 CIM_VirtualSystemSettingData。

BaseBoardSerialNumber

数据类型： string

访问类型：读/写

虚拟机基板的序列号。

BIOSGUID

数据类型： string

访问类型：读/写

虚拟机 BIOS 的全局唯一标识符。

BIOSNumLock

数据类型： 布尔值

访问类型：读/写

如果 BIOS 将 num lock 键设置为 on，则为 True;如果 BIOS 将 num lock 键设置为 off，则为 False。

BIOSSerialNumber

数据类型： string

访问类型：读/写

虚拟机 BIOS 的序列号。

BootOrder

数据类型： uint16 数组

访问类型：读/写

限定符： ArrayType (“Indexed”) ， MAX (4)

虚拟机 BIOS 中设置的启动顺序。 此属性是一个值数组， 从 BootOrder[0] 到 BootOrder[3]（含），其中每个值都指示要从中启动的设备。 数组中的 4 个值中的每一个都必须设置，并且不能与数组中的另一个值相同。 虚拟机将首先尝试从数组中的第一个值指示的设备启动。 如果该设备不包含启动扇区，则虚拟机将尝试从 BootOrder 属性指定的下一台设备启动，依此启动。 如果在 BootOrder 中指定的设备不包含启动扇区，则虚拟机将无法启动。 虚拟机的默认值为 [0， 1， 2， 3]。

软盘 (0)

虚拟机将尝试从软盘驱动器中的软盘启动。

CD-ROM (1)

虚拟机将尝试从使用启动扇区找到的第一个 CD 或 DVD 磁盘启动。

IDE 硬盘驱动器 (2)

虚拟机将尝试从使用启动扇区找到的第一个硬盘驱动器启动。

PXE 启动 (3)

虚拟机将尝试从网络启动 PXE。

SCSI 硬盘驱动器 (4)

保留 (5..65535)

BootSourceOrder

数据类型： 字符串 数组

访问类型：读/写

虚拟机的启动源顺序。

Windows 8.1：在Windows 8.1和Windows Server 2012 R2 之前，不支持此值。

Caption

数据类型： string

访问类型：只读

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

ChassisAssetTag

数据类型： string

访问类型：读/写

虚拟机机箱的资产标记。

ChassisSerialNumber

数据类型： string

访问类型：读/写

虚拟机机箱的序列号。

ConfigurationDataRoot

数据类型： string

访问类型：只读

存储有关虚拟机配置信息的目录的路径。 此属性继承自 CIM_VirtualSystemSettingData。

ConfigurationFile

数据类型： string

访问类型：只读

存储虚拟机配置相关信息的文件的相对路径和文件名。 此路径相对于 ConfigurationDataRoot 属性。 此属性继承自 CIM_VirtualSystemSettingData。

ConfigurationID

数据类型： 字符串

访问类型：只读

虚拟机配置的唯一标识符。 此属性继承自 CIM_VirtualSystemSettingData。

ConsoleMode

数据类型： uint16

访问类型：读/写

标识 VM 的控制台模式。

注意

此属性已添加到 Windows 10 和 Windows Server 2016 中。

默认 (0)

COM1 (1)

COM2 (2)

无 (3)

CreationTime

数据类型： datetime

访问类型：只读

创建虚拟机设置的日期和时间。 如果此对象表示虚拟机的当前设置，则此值将是创建系统的时间。 如果此对象表示虚拟机的快照设置，则此值将是获取快照的时间。 此属性继承自 CIM_VirtualSystemSettingData。

DebugChannelId

数据类型： uint32

访问类型：读/写

用于使用统一调试器调试虚拟机的通道标识符。

DebugPort

数据类型： uint32

访问类型：读/写

用于使用综合调试调试虚拟机的 TCP/IP 端口。

DebugPortEnabled

数据类型： uint16

访问类型：读/写

指定虚拟机是否正在使用综合调试。 这可以是以下值之一。

关闭 (0)

( 1)

OnAutoAssigned (2)

自动分配

描述

数据类型： 字符串

访问类型：只读

对象的说明。 此属性继承自 CIM_ManagedElement，并且始终设置为以下值之一。

值 含义
“虚拟机的活动设置”
 此实例是指虚拟机。
“虚拟机的快照设置”
 此实例引用快照。

ElementName

数据类型： 字符串

访问类型：只读

对象的显示名称。 此属性继承自 CIM_VirtualSystemSettingData，并且始终设置为计算机的显示名称。 此名称的长度不得超过 100 个字符。

EnhancedSessionTransportType

数据类型： uint16

访问类型：读/写

指示连接到增强会话时要使用的传输类型。

注意

此属性已添加到 Windows 10 版本 1803 中。

VMBus 管道 (0)

Hyper-V 套接字 (1)

GuestControlledCacheTypes

数据类型： 布尔值

访问类型：读/写

指示来宾是否可以控制缓存类型。

注意

在 Windows 10 和 Windows Server 2016 中添加。

GuestStateDataRoot

数据类型： 字符串

访问类型：只读

存储来宾运行时状态相关信息的目录的文件路径。

注意

在 Windows 10 版本 1709 中添加。

GuestStateFile

数据类型： 字符串

访问类型：只读

存储来宾运行时状态相关信息的文件路径。 相对路径追加到 GuestStateDataRoot 属性的值。

注意

在 Windows 10 版本 1709 中添加。

HighMmioGapSize

数据类型： uint64

访问类型：读/写

高于 4GB 的高 (的大小) Memory-Mapped IO 差距（MB）

注意

此属性已添加到 Windows 10 版本 1703 中。

IncrementalBackupEnabled

数据类型： 布尔值

访问类型：读/写

指示 Hyper-V VSS 编写器是否支持对此虚拟机进行增量备份。

InstanceID

数据类型： 字符串

访问类型：只读

限定符： 键

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

IsAutomaticSnapshot

数据类型： 布尔值

访问类型：只读

指示这是否是自动为用户创建的快照。

注意

在 Windows 10 版本 1709 中添加。

IsSaved

数据类型： 布尔值

访问类型：只读

如此 如果 配置具有对保存的状态文件的引用;否则为 False。 这并不表示存在此类文件，只是配置指定了一个文件。

LockOnDisconnect

数据类型： 布尔值

访问类型：读/写

从 vmconnect 断开连接时锁定控制台。

注意

在 Windows 10 和 Windows Server 2016 中添加。

LogDataRoot

数据类型： 字符串

访问类型：只读

存储虚拟机日志信息的目录的路径。 此属性继承自 CIM_VirtualSystemSettingData。

LowMmioGapSize

数据类型： uint64

访问类型：读/写

为虚拟机 (VM) 配置第一个 MMIO 间隙的大小（以 MB 为单位）。

Windows 8.1：在Windows 8.1和Windows Server 2012 R2 之前，不支持此值。

范围：128 3584

NetworkBootPreferredProtocol

数据类型： uint16

访问类型：读/写

确定 PXE 启动的首选协议是 IPv4 还是 IPv6。

Windows 8.1：在Windows 8.1和Windows Server 2012 R2 之前，不支持此值。

IPv4 (4096)

IPv6 (4097)

备注

数据类型： 字符串 数组

访问类型：只读

用户提供的与虚拟机相关的说明。 此属性继承自 CIM_VirtualSystemSettingData。

Parent

数据类型： 字符串

访问类型：只读

如果此实例不表示基于虚拟机快照的系统，则此属性为 Null。 否则， 属性将保留此实例所基于 的 Msvm_VirtualSystemSettingData 对象的对象路径。 为虚拟机生成快照树层次结构时，此属性引用从中派生当前实例的对象， (当前实例是子节点，而此属性中引用的对象是父节点。)

ParentPackage

数据类型： 字符串

访问类型：读/写

如果此系统是容器，则为此系统所基于Msvm_ContainerPackage的路径。

注意

在 Windows 10 中添加;在 Windows 10 版本 1703 中删除。

PauseAfterBootFailure

数据类型： 布尔值

访问类型：读/写

指示 BIOS 是否在每次启动项失败后暂停，等待用户按下某个键。 如果 BIOS 暂停，则为 True;否则为 False。

Windows 8.1：在Windows 8.1和Windows Server 2012 R2 之前，不支持此值。

RecoveryFile

数据类型： 字符串

访问类型：只读

存储虚拟机的恢复相关信息的文件的完整路径。 此属性继承自 CIM_VirtualSystemSettingData。

SecureBootEnabled

数据类型： 布尔值

访问类型：读/写

指示是否为虚拟机启用安全启动 (VM) 。 如果启用，则为 True;否则为 False。

注意

只能为第 2 代 VM 启用安全启动。

Windows 8.1：在Windows 8.1和Windows Server 2012 R2 之前，不支持此值。

SecureBootTemplateId

数据类型： 字符串

访问类型：读/写

UEFI Secure Boot 相关变量的模板内层值的全局唯一标识符。

这是一个只读属性，但可以使用 Msvm_VirtualSystemManagementService 类的 ModifyVirtualSystem 方法对其进行更改。

注意

在 Windows 10 和 Windows Server 2016 中添加。

SnapshotDataRoot

数据类型： 字符串

访问类型：只读

存储虚拟机快照相关信息的目录的路径。 此属性继承自 CIM_VirtualSystemSettingData。

SuspendDataRoot

数据类型： 字符串

访问类型：只读

存储虚拟机挂起相关信息的目录路径。 此属性继承自 CIM_VirtualSystemSettingData。

SwapFileDataRoot

数据类型： 字符串

访问类型：只读

存储虚拟机交换文件的目录路径。 此属性继承自 CIM_VirtualSystemSettingData。

UserSnapshotType

数据类型： uint16

访问类型：读/写

指示用户定义的快照类型。

注意

在 Windows 10 和 Windows Server 2016 中添加。

禁用 (2)

禁用创建任何快照。

ProductionFallbackToTest (3)

用于生产环境的数据一致性快照。当创建数据一致快照的功能不可用时，使用应用程序状态执行快照。

ProductionNoFallback (4)

用于生产环境的数据一致性快照。如果无法创建数据一致快照，则不会创建具有应用程序状态的快照。

测试 (5)

包含用于测试和开发的内存和设备信息的快照。

Version

数据类型： string

访问类型：只读

采用“major.minor”格式的虚拟机版本，例如“2.0”。

VirtualNumaEnabled

数据类型： 布尔值

访问类型：读/写

限定符： ModelCorrespondence (“Msvm_ProcessorSettingData。MaxProcessorsPerNumaNode“， ”Msvm_MemorySettingData.MaxMemoryBlocksPerNumaNode“)

如此 如果 虚拟非统一内存访问 (NUMA) 节点投影到虚拟机;如果虚拟机将具有单个节点，则为 False 。 如果 为 True，则投影到虚拟机中的虚拟 NUMA 节点数取决于 Msvm_ProcessorSettingData.MaxProcessorsPerNumaNode 和 Msvm_MemorySettingData.MaxMemoryBlocksPerNumaNode 属性的值。

VirtualSystemIdentifier

数据类型： string

访问类型：只读

限定符： 替代 (“CIM_VirtualSystemSettingData.VirtualSystemIdentifier”) ， ModelCorrespondence (“CIM_ComputerSystem。Name“)

此设置数据所属 CIM_ComputerSystem 对象的名称。 此属性是 CIM_VirtualSystemSettingData的替代。

VirtualSystemSubType

数据类型： string

访问类型：只读

此属性的有效值为 Microsoft：Hyper-V：SubType：1 和 Microsoft：Hyper-V：SubType：2。 第 1 代 VM 是子类型 1。 第 2 代 VM 是子类型 2。

Windows 8.1：在Windows 8.1和Windows Server 2012 R2 之前，不支持此值。

Microsoft：Hyper-V：SubType：1 (“Microsoft：Hyper-V：SubType：1”)

Microsoft：Hyper-V：SubType：2 (“Microsoft：Hyper-V：SubType：2”)

VirtualSystemType

数据类型： string

访问类型：只读

指定设置数据所表示的虚拟机的类型。 此属性继承自 CIM_VirtualSystemSettingData 类。 这是以下值之一。

值 含义
“Microsoft：Hyper-V：System：Realized”
 已实现的虚拟机。
“Microsoft：Hyper-V：System：Planned”
 计划的虚拟机。
“Microsoft：Hyper-V：Snapshot：Realized”
 已实现的虚拟机的快照。
“Microsoft：Hyper-V：Snapshot：Recovery”
 恢复虚拟机的快照。
“Microsoft：Hyper-V：Snapshot：Planned”
 计划虚拟机的快照。
“Microsoft：Hyper-V：Snapshot：Missing”
 缺少快照。
“Microsoft：Hyper-V：Snapshot：Replica：Standard”
 基于时间的复制点快照。
“Microsoft：Hyper-V：Snapshot：Replica：ApplicationConsistent”
 VSS 复制点快照。
“Microsoft：Hyper-V：Snapshot：Replica：PlannedFailover”
 计划的复制快照。

备注

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

要求

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

另请参阅

CIM_VirtualSystemSettingData

CIM_VirtualSystemSettingData

虚拟系统类