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 |
|
DLL |
|