Msvm_SyntheticEthernetPortSettingData 类

表示合成以太网适配器的配置状态。

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

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SyntheticEthernetPortSettingData : CIM_EthernetPortAllocationSettingData
{
  string  InstanceID;
  string  Caption = "Virtual Ethernet Port Default Settings";
  string  Description = "Describes the default settings for the virtual Ethernet port resources.";
  string  ElementName;
  uint16  ResourceType = 10;
  string  OtherResourceType;
  string  ResourceSubType = "Microsoft:Hyper-V:Synthetic Ethernet Port";
  string  PoolID;
  uint16  ConsumerVisibility = 3;
  string  HostResource[];
  string  AllocationUnits = "count";
  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;
  string  VirtualSystemIdentifiers[];
  boolean DeviceNamingEnabled = FALSE;
  boolean AllowPacketDirect = FALSE;
  boolean StaticMacAddress = False;
  boolean ClusterMonitored = TRUE;
};

成员

Msvm_SyntheticEthernetPortSettingData类包含以下类型的成员:

属性

Msvm_SyntheticEthernetPortSettingData类具有这些属性。

Address

数据类型: 字符串

访问类型:只读

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

AddressOnParent

数据类型: 字符串

访问类型:只读

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

AllocationUnits

数据类型: 字符串

访问类型:只读

预留限制属性使用的分配单位。 此属性继承自 CIM_ResourceAllocationSettingData

AllowPacketDirect

数据类型: 布尔值

访问类型:读/写

指示是否为 VM 启用了 PacketDirect 投影。

注意

在 Windows 10 版本 1703 和 Windows Server 2016 中添加。

AutomaticAllocation

数据类型: 布尔值

访问类型:只读

指示是否自动分配资源。 此属性继承自 CIM_ResourceAllocationSettingData

AutomaticDeallocation

数据类型: 布尔值

访问类型:只读

指示是否自动解除分配资源。 此属性继承自 CIM_ResourceAllocationSettingData

Caption

数据类型: 字符串

访问类型:只读

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

ClusterMonitored

数据类型: 布尔值

访问类型:只读

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

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

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

Connection

数据类型: 字符串 数组

访问类型:只读

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

ConsumerVisibility

数据类型: uint16

访问类型:只读

使用者可查看已分配的资源。 此属性继承自 CIM_ResourceAllocationSettingData,并且始终设置为 3 (虚拟化) 。

说明

数据类型: 字符串

访问类型:只读

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

DesiredVLANEndpointMode

数据类型: uint16

访问类型:只读

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

DeviceNamingEnabled

数据类型: 布尔值

访问类型:只读

指示此以太网适配器是否支持设备命名。

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

注意

在Windows 10和Windows Server 2016中添加。

ElementName

数据类型: 字符串

访问类型:只读

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

HostResource

数据类型: 字符串 数组

访问类型:只读

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

InstanceID

数据类型: 字符串

访问类型:只读

限定符: 密钥

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

限制

数据类型: uint64

访问类型:只读

将为此分配授予的上限或最大资源量。 此属性继承自 CIM_ResourceAllocationSettingData

MappingBehavior

数据类型: uint16

访问类型:只读

指定此资源如何映射到基础资源。 此属性继承自 CIM_ResourceAllocationSettingData

OtherEndpointMode

数据类型: 字符串

访问类型:只读

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

OtherResourceType

数据类型: 字符串

访问类型:只读

当定义良好的值不可用并且 ResourceType 设置为“Other” (0) 时描述资源类型的字符串。 此属性继承自 CIM_ResourceAllocationSettingData,并且不使用此属性。

父级

数据类型: 字符串

访问类型:只读

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

PoolID

数据类型: 字符串

访问类型:只读

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

预留

数据类型: uint64

访问类型:只读

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

ResourceSubType

数据类型: 字符串

访问类型:只读

描述此资源的实现特定子类型的字符串。 例如,这可用于区分相同资源类型的不同模型。 此属性继承自 CIM_ResourceAllocationSettingData

ResourceType

数据类型: uint16

访问类型:只读

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

StaticMacAddress

数据类型: 布尔值

访问类型:只读

指定 MAC 地址是否为静态地址。

VirtualQuantity

数据类型: uint64

访问类型:只读

提供给使用者的资源数量。 此属性继承自 CIM_ResourceAllocationSettingData

VirtualQuantityUnits

数据类型: 字符串

访问类型:只读

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

VirtualSystemIdentifiers

数据类型: 字符串 数组

访问类型:只读

限定符: ArrayType (“Indexed”)

提供给虚拟机操作系统的此资源的标识符的字符串数组。 每个索引的索引和值根据每个资源定义 (,即每个枚举 的 ResourceType 属性值) 。

Weight

数据类型: uint32

访问类型:只读

此分配相对于同一资源池中的其他分配的相对优先级。 此属性继承自 CIM_ResourceAllocationSettingData

注解

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

示例

请参阅 查询网络对象

要求

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

另请参阅

CIM_EthernetPortAllocationSettingData

CIM_ResourceAllocationSettingData