Msvm_InternalEthernetPort 類別

發行項
06/13/2023

表示內部乙太網路埠 (網路介面卡) 。這種類型的乙太網路埠可讓虛擬機器存取執行網路軟體的虛擬化伺服器。內部網路介面卡允許在離開實體系統之前路由或篩選虛擬機器網路流量。

下列語法是簡化 Managed Object Format (MOF) 程式碼，其中包含所有繼承的屬性。

語法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_InternalEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Port";
  string   Description = "Microsoft Internal Ethernet Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[] = { "OK" };
  string   Status;
  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_InternalEthernetPort";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint16   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = 6;
  uint64   MaxQuiesceTime;
  uint64   MaxSpeed = 1000000000;
  uint64   RequestedSpeed = 1000000000;
  uint16   UsageRestriction = 4;
  string   OtherPortType;
  uint64   Speed;
  string   OtherNetworkPortType;
  uint16   PortNumber;
  uint16   LinkTechnology = 2;
  string   OtherLinkTechnology;
  string   PermanentAddress;
  boolean  FullDuplex = True;
  boolean  AutoSense = True;
  uint64   SupportedMaximumTransmissionUnit = 1500;
  uint64   ActiveMaximumTransmissionUnit = 1500;
  uint16   PortType;
  string   NetworkAddresses[];
  uint32   MaxDataSize = 1500;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  uint16   EnabledCapabilities[];
  string   OtherEnabledCapabilities[];
};

成員

Msvm_InternalEthernetPort類別具有下列類型的成員：

方法
屬性

方法

Msvm_InternalEthernetPort類別具有這些方法。

方法	Description
EnableDevice	不支援這個方法。
OnlineDevice	不支援這個方法。
QuiesceDevice	不支援這個方法。
RequestStateChange	要求狀態變更。
重置	重設虛擬裝置。
RestoreProperties	不支援這個方法。
SaveProperties	不支援這個方法。
SetPowerState	不支援這個方法。

屬性

Msvm_InternalEthernetPort類別具有這些屬性。

ActiveMaximumTransmissionUnit

資料類型： uint64
存取類型：唯讀

支援的作用中或交涉最大傳輸單位 (MTU) 。此屬性繼承自 CIM_NetworkPort。

AdditionalAvailability

資料類型： uint16 陣列
存取類型：唯讀

裝置的任何其他可用性和狀態，超出 Availability 屬性中指定的狀態。此屬性繼承自 CIM_LogicalDevice。

AutoSense

資料類型： 布林值
存取類型：唯讀

指出網路埠是否能夠自動判斷連結網路媒體的速度或其他通訊特性。此屬性繼承自 CIM_NetworkPort。

可用性

資料類型： uint16
存取類型：唯讀

裝置的主要可用性和狀態。此屬性繼承自 CIM_LogicalDevice ，且不會使用。

AvailableRequestedStates

資料類型： uint16 陣列
存取類型：唯讀

指出用於起始狀態變更之RequestStateChange 方法 RequestedState參數的可能值。列出的值將是CIM_EnabledLogicalElementCapabilities相關聯實例 的 RequestedStatesSupported 屬性中包含的值子 集，其中選取的值是 CIM_EnabledLogicalElement 物件目前狀態的函式。如果實作能夠將一組可能的值公告為目前狀態的函式，這個屬性可以是非Null 。如果實作無法判斷可能值的集合做為目前狀態的函式，這個屬性會是 Null 。

此屬性繼承自 CIM_EnabledLogicalElement，但不會使用。

Capabilities

資料類型： uint16 陣列
存取類型：唯讀

乙太網路埠的功能。如果列出容錯移轉或負載平衡功能，也應該定義 CIM_SpareGroup (容錯移轉) 或 CIM_ExtraCapacityGroup (負載平衡) 來完整描述功能。此屬性繼承自 CIM_EthernetPort。

未知 (0)
其他 (1)
AlertOnLan (2)
WakeOnLan (3)
FailOver (4)
負載平衡 (5)

CapabilityDescriptions

資料類型：字串陣列
存取類型：唯讀

自由格式字串的陣列，提供 功能陣列中所 指出之任何乙太網路埠功能的詳細說明。請注意，此陣列的每個專案都與位於相同索引的 Capabilities 陣列中的專案相關。此屬性繼承自 CIM_EthernetPort。

標題

資料類型：字串
存取類型：唯讀

物件的簡短描述。此屬性繼承自 CIM_ManagedElement。

CommunicationStatus

資料類型： uint16
存取類型：唯讀

指出檢測能夠與基礎 Managed 元素通訊。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

CreationClassName

資料類型：字串
存取類型：唯讀

在建立實例時所使用的類別或子類別名稱。搭配這個類別的其他索引鍵屬性使用時，這個屬性可讓這個類別及其子類別的所有實例唯一識別。此屬性繼承自 CIM_LogicalDevice。

說明

資料類型：字串
存取類型：唯讀

對物件的描述。此屬性繼承自 CIM_ManagedElement。

DetailedStatus

資料類型： uint16
存取類型：唯讀

以其他狀態詳細資料補充 PrimaryStatus 屬性。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

