Msvm_EmulatedEthernetPortSettingData 类

2025-06-14

表示模拟以太网适配器的配置状态。

以下语法是简化的托管对象格式（MOF）代码，它包括所有继承的属性。

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_EmulatedEthernetPortSettingData : CIM_EthernetPortAllocationSettingData
{
  string  Caption = "Ethernet Port";
  string  Description = "Settings for the Microsoft Emulated Ethernet Port";
  string  InstanceID = "Microsoft:VMID\VDID\device-specific-data";
  string  ElementName = "Ethernet Port";
  uint16  ResourceType = 10;
  string  OtherResourceType;
  string  ResourceSubType = "Microsoft Emulated Ethernet Port";
  string  PoolID;
  uint16  ConsumerVisibility = 3;
  string  HostResource[];
  string  AllocationUnits = "Ports";
  uint64  VirtualQuantity = 1;
  uint64  Reservation = 1;
  uint64  Limit = 1;
  uint32  Weight = 0;
  boolean AutomaticAllocation = True;
  boolean AutomaticDeallocation = True;
  string  Parent;
  string  Connection[];
  string  Address;
  uint16  MappingBehavior;
  string  AddressOnParent;
  string  VirtualQuantityUnits = "count";
  uint16  DesiredVLANEndpointMode;
  string  OtherEndpointMode;
  boolean StaticMacAddress = TRUE;
  boolean ClusterMonitored = TRUE;
};

成员

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

性能

性能

Msvm_EmulatedEthernetPortSettingData类具有以下属性。

地址

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

资源的地址。例如，以太网端口的 MAC 地址。此属性继承自 CIM_ResourceAllocationSettingData。

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

AddressOnParent

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

描述父上下文中此资源的地址。 Parent 和 AddressOnParent 属性用于描述控制器关系以及控制器上的设备的排序。此属性继承自 CIM_ResourceAllocationSettingData。

AllocationUnits

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

预留和限制属性使用的分配单位。此属性继承自 CIM_ResourceAllocationSettingData，并且始终设置为“端口”。

AutomaticAllocation

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

指示是否自动分配资源。此属性继承自 CIM_ResourceAllocationSettingData，并且始终设置为 True。

AutomaticDeallocation

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

指示资源是否会自动解除分配。此属性继承自 CIM_ResourceAllocationSettingData，并且始终设置为 True。

标题

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

对象的简短说明。此属性继承自 CIM_ManagedElement，并且始终设置为“以太网端口”。

ClusterMonitored

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

指示此以太网适配器是否由群集监视。如果未配置，此属性默认为 true。

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

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

连接

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

此资源连接到的项。例如，命名网络或交换机端口。此属性继承自 CIM_ResourceAllocationSettingData。

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

ConsumerVisibility

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

描述使用者对已分配资源的可见性。此属性继承自 CIM_ResourceAllocationSettingData，并且始终设置为 3（虚拟化）。

说明

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

对象的说明。此属性继承自 CIM_ManagedElement，并且始终设置为“Microsoft模拟以太网端口的设置”。

DesiredVLANEndpointMode

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

VLAN 终结点的所需配置模式。此属性用于在与目标以太网端口关联的Msvm_VLANEndpoint类实例中设置初始 OperationalEndpointMode 属性值。有关可能的值，请参阅 Msvm_VLANEndpoint 类的 OperationalEndpointMode 属性。此属性继承自 CIM_EthernetPortAllocationSettingData。

ElementName

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

此 RASD 实例关联的设备的用户可配置显示名称。此属性继承自 CIM_SettingData，并设置为“以太网端口”。更改此属性将更改关联的逻辑设备派生的元素名称。

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

HostResource

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

此属性继承自 CIM_ResourceAllocationSettingData，并且始终设置为 Null。

InstanceID

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

在实例化命名空间的范围内， InstanceID 不透明且唯一地标识此类的实例。此属性继承自 CIM_SettingData，并且始终设置为“Microsoft：VMID VDID\\设备特定数据”。

限制

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

将为此分配授予的上限或最大资源量。此属性继承自 CIM_ResourceAllocationSettingData，并且始终设置为 1。

MappingBehavior

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

指定此资源如何映射到基础资源。此属性继承自 CIM_ResourceAllocationSettingData，并且始终设置为 Null。

OtherEndpointMode

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

描述此 VLAN 终结点支持的 VLAN 终结点模型类型的字符串。仅当 DesiredVLANEndpointMode 属性设置为 1（其他）时，才使用此属性。当 DesiredVLANEndpointMode 属性是除 1 以外的任何值时，此属性应设置为 Null。此属性继承自 CIM_EthernetPortAllocationSettingData。

OtherResourceType

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

描述定义良好的值不可用且 ResourceType 设置为 0（“其他”）时的资源类型的字符串。此属性继承自 CIM_ResourceAllocationSettingData，并且不使用此属性。

父母

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

资源的父级。例如，当前分配的控制器。此属性继承自 CIM_ResourceAllocationSettingData。

PoolID

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

资源当前从中分配的池，或者资源将在分配发生时从中分配的池。此属性继承自 CIM_ResourceAllocationSettingData。

预留

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

保证可用于此分配的资源量。在支持过度承诺资源的系统上，此值通常用于允许控制，以防止接受分配。此属性继承自 CIM_ResourceAllocationSettingData，并且始终设置为 1。

ResourceSubType

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

描述此资源的实现特定子类型的字符串。例如，这可用于区分相同资源类型的不同模型。此属性继承自 CIM_ResourceAllocationSettingData，并且始终设置为“Microsoft模拟以太网端口”。

资源类型

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

此设置适用的资源类型。此属性继承自 CIM_ResourceAllocationSettingData，并且始终设置为 10（以太网适配器）。

StaticMacAddress

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

指示是否使用静态 MAC 地址。

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

VirtualQuantity

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

提供给使用者的资源数量。此属性继承自 CIM_ResourceAllocationSettingData，并且始终设置为 1。

VirtualQuantityUnits

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

指定此资源分配的度量单位。此属性的值必须是 DSP0004 V2.5 或更高版本的附件 C.1 中定义的编程单元限定符的法律值。此属性继承自 CIM_ResourceAllocationSettingData。

重量

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

此分配相对于同一 ResourcePool 中的其他分配的相对优先级。此属性继承自 CIM_ResourceAllocationSettingData，并且始终设置为 0。

注解

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

例子

请参阅查询网络对象。

要求

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

另请参阅

CIM_EthernetPortAllocationSettingData
CIM_ResourceAllocationSettingData

反馈

此页面是否有帮助？

通过

Msvm_EmulatedEthernetPortSettingData 类

语法

成员

性能

注解

例子

要求

另请参阅

反馈

其他资源