共用方式為


Msvm_ExternalEthernetPort 類別

表示外部乙太網路埠 (網路介面卡) 。 這些類型的乙太網路埠可讓虛擬機器存取外部網路。

下列語法是簡化 Managed Object Format (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類別具有這些方法。

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

屬性

Msvm_ExternalEthernetPort類別具有這些屬性。

ActiveMaximumTransmissionUnit

資料類型: uint64

存取類型:唯讀

限定詞: 單位 (「Bytes」)

作用中或交涉的最大傳輸單位 (MTU) ,以位元組為單位。 此屬性繼承自 CIM_NetworkPort

AdditionalAvailability

資料類型: 字串 陣列

存取類型:唯讀

裝置的任何其他可用性和狀態,超出 Availability 屬性中指定的狀態。 此屬性繼承自 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 保留 (。。)

Capabilities

資料類型: uint16 陣列

存取類型:唯讀

指定埠功能的陣列。 此屬性繼承自 CIM_EthernetPort

未知 (0)

其他 (1)

AlertOnLan (2)

WakeOnLan (3)

FailOver (4)

負載平衡 (5)

CapabilityDescriptions

資料類型: 字串 陣列

存取類型:唯讀

自由格式字串的陣列,提供 功能 陣列中包含的埠功能更詳細的說明。 此陣列的每個專案都與位於相同索引之 Capabilities 陣列中的對應專案相關。 此屬性繼承自 CIM_EthernetPort

標題

資料類型: 字串

存取類型:唯讀

限定詞: MaxLen (64)

物件的簡短描述。 此屬性繼承自 CIM_ManagedElement,而且一律會設定為 「乙太網路埠」。

CommunicationStatus

資料類型: uint16

存取類型:唯讀

指出檢測能夠與基礎 Managed 元素通訊。 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)

FailOver (4)

負載平衡 (5)

EnabledDefault

資料類型: uint16

存取類型:唯讀

元素 之 EnabledState 屬性的系統管理員預設或啟動組態。 此屬性繼承自 CIM_EnabledLogicalElement,且一律設定為 2 (Enabled) 。

EnabledState

資料類型: uint16

存取類型:唯讀

專案的啟用和停用狀態。 它也可以指出這些要求狀態之間的轉換。 例如,關閉 (4) ,以及啟動 (10) 是啟用和停用之間的暫時性狀態。 此屬性繼承自 CIM_EnabledLogicalElement

意義
Unknown
0
其他
1
Enabled
2
元素是 或 可以執行命令、會處理任何已排入佇列的命令,以及將新要求排入佇列。
停用
3
元素不會執行命令,而且會卸載任何新的要求。
關閉
4
元素正在進入 [已停用] 狀態。
不適用
5
專案不支援啟用或停用。
已啟用但離線
6
元素可能正在完成命令,而且會卸載任何新的要求。
在測試中
7
元素處於測試狀態。
已延期
8
元素可能正在完成命令,但會將任何新要求排入佇列。
靜止
9
元素已啟用,但處於受限制模式。 專案的行為類似于 Enabled 狀態,但只會處理一組受限制的命令。 所有其他要求都會排入佇列。
啟動中
10
元素正在進入 Enabled 狀態。 新的要求會排入佇列。
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 (OK) 。

IdentifyingDescriptions

資料類型: 字串 陣列

存取類型:唯讀

自由格式字串的陣列,提供 OtherIdentificationInfo 屬性陣列中專案背後的說明和詳細資料。 此屬性繼承自 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)

Token Ring (7)

Frame Relay (8)

基礎結構 (9)

BlueTooth (10)

無線區域網路 (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 (OK) 。

OtherEnabledCapabilities

資料類型: 字串 陣列

存取類型:唯讀

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

OtherEnabledState

資料類型: 字串

存取類型:唯讀

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

OtherIdentifyingInfo

資料類型: 字串 陣列

存取類型:唯讀

裝置識別碼資訊以外的任何其他資料,可用來識別邏輯裝置。 此屬性繼承自 CIM_LogicalDevice,但不會使用。

OtherLinkTechnology

資料類型: 字串

存取類型:唯讀

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

OtherNetworkPortType

資料類型: 字串

存取類型:唯讀

此屬性的使用已被取代,而不是 PortType 屬性。 此屬性繼承自 CIM_NetworkPort

OtherPortType

資料類型: 字串

存取類型:唯讀

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

PermanentAddress

資料類型: 字串

存取類型:唯讀

限定詞: MaxLen (64)

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

PortNumber

資料類型: uint16

存取類型:唯讀

連接埠號碼。 此屬性繼承自 CIM_NetworkPort

PortType

資料類型: uint16

存取類型:唯讀

目前為埠啟用的特定模式。 當設定為 1 (「Other」) 時,Related 屬性 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

狀態

資料類型: 字串

存取類型:唯讀

物件的目前狀態。 此屬性繼承自 CIM_ManagedSystemElement

「OK」

還行

錯誤

退化

未知

預先失敗

開始

停止

服務

強調

NonRecover

無連絡人

遺失 Comm

StatusDescriptions

資料類型: 字串 陣列

存取類型:唯讀

描述各種 OperationalStatus 陣列值的字串。 此屬性繼承自 CIM_ManagedSystemElement,而且每個陣列元素一律會設定為 「OK」。

StatusInfo

資料類型: uint16

存取類型:唯讀

邏輯裝置的目前狀態。 此屬性繼承自 CIM_LogicalDevice,但不會使用。

SupportedMaximumTransmissionUnit

資料類型: uint64

存取類型:唯讀

限定詞: 單位 (「Bytes」)

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

SystemCreationClassName

資料類型: 字串

存取類型:唯讀

範圍系統的建立類別名稱。 此屬性繼承自 CIM_LogicalDevice,而且一律設定為 「Msvm_ComputerSystem」。

SystemName

資料類型: 字串

存取類型:唯讀

範圍系統的名稱。 此屬性繼承自 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