DeviceID

資料類型：字串
存取類型：唯讀

用來唯一命名邏輯裝置的位址或其他識別資訊。此屬性繼承自CIM_LogicalDevice，而且會設定為「Microsoft：GUID\裝置特定資料」。

ElementName

資料類型：字串
存取類型：讀取/寫入

物件的顯示名稱。這個屬性可讓每個實例定義顯示名稱，以及其索引鍵屬性、身分識別資料和描述資訊。此屬性繼承自 CIM_ManagedElement ，並根據主機中的 NIC 產生。

EnabledCapabilities

資料類型： uint16 陣列
存取類型：唯讀

指定從功能陣列中定義之所有支援功能的清單啟用哪些功能。此屬性繼承自 CIM_EthernetPort。

未知 (0)
其他 (1)
AlertOnLan (2)
WakeOnLan (3)
FailOver (4)
負載平衡 (5)

EnabledDefault

資料類型： uint16
存取類型：唯讀

系統管理員的元素啟用狀態的預設或啟動組態。此屬性繼承自 CIM_EnabledLogicalElement。

EnabledState

資料類型： uint16
存取類型：唯讀

專案的啟用和停用狀態。此屬性繼承自 CIM_EnabledLogicalElement。

ErrorCleared

資料類型： 布林值
存取類型：唯讀

指出 LastErrorCode 屬性中回報的錯誤現在是否已清除。此屬性繼承自 CIM_LogicalDevice ，且不會使用。

ErrorDescription

資料類型：字串
存取類型：唯讀

字串，提供有關 LastErrorCode 屬性中所記錄之錯誤的詳細資訊，以及可能採取之任何更正動作的相關資訊。此屬性繼承自 CIM_LogicalDevice 屬性，且不會使用。

FullDuplex

資料類型： 布林值
存取類型：唯讀

指出埠是否以全雙工模式運作。此屬性繼承自 CIM_NetworkPort。

HealthState

資料類型： uint16
存取類型：唯讀

專案目前的健全狀況。這個屬性工作表示這個專案的健康情況，但不一定表示其子元件的健全狀況。此屬性繼承自 CIM_ManagedSystemElement。

IdentifyingDescriptions

資料類型：字串陣列
存取類型：唯讀

自由格式字串的陣列，提供 OtherIdentificationInfo 屬性陣列中專案背後的說明和詳細資料。此陣列的每個專案都與位於相同索引之 OtherIdentificationInfo 屬性陣列中的專案相關。此屬性繼承自 CIM_LogicalDevice ，且不會使用。

InstallDate

資料類型： datetime
存取類型：唯讀

datetime值，指出何時安裝物件。缺少值並不表示未安裝物件。此屬性繼承自 CIM_ManagedSystemElement。

InstanceID

資料類型：字串
存取類型：唯讀
限定詞：金鑰

唯一識別這個類別的實例。此屬性繼承自 CIM_ManagedElement。

LastErrorCode

資料類型： uint32
存取類型：唯讀

邏輯裝置所報告的最後一個錯誤碼。此屬性繼承自 CIM_LogicalDevice ，且不會使用。

LinkTechnology

資料類型： uint16
存取類型：唯讀

連結的類型。當設定為 1 (Other) 時， OtherLinkTechnology 的相關屬性會包含連結類型的字串描述。此屬性繼承自 CIM_NetworkPort。

值	意義
2	乙太網路

MaxDataSize

資料類型： uint32
存取類型：唯讀

將接收或傳輸之 INFO (非 MAC) 欄位的大小上限。此屬性繼承自 CIM_EthernetPort。

MaxQuiesceTime

資料類型： uint64
存取類型：唯讀

這個屬性已被取代。此屬性繼承自 CIM_LogicalDevice ，且不會使用。

MaxSpeed

資料類型： uint64
存取類型：唯讀

埠的最大頻寬，每秒以位為單位。此屬性繼承自 CIM_LogicalPort。

名稱

資料類型：字串
存取類型：唯讀

已知物件的標籤。子類別化時，這個屬性可以覆寫為索引鍵屬性。此屬性繼承自 CIM_ManagedSystemElement。

NetworkAddresses

資料類型：字串陣列
存取類型：唯讀

乙太網路/802.3 MAC 位址格式化為十六進位數位 (，例如「010203040506」) ，每個配對都代表標準位順序中 MAC 位址的六個八位， (群組位址位是在字串第一個字元的低序位中找到。) 此屬性繼承自 CIM_EthernetPort。

OperatingStatus

資料類型： uint16
存取類型：唯讀

提供元素作業條件的目前狀態資訊，並可用來提供 有關 EnabledState 屬性值的詳細資料。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

OperationalStatus

資料類型： uint16 陣列
存取類型：唯讀

專案的目前狀態。此屬性繼承自 CIM_ManagedSystemElement。

OtherEnabledCapabilities

資料類型：字串陣列
存取類型：唯讀

自由格式字串陣列，提供指定為 1 (Other) 之任何已啟用功能的詳細說明。此屬性繼承自 CIM_EthernetPort。

OtherEnabledState

資料類型：字串
存取類型：唯讀

