Msvm_SyntheticEthernetPort 類別

發行項
06/13/2023

表示綜合乙太網路卡。此介面卡是慣用的網路介面卡，因為其效能和變更可能會立即生效，而作用中 (經常性設定) 。

下列語法是簡化 Managed 物件格式 (MOF) 程式碼，並包含所有繼承的屬性。

語法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SyntheticEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName;
  string   SystemName;
  string   CreationClassName;
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = 6;
  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[];
};

成員

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

方法
屬性

方法

Msvm_SyntheticEthernetPort類別具有這些方法。

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

屬性

Msvm_SyntheticEthernetPort類別具有這些屬性。

ActiveMaximumTransmissionUnit

資料類型： uint64
存取類型：唯讀
限定詞：單位 (「Bytes」)

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

AdditionalAvailability

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

裝置的其他可用性和狀態，超出 Availability 屬性中指定的狀態。此屬性繼承自 CIM_LogicalDevice，而且一律設定為 6 (不適用) 。

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 保留 (。。)

Capabilities

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

乙太網路埠的功能。例如，裝置可能支援 AlertOnLan、WakeOnLan、負載平衡或容錯移轉。如果列出容錯移轉或負載平衡功能，則也應該定義 SpareGroup (容錯移轉) 或 ExtraCapacityGroup (負載平衡) ，以完整描述功能。此屬性繼承自 CIM_EthernetPort ，且不會使用。

CapabilityDescriptions

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

自由格式字串的陣列，針對 Capabilities 屬性陣列中所指出的任何 EthernetPort 功能，提供更詳細的說明。請注意，此陣列的每個專案都與位於相同索引之 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。

ElementName

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

物件的顯示名稱。此屬性繼承自 CIM_ManagedElement。

EnabledCapabilities

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

從所有支援的功能清單中啟用的功能，這些功能定義于 Capabilities 屬性陣列中。此屬性繼承自 CIM_EthernetPort，但不會使用。

EnabledDefault

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

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

EnabledState

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

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

ErrorCleared

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

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

ErrorDescription

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

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

FullDuplex

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

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

HealthState

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

專案目前的健全狀況。此屬性繼承自 CIM_ManagedSystemElement。

IdentifyingDescriptions

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

自由格式字串陣列，提供 OtherIdentificationInfo 陣列中專案背後的說明和詳細資料。此屬性繼承自 CIM_LogicalDevice ，且不會使用。

InstallDate

資料類型： 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

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

乙太net/802.3 MAC 位址格式化為十六進位數位 (例如「010203040506」) ，每個配對都代表標準位順序 MAC 位址的六個八位 (群組位址位位於字串第一個字元的低序位) 。此屬性繼承自 CIM_EthernetPort，且不會使用。

OperatingStatus

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

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

OperationalStatus

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

專案的目前狀態。這個屬性繼承自 CIM_ManagedSystemElement，而且一律設定為 2 (OK) 。

OtherEnabledCapabilities

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

自由格式字串陣列，提供任何指定為「其他」之已啟用功能的詳細說明。此屬性繼承自 CIM_EthernetPort ，且不會使用。

OtherEnabledState

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

當 EnabledState 屬性設定為 1 (Other) 時，專案的啟用或停用狀態。此屬性繼承自 CIM_EnabledLogicalElement。

OtherIdentifyingInfo

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

除了裝置識別碼資訊之外，任何可用來識別邏輯裝置的資料。此屬性繼承自 CIM_LogicalDevice ，且不會使用。

OtherLinkTechnology

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

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

OtherNetworkPortType

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

此屬性繼承自 CIM_NetworkPort ，且設定為 Null。

OtherPortType

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

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

PermanentAddress

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

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

PortNumber

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

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

PortType

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

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

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。

速度

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

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

狀態

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

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

StatusDescriptions

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

描述各種 OperationalStatus 陣列值的字串。此屬性繼承自 CIM_ManagedSystemElement。

StatusInfo

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

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

SupportedMaximumTransmissionUnit

資料類型： uint64
存取類型：唯讀
限定詞：單位 (「Bytes」)

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

SystemCreationClassName

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

範圍系統的建立類別名稱。此屬性繼承自 CIM_LogicalDevice。

SystemName

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

主控電腦系統的 NetBIOS 名稱。這個屬性會以 GUID 格式包含虛擬機器識別碼。此屬性繼承自 CIM_LogicalDevice。

TimeOfLastStateChange

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

上次變更專案啟用狀態的日期或時間。此屬性繼承自 CIM_EnabledLogicalElement。

TotalPowerOnHours

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

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

TransitioningToState

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

指出實例正在轉換的目標狀態。此屬性繼承自 CIM_EnabledLogicalElement。

UsageRestriction

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

在某些情況下，邏輯埠可能會識別為前端或後端埠。如果埠的使用沒有任何限制，則值應該設定為 4 ([不受限制]) 。此屬性繼承自 CIM_LogicalPort。

備註

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

範例

請參閱查詢網路物件。

規格需求

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

另請參閱

CIM_EthernetPort
CIM_EthernetPort

共用方式為

Msvm_SyntheticEthernetPort 類別

語法

成員

方法

屬性

備註

範例

規格需求

另請參閱

意見反應

其他資源