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。
这可以是以下值之一。
| 值 | 含义 |
|---|---|
|
无。 |
|
重启。 |
|
还原为快照。 |
|
保留。 |
AutomaticShutdownAction
-
数据类型： uint16
-
访问类型：只读
关闭主机时要对虚拟机执行的操作。 此属性继承自 CIM_VirtualSystemSettingData。
这可以是以下值之一。
| 值 | 含义 |
|---|---|
|
关闭。 |
|
保存状态。 |
|
关闭。 |
|
保留。 |
AutomaticSnapshotsEnabled
-
数据类型： 布尔值
-
访问类型：读/写
指示此虚拟机是否应启用自动快照。
注意
在 Windows 10 版本 1709 中添加。
AutomaticStartupAction
-
数据类型： uint16
-
访问类型：只读
启动主机时要对虚拟机执行的操作。 此属性继承自 CIM_VirtualSystemSettingData。
这可以是以下值之一。
| 值 | 含义 |
|---|---|
|
无。 |
|
如果以前处于活动状态，请重启。 |
|
始终“启动”。 |
|
保留。 |
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
虚拟机 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 类。 这是以下值之一。
| 值 | 含义 |
|---|---|
|
已实现的虚拟机。 |
|
计划的虚拟机。 |
|
已实现的虚拟机的快照。 |
|
恢复虚拟机的快照。 |
|
计划虚拟机的快照。 |
|
缺少快照。 |
|
基于时间的复制点快照。 |
|
VSS 复制点快照。 |
|
计划的复制快照。 |
备注
UAC 筛选可能会限制对 Msvm_VirtualSystemSettingData 类的访问。 有关详细信息，请参阅 用户帐户控制和 WMI。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 8 [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2012 [仅限桌面应用] |
| 命名空间 |
Root\Virtualization\V2 |
| MOF |
|
| DLL |
|
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