Msvm_ExternalEthernetPort 类

项目
06/13/2023

表示网络适配器) (外部以太网端口。这些类型的以太网端口允许虚拟机访问外部网络。

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

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_ExternalEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Port";
  string   Description = "Microsoft External Ethernet Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[] = "OK";
  string   Status = "OK";
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_ExternalEthernetPort";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  string   AdditionalAvailability[];
  uint64   MaxQuiesceTime;
  uint64   Speed;
  uint64   MaxSpeed;
  uint64   RequestedSpeed;
  uint16   UsageRestriction;
  uint16   PortType;
  string   OtherPortType;
  string   OtherNetworkPortType;
  uint16   PortNumber;
  uint16   LinkTechnology;
  string   OtherLinkTechnology;
  string   PermanentAddress;
  string   NetworkAddresses[];
  boolean  FullDuplex;
  boolean  AutoSense;
  uint64   SupportedMaximumTransmissionUnit;
  uint64   ActiveMaximumTransmissionUnit;
  uint32   MaxDataSize;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  uint16   EnabledCapabilities[];
  string   OtherEnabledCapabilities[];
  boolean  IsBound;
};

成员

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

方法
属性

方法

Msvm_ExternalEthernetPort 类具有以下方法。

方法	说明
EnableDevice	不支持此方法。
OnlineDevice	不支持此方法。
QuiesceDevice	不支持此方法。
RequestStateChange	请求状态更改。
重置	重置虚拟设备。
RestoreProperties	不支持此方法。
SaveProperties	不支持此方法。
SetPowerState	不支持此方法。

属性

Msvm_ExternalEthernetPort 类具有这些属性。

ActiveMaximumTransmissionUnit

数据类型： uint64
访问类型：只读
限定符：单位 (“字节”)

活动或协商的最大传输单元 (可支持的 MTU) （以字节为单位）。此属性继承自 CIM_NetworkPort。

AdditionalAvailability

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

超出 可用性属性中指定的 设备的任何其他可用性和状态。此属性继承自 CIM_LogicalDevice，但不使用它。

AutoSense

数据类型： 布尔值
访问类型：只读

指示网络端口是否能够自动确定附加网络媒体的速度或其他通信特征。此属性继承自 CIM_NetworkPort。

可用性

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

设备的主要可用性和状态。此属性继承自 CIM_LogicalDevice，但不使用它。

AvailableRequestedStates

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

指示用于启动状态更改的 RequestStateChange 方法的 RequestedState 参数的可能值。列出的值将是CIM_EnabledLogicalElementCapabilities关联实例的 RequestedStatesSupported 属性中包含的值的子集，其中所选值是CIM_EnabledLogicalElement当前状态的函数。如果实现能够将一组可能的值播发为当前状态的函数，则此属性可以是非 Null 。如果实现无法确定作为当前状态函数的可能值集，则此属性将为 Null 。

此属性继承自 CIM_EnabledLogicalElement。

已启用 (2)
已禁用 (3)
关闭 (4)
脱机 (6)
测试 (7)
延迟 (8)
静止 (9)
重新启动 (10)
重置 (11)
DMTF 保留 (。)

功能

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

一个数组，指定端口的功能。此属性继承自 CIM_EthernetPort。

未知 (0)
其他 (1)
AlertOnLan (2)
WakeOnLan (3)
故障转移 (4)
LoadBalancing (5)

CapabilityDescriptions

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

一个自由格式字符串数组，为 Capabilities 数组中包含的端口功能提供更详细的说明。此数组的每个条目都与位于同一索引的 Capabilities 数组中的相应条目相关。此属性继承自 CIM_EthernetPort。

Caption

数据类型： string
访问类型：只读
限定符： MaxLen (64)

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

CommunicationStatus

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

指示检测与基础托管元素通信的能力。 Null 值指示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

CreationClassName

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

范围系统的创建类名称。此属性继承自 CIM_LogicalDevice，并且始终设置为“Msvm_ExternalEthernetPort”。

描述

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

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

DetailedStatus

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

使用其他状态详细信息补充 PrimaryStatus 属性。 Null 值表示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

DeviceID

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

用于唯一命名逻辑设备的地址或其他标识信息。此属性继承自 CIM_LogicalDevice。

ElementName

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

对象的显示名称。此属性继承自 CIM_ManagedElement。

EnabledCapabilities

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

指定从 Capabilities 数组中所有受支持功能的列表中启用的功能。此属性继承自 CIM_EthernetPort。

未知 (0)
其他 (1)
AlertOnLan (2)
WakeOnLan (3)
故障转移 (4)
负载均衡 (5)

EnabledDefault

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

元素的 EnabledState 属性的管理员默认或启动配置。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 2 (Enabled) 。

EnabledState

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

