Msvm_SyntheticEthernetPortSettingData 类

2023-06-13

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

以下语法是简化的托管对象格式 (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

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

描述父级上下文中此资源的地址。 Parent 和 AddressOnParent 属性用于描述控制器关系以及控制器上设备的排序。此属性继承自 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

反馈

此页面是否有帮助？

通过

Msvm_SyntheticEthernetPortSettingData 类

语法

成员

属性

备注

示例

要求

另请参阅

反馈

其他资源