字串，描述 EnabledState 屬性設定為 1 (Other. ) 當EnabledState 屬性為 1 以外的任何值時，元素的啟用或停用狀態的字串。此屬性繼承自 CIM_EnabledLogicalElement。

OtherIdentifyingInfo

資料類型：字串陣列
存取類型：唯讀

除了裝置識別碼資訊之外，可用來識別邏輯裝置的任何資料。例如，您可以使用這個屬性來保存裝置的作業系統顯示名稱。此屬性繼承自 CIM_LogicalDevice ，且不會使用。

OtherLinkTechnology

資料類型：字串
存取類型：唯讀

字串值，描述 當 LinkTechnology 屬性設定為 1 (Other) 時。此屬性繼承自 CIM_NetworkPort。

OtherNetworkPortType

資料類型：字串
存取類型：唯讀

此屬性已被取代。使用 PortType 屬性。此屬性繼承自 CIM_NetworkPort。

已被取代的描述：當 PortType 屬性設定為 1 (Other) 時，模組的類型。

OtherPortType

資料類型：字串
存取類型：唯讀

當 PortType 屬性設定為 1 (Other) 時，模組的類型。此屬性繼承自 CIM_LogicalPort 。

PermanentAddress

資料類型：字串
存取類型：唯讀

硬式編碼至埠的網路位址。您可以使用韌體升級或軟體組態來變更此位址。進行這項變更時，應該同時更新欄位。如果網路介面卡沒有硬式編碼位址，這應該保留空白。此屬性繼承自 CIM_NetworkPort。

PortNumber

資料類型： uint16
存取類型：唯讀

網路埠通常以邏輯模組或網路元素相對編號。針對模擬 NIC，此值為 1，所有其他 0 則為。此屬性繼承自 CIM_NetworkPort。

PortType

資料類型： uint16
存取類型：唯讀

目前為埠啟用的特定模式。當設定為 1 (Other) 時，Related 屬性 OtherPortType 會包含埠類型的字串描述。此屬性繼承自 CIM_EthernetPort。

未知 (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
存取類型：唯讀

管理服務的最後一個要求或所需狀態。當 EnabledState 屬性設定為 5 (不適用) 時，此屬性就沒有意義。此屬性繼承自 CIM_EnabledLogicalElement。

速度

資料類型： uint64
存取類型：唯讀
限定詞：覆寫、單位 (「每秒位數」)

每秒以位為單位的埠目前頻寬。對於頻寬不同或無法進行精確估計的埠，此屬性應包含標準頻寬。此屬性繼承自 CIM_NetworkPort。

狀態

資料類型：字串
存取類型：唯讀

物件的目前狀態。此屬性繼承自 CIM_ManagedSystemElement，但不會使用。

StatusDescriptions

資料類型：字串陣列
存取類型：唯讀

描述各種 OperationalStatus 陣列值的字串。此陣列中的專案會與 OperationalStatus中相同陣列索引的專案相互關聯。此屬性繼承自 CIM_ManagedSystemElement。

StatusInfo

資料類型： uint16
存取類型：唯讀

邏輯裝置的狀態。此屬性繼承自 CIM_LogicalDevice ，且不會使用。

SupportedMaximumTransmissionUnit

資料類型： uint64
存取類型：唯讀

可支援的最大傳輸單位 (MTU) 。此屬性繼承自 CIM_NetworkPort。

SystemCreationClassName

資料類型：字串
存取類型：唯讀

界定系統的建立類別名稱。此屬性繼承自 CIM_LogicalDevice，但不受支援

SystemName

資料類型：字串
存取類型：唯讀

範圍系統的名稱。此屬性繼承自 CIM_LogicalDevice。

TimeOfLastStateChange

資料類型： datetime
存取類型：唯讀

上次變更專案 之 EnabledState 屬性的日期或時間。如果元素的狀態尚未變更，而且已填入此屬性，則必須將它設定為 0 間隔值。如果要求狀態變更，但已拒絕或尚未處理，則屬性不得更新。此屬性繼承自 CIM_EnabledLogicalElement ，且不會使用。

TotalPowerOnHours

資料類型： uint16
存取類型：唯讀

此裝置已啟動的時數總計。此屬性繼承自 CIM_LogicalDevice ，且不會使用。

TransitioningToState

資料類型： uint16
存取類型：唯讀

指出實例正在轉換的目標狀態。此屬性繼承自 CIM_EnabledLogicalElement，但不會使用。

UsageRestriction

資料類型： uint16
存取類型：唯讀

在某些情況下，邏輯埠可能會識別為前端或後端埠。此屬性繼承自 CIM_LogicalPort。

值	意義
4	不受限制

備註

Msvm_InternalEthernetPort類別的存取可能會受到 UAC 篩選的限制。如需詳細資訊，請參閱使用者帳戶控制和 WMI。

範例

請參閱查詢網路物件。

規格需求

需求	值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
命名空間	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

另請參閱

CIM_EthernetPort
CIM_EthernetPort

共用方式為

Msvm_InternalEthernetPort 類別

語法

成員

方法

屬性

備註

範例

規格需求

另請參閱

意見反應

其他資源