元素的启用和禁用状态。它还可以指示这些请求状态之间的转换。例如，关闭 (4) 和从 (10) 开始是启用和禁用之间的暂时性状态。此属性继承自 CIM_EnabledLogicalElement。

值	含义
Unknown 0
其他 1
已启用 2	元素正在执行或可能正在执行命令，将处理任何排队的命令，并将新请求排队。
已禁用 3	元素不会执行命令，并且会删除任何新请求。
关闭 4	元素正在进入“已禁用”状态。
不适用 5	元素不支持启用或禁用。
已启用但脱机 6	元素可能正在完成命令，并且它将删除任何新请求。
测试中 7	元素处于测试状态。
递延 8	元素可能正在完成命令，但它会将任何新请求排队。
Quiesce 9	元素已启用，但处于受限模式。元素的行为类似于 Enabled 状态，但它只处理一组受限的命令。所有其他请求已排队。
正在启动 10	元素正在进入“已启用”状态。新请求已排队。
DMTF 保留 11 32767	保留。
保留的供应商 32768 65535	保留。

ErrorCleared

数据类型： 布尔值
访问类型：只读

指示现在是否清除 LastErrorCode 中报告的错误。此属性继承自 CIM_LogicalDevice，但不使用它。

ErrorDescription

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

一个字符串，提供有关 LastErrorCode 中记录的错误的详细信息，以及有关可以采取的任何纠正措施的信息。此属性继承自 CIM_LogicalDevice，但不使用它。

FullDuplex

数据类型： 布尔值
访问类型：只读

指示端口是否在全双工模式下运行。此属性继承自 CIM_NetworkPort。

HealthState

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

元素的当前运行状况。此属性表示此元素的运行状况，但不一定表示其子组件的运行状况。可能的值为 0 到 30，其中 5 表示元素完全正常运行，30 表示元素完全无功能。此属性继承自 CIM_ManagedSystemElement，并且始终将它设置为 5 (正常) 。

IdentifyingDescriptions

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

一个自由格式字符串数组，在 OtherIdentifyingInfo 属性数组中的条目后面提供解释和详细信息。此属性继承自 CIM_LogicalDevice，但不使用它。

InstallDate

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

对象的安装日期和时间。此属性不需要值来指示已安装对象。此属性继承自 CIM_ManagedSystemElement。

InstanceID

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

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

IsBound

数据类型： 布尔值
访问类型：只读

如果此属性为 True，则此以太网端口可以连接到交换机，从而提供与虚拟机的连接。如果此属性为 False，则虚拟机网络体系结构未使用此以太网端口。

LastErrorCode

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

逻辑设备报告的最后一个错误代码。此属性继承自 CIM_LogicalDevice，但不使用它。

LinkTechnology

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

指定端口的链接技术类型。当设置为 1 (Other) 时， OtherLinkTechnology 属性包含链接类型的字符串说明。此属性继承自 CIM_NetworkPort。

未知 (0)
其他 (1)
以太网 (2)
IB (3)
FC (4)
FDDI (5)
ATM (6)
令牌环 (7)
帧中继 (8)
红外 (9)
BlueTooth (10)
无线 LAN (11)

MaxDataSize

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

INFO (将接收或传输的非 MAC) 字段的最大大小。此属性继承自 CIM_EthernetPort，并且始终设置为 1500。

MaxQuiesceTime

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

此属性已弃用。此属性继承自 CIM_LogicalDevice，但不使用它。

MaxSpeed

数据类型： uint64
访问类型：只读
限定符：单位 (“每秒位数”)

端口的最大带宽（以位/秒为单位）。此属性继承自 CIM_LogicalPort。

名称

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

对象的已知标签。此属性继承自 CIM_ManagedSystemElement。

NetworkAddresses

数据类型： 字符串 数组
访问类型：只读
限定符： MaxLen ( 64 )

包含端口的 MAC 地址的字符串数组。此属性继承自 CIM_NetworkPort。

OperatingStatus

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

提供元素操作条件的当前状态信息，并可用于提供有关 EnabledState 属性值的更多详细信息。 Null 值表示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

OperationalStatus

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

对象的当前状态。此属性继承自 CIM_ManagedSystemElement，每个数组元素始终设置为 2 (正常) 。

OtherEnabledCapabilities

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

自由格式字符串数组，为指定为 1 (Other.) 此属性继承自 CIM_EthernetPort 的任何已启用功能提供更详细的说明。

OtherEnabledState

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

一个字符串，描述 EnabledState 属性设置为 1 时元素的启用或禁用状态， (Other) 。当 EnabledState 为除 1 以外的任何值时，此属性必须设置为 Null。此属性继承自 CIM_EnabledLogicalElement。

OtherIdentifyingInfo

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

除设备 ID 信息外，可用于标识逻辑设备的任何其他数据。此属性继承自 CIM_LogicalDevice，但不使用它。

OtherLinkTechnology

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

