Msvm_GuestServiceInterfaceComponentSettingData 类
表示来宾服务接口组件的已配置状态。 此类派生自 CIM_ResourceAllocationSettingData 类。
下面的语法从 MOF 代码简化而来，包含所有继承属性。
语法
[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_GuestServiceInterfaceComponentSettingData : CIM_ResourceAllocationSettingData
{
string ElementName;
string InstanceID;
uint16 ResourceType;
string OtherResourceType;
string ResourceSubType;
string PoolID;
uint16 ConsumerVisibility;
string HostResource[];
string AllocationUnits;
uint64 VirtualQuantity;
uint64 Reservation;
uint64 Limit;
uint32 Weight;
boolean AutomaticAllocation;
boolean AutomaticDeallocation;
string Parent;
string Connection[];
string Address;
uint16 MappingBehavior;
uint16 EnabledState = 3;
uint16 DefaultEnabledStatePolicy = 2;
};
成员
Msvm_GuestServiceInterfaceComponentSettingData 类具有以下类型的成员：
属性
Msvm_GuestServiceInterfaceComponentSettingData 类具有以下属性。
-
Address
-
-
数据类型： 字符串
-
访问类型：只读
资源的地址。 例如，以太网端口的 MAC 地址。
-
-
AllocationUnits
-
-
数据类型： 字符串
-
访问类型：只读
此属性指定“预留”和“限制”属性使用的分配单位。 例如，当 ResourceType=Processor 时，AllocationUnits 可设置为 MHz。 当 ResourceType=Memory 时，AllocationUnits 可设置为 MB
-
-
AutomaticAllocation
-
-
数据类型：boolean
-
访问类型：只读
此属性指定是否会自动分配资源。 例如，如果设置为 true，则当使用的虚拟计算机系统处于开启状态时，将分配此资源。 如果设置为 false，则表示必须显式分配资源。 例如，该设置可表示可移动媒体（即 cdrom 或软盘），在按时开启时，媒体不存在。 分配资源需要显式操作。
-
-
AutomaticDeallocation
-
-
数据类型： 布尔值
-
访问类型：只读
此属性指定是否会自动解除分配资源。 例如，如果设置为 true，则当使用的虚拟计算机系统处于关闭状态时，将解除分配此资源。 设置为 false 时，资源将保持分配状态，必须显式解除分配。
-
-
Connection
-
-
数据类型：字符串数组
-
访问类型：只读
此资源连接到的项。 例如，命名网络或交换机端口。
-
-
ConsumerVisibility
-
-
数据类型：uint16
-
访问类型：只读
描述使用者对已分配资源的可见性。
值 含义 - Unknown
- 0
未知。 - 直通
- 2
将利用基础资源或主机资源并直通到使用者，可能使用分区。 DeviceID 属性中应至少有一项存在。 - 虚拟化
- 3
资源已虚拟化，不能直接映射到基础/主机资源。 某些实现可支持对虚拟化资源进行特定分配，在这种情况下，使用 DeviceID 属性暴露主机资源。 - 未表示
- 4
资源使用者的上下文中不存在资源的表示形式。 - DMTF 保留
- ..
- 供应商保留
- 32767..65535
-
-
DefaultEnabledStatePolicy
-
-
数据类型：uint16
-
访问类型：只读
默认情况下，来宾通信服务的启用和禁用状态。
这是一个只读属性，但可以使用 Msvm_VirtualSystemManagementService 类的 ModifyResourceSettings 方法对其进行更改。
注意
在 Windows 10 中添加。
-
-
启用 (2)
-
禁用 (3)
ElementName
-
数据类型： 字符串
-
访问类型：只读
此 SettingData 实例的显示名称。 此外，显示名称可用作搜索或查询的索引属性。 （注意：名称在命名空间中不必是唯一的。）
EnabledState
-
数据类型：uint16
-
访问类型：只读
元素的启用和禁用状态。
这是一个只读属性，但它可以通过使用 Msvm_VirtualSystemManagementService 类的 ModifyVirtualSystemResources 方法（或 Windows 10 或更高版本中的 ModifyResourceSettings）进行更改。
有效值为：
启用 (2)
禁用 (3)
HostResource
-
数据类型：字符串数组
-
访问类型：只读
此属性暴露对主机或基础资源的特定分配。 嵌入实例应仅包含键属性，并被视为对象路径。 如果可针对多个基础资源安排虚拟资源，则此属性应保持为 NULL。 在这种情况下，可使用 DeviceAllocatedFromPool 或 ResourceAllocationFromPool 关联来确定可在其上安排此虚拟资源的主机资源的池。 如果使用了特定分配，则此虚拟资源使用的所有基础资源应在此数组中列出。 通常，数组将包含一个项，但对于聚合分配（如多个处理器），可以指定多个主机资源。
InstanceID
-
数据类型：字符串
-
访问类型：只读
-
限定符：Key
在实例化命名空间的范围内，InstanceID 不透明且唯一地标识此类的实例。 为了确保命名空间中的唯一性，应使用以下“首选”算法构造 InstanceID 的值：OrgID:LocalID，其中的 OrgID 和 LocalID 由冒号 (:) 分隔，OrgID 必须包含有版权、已注册商标的名称或由正在创建或定义 InstanceID 的业务实体拥有的其他唯一名称，或由公认的全球权威机构分配给业务实体的已注册 ID。 （此要求类似于架构类名的 SchemaName_ClassName 结构。）此外，为了确保唯一性，OrgID 不得包含冒号 (:)。 使用此算法时，InstanceID 中显示的第一个冒号必须出现在 OrgID 和 LocalID 之间。 LocalID 由业务实体选择，不应重复使用以标识不同的基础（实际）元素。 如果未使用上述“首选”算法，则定义实体必须确保不会在由此实例命名空间的此提供程序或其他提供程序生成的任何 InstanceID 中重复使用生成的 InstanceID。 对于 DMTF 定义的实例，必须在 OrgID 设置为 CIM 的情况下使用此“首选”算法。
限制
-
数据类型：uint64
-
访问类型：只读
此属性指定将为此分配授予的上限或最大资源量。 例如，支持内存分页的系统可支持设置 VirtualQuantity 以下内存分配的限制，从而强制为此分配进行分页。
MappingBehavior
-
数据类型：uint16
-
访问类型：只读
指定此资源如何映射到基础资源。 如果 HostResource 数组包含任何条目，则此属性反映资源如何映射到这些特定资源。
-
未知 (0)
-
不支持 (1)
-
专用 (2)
-
软相关性 (3)
-
硬相关性 (4)
-
DMTF 保留 (..)
-
供应商保留 (32767..65535)
OtherResourceType
-
数据类型： 字符串
-
访问类型：只读
一个字符串，用于描述定义良好的值不可用且 ResourceType 具有值“其他”时的资源类型。
Parent
-
数据类型： 字符串
-
访问类型：只读
资源的父级。 例如，当前分配的控制器。
PoolID
-
数据类型：字符串
-
访问类型：只读
此属性指定当前从哪个资源池分配资源，或在发生分配时将从哪个资源池分配资源。
预留
-
数据类型：uint64
-
访问类型：只读
此属性指定保证可用于此分配的资源量。 在支持过度承诺使用资源的系统上，此值通常用于准入控制，以防止分配被接受，从而防止资源耗尽。
ResourceSubType
-
数据类型：字符串
-
访问类型：只读
一个字符串，用于描述此资源的实现特定子类型。 例如，这可用于区分相同资源类型的不同模型。
ResourceType
-
数据类型：uint16
-
访问类型：只读
此分配设置表示的资源类型。
-
其他 (1)
-
计算机系统 (2)
-
处理器 (3)
-
内存 (4)
-
IDE 控制器 (5)
-
并行 SCSI HBA (6)
-
FC HBA (7)
-
iSCSI HBA (8)
-
IB HCA (9)
-
以太网适配器 (10)
-
其他网络适配器 (11)
-
I/O 槽 (12)
-
I/O 设备 (13)
-
软盘驱动器 (14)
-
CD 驱动器 (15)
-
DVD 驱动器 (16)
-
串行端口 (17)
-
并行端口 (18)
-
USB 控制器 (19)
-
图形控制器 (20)
-
存储区 (21)
-
磁盘 (22)
-
磁带 (23)
-
其他存储设备 (24)
-
Firewire 控制器 (25)
-
可分区单元 (26)
-
基本可分区单元 (27)
-
电源 (28)
-
冷却设备 (29)
-
DMTF 保留 (..)
-
供应商保留 (32767..65535)
VirtualQuantity
-
数据类型：uint64
-
访问类型：只读
此属性指定提供给使用者的资源数量。 例如，当 ResourceType=Processor 时，此属性将反映提供给虚拟计算机系统的离散处理器数。 当 ResourceType=Memory 时，此属性可反映报告给虚拟计算机系统的 MB 数。
Weight
-
数据类型：uint32
-
访问类型：只读
此属性指定此分配相对于同一资源池中其他分配的相对优先级。 此属性没有度量单位，仅当与同一主机资源媲美的其他分配比较时才相关。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 8.1 [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2012 R2 [仅限桌面应用] |
| 命名空间 |
Root\Virtualization\V2 |
| MOF |
|
| DLL |
|
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