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

数据类型: string

访问类型:只读

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

OtherResourceType

数据类型: string

访问类型:只读

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

Parent

数据类型: string

访问类型:只读

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

PoolID

数据类型: string

访问类型:只读

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

预留

数据类型: uint64

访问类型:只读

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

ResourceSubType

数据类型: string

访问类型:只读

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

ResourceType

数据类型: uint16

访问类型:只读

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

StaticMacAddress

数据类型: 布尔值

访问类型:只读

指定 MAC 地址是否为静态。

VirtualQuantity

数据类型: uint64

访问类型:只读

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

VirtualQuantityUnits

数据类型: string

访问类型:只读

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

VirtualSystemIdentifiers

数据类型: 字符串 数组

访问类型:只读

限定符: ArrayType (“Indexed”)

呈现给虚拟机操作系统的此资源的标识符的字符串数组。 每个索引的索引和值基于每个资源定义, (即,针对每个枚举的 ResourceType 属性值) 。

Weight

数据类型: uint32

访问类型:只读

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

备注

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

示例

请参阅 查询网络对象

要求

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

另请参阅

CIM_EthernetPortAllocationSettingData

CIM_ResourceAllocationSettingData