一个字符串值，用于描述 LinkTechnology 设置为 1 (Other) 。此属性继承自 CIM_NetworkPort。

OtherNetworkPortType

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

已弃用此属性，而不是 PortType 属性。此属性继承自 CIM_NetworkPort。

OtherPortType

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

当 PortType 设置为 1 (“Other”) 时模块的类型。此属性继承自 CIM_LogicalPort。

PermanentAddress

数据类型： string
访问类型：只读
限定符： MaxLen (64)

硬编码为端口的网络地址。可以使用固件升级或软件配置更改此硬编码地址。进行此更改时，应同时更新字段。如果网络适配器不存在任何硬编码地址，则此属性应为 Null 。此属性继承自 CIM_NetworkPort。

PortNumber

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

端口号。此属性继承自 CIM_NetworkPort。

PortType

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

当前为端口启用的特定模式。当设置为 1 (“Other”) 时，相关属性 OtherPortType 包含端口类型的字符串说明。此属性继承自 CIM_LogicalPort。

未知 (0)
其他 (1)
//50 铜 10BaseT (50)
10-100BaseT (51)
100BaseT (52)
1000BaseT (53)
2500BaseT (54)
10GBaseT (55)
10GBase-CX4 (56)
//100 光纤 100Base-FX (100)
100Base-SX (101)
1000Base-SX (102)
1000Base-LX (103)
1000Base-CX (104)
10GBase-SR (105)
10GBase-SW (106)
10GBase-LX4 (107)
10GBase-LR (108)
10GBase-LW (109)
10GBase-ER (110)
10GBase-EW (111)
供应商预留 (16000 65535)

PowerManagementCapabilities

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

设备的电源管理功能。此属性继承自 CIM_LogicalDevice，但不使用它。

PowerManagementSupported

数据类型： 布尔值
访问类型：只读

指示设备是否可以进行电源管理。此属性继承自 CIM_LogicalDevice，但不使用它。

PowerOnHours

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

此设备自上次电源周期以来连续开机的小时数。此属性继承自 CIM_LogicalDevice，但不使用它。

PrimaryStatus

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

提供高级别状态信息。此属性应与 DetailedStatus 属性结合使用，以便为元素及其子组件提供高级别和详细的运行状况信息。 Null 值指示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

RequestedSpeed

数据类型： uint64
访问类型：只读
限定符：单位 (“每秒位数”)

请求的端口带宽（以位/秒为单位）。实际带宽在 Speed 属性中报告。此属性继承自 CIM_LogicalPort。

RequestedState

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

元素的最后一个请求或所需状态。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 12 (不适用) 。

速度

数据类型： uint64
访问类型：只读
限定符：单位 (“每秒位数”)

端口的带宽（以位数/秒为单位）。此属性继承自 CIM_LogicalPort。

Status

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

对象的当前状态。此属性继承自 CIM_ManagedSystemElement。

“确定”
还行
错误
退化
未知
Pred Fail
开始
停止
服务
强调
NonRecover
无联系人
丢失的通信

StatusDescriptions

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

描述各种 OperationalStatus 数组值的字符串。此属性继承自 CIM_ManagedSystemElement，并且每个数组元素始终设置为“OK”。

StatusInfo

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

逻辑设备的当前状态。此属性继承自 CIM_LogicalDevice，但不使用它。

SupportedMaximumTransmissionUnit

数据类型： uint64
访问类型：只读
限定符：单位 (“字节”)

可以支持的最大传输单位 (MTU) （以字节为单位）。此属性继承自 CIM_NetworkPort。

SystemCreationClassName

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

范围系统的创建类名称。此属性继承自 CIM_LogicalDevice，始终设置为“Msvm_ComputerSystem”。

SystemName

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

范围系统的名称。此属性继承自 CIM_LogicalDevice。

TimeOfLastStateChange

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

上次更改元素的启用状态的日期或时间。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 Null。

TotalPowerOnHours

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

此设备通电的总小时数。此属性继承自 CIM_LogicalDevice，但不使用它。

TransitioningToState

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

指示实例要转换到的目标状态。此属性继承自 CIM_EnabledLogicalElement，但不使用它。

UsageRestriction

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

在某些情况下，逻辑端口可以标识为前端或后端端口。这种情况的一个示例是存储阵列，该阵列可能有后端端口与磁盘驱动器通信，以及前端端口与主机通信。如果端口的使用没有限制，则值应设置为“不受限制”。此属性继承自 CIM_LogicalPort。

未知 (0)
仅前端 (2)
仅后端 (3)
不受限制 (4)

备注

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

示例

请参阅查询网络对象。

要求

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

另请参阅

CIM_EthernetPort
CIM_EthernetPort

通过

Msvm_ExternalEthernetPort 类

语法

成员

方法

属性

备注

示例

要求

另请参阅

反馈

其他资源