Msvm_VirtualHardDiskSettingData 类

项目
06/12/2023

提供虚拟硬盘的设置数据。

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

语法

[AMENDMENT]
class Msvm_VirtualHardDiskSettingData : CIM_SettingData
{
  string   InstanceID;
  string   Caption = "Virtual Hard Disk Setting Data";
  string   Description = "Setting Data for a Virtual Hard Disk";
  string   ElementName;
  uint16   Type;
  uint16   Format;
  string   Path;
  string   ParentPath;
  DATETIME ParentTimestamp;
  string   ParentIdentifier;
  uint64   MaxInternalSize;
  uint32   BlockSize;
  uint32   LogicalSectorSize;
  uint32   PhysicalSectorSize;
  string   VirtualDiskId;
  uint64   DataAlignment;
  uint16   PmemAddressAbstractionType;
  boolean  IsPmemCompatible;
};

成员

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

属性

属性

Msvm_VirtualHardDiskSettingData 类具有这些属性。

BlockSize

数据类型： uint32
访问类型：读/写

虚拟硬盘使用的块大小（以字节为单位）。

Caption

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

对象的简短说明。此属性继承自 CIM_ManagedElement，并且始终设置为“虚拟硬盘设置数据”。

DataAlignment

数据类型： uint64
访问类型：读/写

指定虚拟磁盘的数据有效负载所需的对齐方式（以字节为单位）

注意

在 Windows 10 版本 1709 中添加。

描述

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

对象的说明。此属性继承自 CIM_ManagedElement，并且始终设置为“设置虚拟硬盘的数据”。

ElementName

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

对象的显示名称。此属性继承自 CIM_ManagedElement。

格式

数据类型： uint16
访问类型：读/写

虚拟硬盘的格式。这是以下值之一。

VHD (2)

VHDX (3)

VHDSet (4)

注意

在 Windows 10 和 Windows Server 2016 中添加。

InstanceID

数据类型： string
访问类型：只读
限定符：键

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

IsPmemCompatible

数据类型： 布尔值
访问类型：读/写

指定虚拟磁盘是否可用作永久性内存设备的后备存储。

注意

在 Windows 10 版本 1709 中添加。

LogicalSectorSize

数据类型： uint32
访问类型：读/写

虚拟硬盘使用的逻辑扇区大小（以字节为单位）。

MaxInternalSize

数据类型： uint64
访问类型：读/写

虚拟机可查看的虚拟硬盘的最大大小（以字节为单位）。此大小将向上舍入到扇区大小的下一个最大倍数。

ParentIdentifier

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

用于唯一标识虚拟硬盘的父级的 GUID。如果虚拟硬盘没有父级，则此字段为空。

注意

在 Windows 10 和 Windows Server 2016 中添加。

ParentPath

数据类型： string
访问类型：读/写

虚拟硬盘的父级。如果虚拟硬盘没有父磁盘，则此属性为空。

ParentTimestamp

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

虚拟硬盘的父级的时间戳。如果虚拟硬盘没有父级，则此字段为空。

注意

在 Windows 10 和 Windows Server 2016 中添加。

路径

数据类型： string
访问类型：读/写

虚拟硬盘的完全限定路径。

PhysicalSectorSize

数据类型： uint32
访问类型：读/写

虚拟硬盘使用的物理扇区大小（以字节为单位）。

PmemAddressAbstractionType

数据类型： uint16
访问类型：读/写

要用于此虚拟磁盘的永久性内存地址抽象方法。

注意

在 Windows 10 版本 1709 中添加。

无 (0)

BTT (1)

未知 (65535)

类型

数据类型： uint16
访问类型：读/写

虚拟硬盘的类型。这是以下值之一。

修复了 (2)

动态 (3)

差异 (4)

VirtualDiskId

数据类型： string
访问类型：读/写

用于唯一标识虚拟磁盘的 GUID。

当 Msvm_ImageManagementService.GetVirtualHardDiskSettingData 方法返回 Msvm_VirtualHardDiskSettingData 实例时，客户端可以使用此属性获取 VHD 的唯一磁盘 ID。

在冲突检测或其他情况下，客户端可以将 VirtualDiskId 值设置为新的 GUID，并将此 Msvm_VirtualHardDiskSettingData 实例传递给 Msvm_ImageManagementService.SetVirtualHardDiskSettingData 方法以更改 VHD 的磁盘 ID。如果 VHD 不是 VHDX VHD，或者 VHD 已附加，则操作将失败。如果传递的值格式不正确（即不是 GUID 或全部为 0），则操作也会失败。如果传递的值与当前磁盘 ID 相同，则操作以无提示方式成功。

SetVirtualDiskInformation 函数生成的错误通过此属性浮升。客户端还可以使用同一机制在创建 VHD 时通过同一命名空间中的 Msvm_ImageManagementService.CreateVirtualHardDisk 方法提供 VirtualDiskId 值。这可用于创建 VHD1 或 VHD2 VHD。

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

要求

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

另请参阅

CIM_SettingData
GetVirtualHardDiskSettingData

Msvm_VirtualHardDiskSettingData 类

语法

成员

属性

要求

另请参阅

反馈

反馈

其他资源