Msvm_VLANEndpoint 類別

發行項
06/12/2023

表示交換器埠的 VLAN 端點。此端點的設定將會變更交換器埠透過交換器傳送 VLAN 封包的方式。

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

語法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VLANEndpoint : CIM_VLANEndpoint
{
  string   InstanceID;
  String   Caption = "VLAN Endpoint";
  string   Description = "Microsoft VLAN Endpoint";
  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_VirtualSwitch";
  string   SystemName;
  String   CreationClassName = "Msvm_VLANEndpoint";
  String   NameFormat;
  uint16   ProtocolType;
  uint16   ProtocolIFType = 1;
  String   OtherTypeDescription = "Virtual Ethernet";
  uint16   DesiredEndpointMode;
  string   OtherEndpointMode;
  uint16   OperationalEndpointMode;
  uint16   DesiredVLANTrunkEncapsulation;
  string   OtherTrunkEncapsulation;
  uint16   OperationalVLANTrunkEncapsulation;
  uint16   GVRPStatus;
  uint16   SupportedEndpointModes[];
};

成員

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

方法
屬性

方法

Msvm_VLANEndpoint類別具有這些方法。

方法	Description
RequestStateChange	要求狀態變更。

屬性

Msvm_VLANEndpoint類別具有這些屬性。

AvailableRequestedStates

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

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

此屬性繼承自 CIM_EnabledLogicalElement。

已啟用 (2)
已停用 (3)
關閉 (4)
離線 (6)
測試 (7)
延遲 (8)
停止 (9)
重新開機 (10)
重設 (11)
DMTF 保留 (。。)

標題

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

物件的簡短描述。此屬性繼承自 CIM_ManagedElement，而且一律會設定為「VLAN Endpoint」。

CommunicationStatus

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

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

CreationClassName

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

在建立實例時所使用的類別或子類別名稱。此屬性繼承自 CIM_ServiceAccessPoint，而且一律會設定為「Msvm_VLANEndpoint」。

說明

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

對物件的描述。此屬性繼承自 CIM_ManagedElement，而且一律會設定為「Microsoft VLAN Endpoint」。

DesiredEndpointMode

資料類型： uint16
存取類型：僅限寫入

要求使用的所需 VLAN 模式。目前的模式是由 OperationalEndpointMode 屬性所指定。此屬性繼承自 CIM_VLANEndpoint。

值	意義
DMTF 保留 0
其他 1
存取 2	將端點/交換器埠放入永久的非trunking 模式，並交涉以將連結轉換成非trunk 連結。端點會變成非trunk 介面。
動態自動 3	讓端點能夠將連結轉換成主幹連結。如果鄰近介面設定為主幹或想要模式，端點就會變成主幹介面。
動態預期 4	讓端點主動嘗試將連結轉換成主幹連結。如果鄰近介面設定為主幹、預期或自動模式，端點就會變成主幹介面。所有乙太網路介面的預設交換器埠模式是動態的。
主幹 5	將端點放入永久主幹模式，並交涉以將連結轉換成主幹連結。即使鄰近介面不是主幹介面，端點也會變成主幹介面。
Dot1Q 通道 6	將介面設定為通道 (非結構) 端點/埠，以非對稱連結與 802.1Q 主幹埠連線。 802.1Q 通道可用來維護服務提供者網路的客戶 VLAN 完整性。
DMTF 保留 7 32767
廠商保留 32768 65535

DesiredVLANTrunkEncapsulation

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

要求使用的 VLAN 封裝類型。目前使用的封裝是由 OperationalVLANTrunkEncapsulation 屬性所提供。只有當端點是以主幹模式運作時，才適用此屬性， (請參閱 OperationalEndpointMode 屬性以取得其他詳細資料) 。這個屬性是 2 個 (不適用) (，也就是說，端點永遠不會放在主幹模式) 、特定類型 (802.1Q 或 Cisco ISL) ，或 5 (Negotiate) (，也就是這個介面與其鄰近) 之間的交涉結果。如果端點不支援交涉，則不允許值 5 (Negotiate) 。這項功能與硬體和廠商相依。此屬性繼承自 CIM_VLANEndpoint。

DMTF 保留 (0)
其他 (1)
不適用 (2)
802.1Q (3)
Cisco ISL (4)
交涉 (5)
DMTF 保留 (6 32767)
廠商保留 (32768 65535)

DetailedStatus

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

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

ElementName

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

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

EnabledDefault

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

啟用專案狀態的系統管理員預設或啟動組態。此屬性繼承自 CIM_EnabledLogicalElement ，且一律會設定為 2 (Enabled) 。

EnabledState

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

這個專案的啟用和停用狀態。此屬性繼承自 CIM_ManagedSystemElement，且一律會設定為 5 (不適用) 。

GVRPStatus

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

指出是否在主幹端點/埠上啟用或停用 GARP VLAN 註冊通訊協定 (GVRP) 。除非端點支援 GVRP，否則此屬性為 2 (不適用) 。只有當端點以主幹模式運作時，此屬性才適用 (如需其他詳細資料，請參閱 OperationalEndpointMode 屬性以取得其他詳細資料) 。此屬性繼承自 CIM_VLANEndpoint。

未知 (0)
不適用 (2)
已啟用 (3)
已停用 (4 )

HealthState

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

專案的目前健全狀況。這個屬性工作表示這個專案的健康情況，但不一定是其子元件的健康情況。可能的值為 0 到 30，其中 5 表示元素狀況完全良好，而 30 表示元素完全非功能。此屬性繼承自 CIM_ManagedSystemElement，且一律會設定為 5 (OK) 。

InstallDate

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

安裝物件的日期和時間。此屬性繼承自 CIM_ManagedSystemElement，而且不會使用。

InstanceID

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

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

名稱

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

已知物件的標籤。此屬性繼承自 CIM_ManagedSystemElement。

NameFormat

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

選取的命名啟發學習法，以確保 Name 屬性的值是唯一的。此屬性繼承自 CIM_ProtocolEndpoint ，且不會使用。

OperatingStatus

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

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

OperationalEndpointMode

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

VLAN 端點的組態模式。此屬性繼承自 CIM_VLANEndpoint。

值	意義
DMTF 保留 0
其他 1	端點不感知 VLAN。
存取 2	將端點放入永久的非結構模式，並交涉以將連結轉換成非trunk 連結。端點會變成非trunk 介面。
動態自動 3	讓端點能夠將連結轉換成主幹連結。如果鄰近介面設定為主幹或想要模式，端點就會變成主幹介面。
動態預期 4	讓端點主動嘗試將連結轉換為主幹連結。如果鄰近介面設定為主幹、預期或自動模式，端點就會變成主幹介面。這是所有乙太網路介面的預設交換器埠模式。
主幹 5	將端點放入永久主幹模式，並交涉將連結轉換成主幹連結。即使鄰近介面不是主幹介面，端點也會變成主幹介面。
Dot1Q 通道 6	將介面設定為通道 (非結構) 端點/埠，以非對稱連結與 802.1Q 主幹埠連線。 802.1Q 通道可用來維護服務提供者網路之間的客戶 VLAN 完整性。
DMTF 保留 7 32767
廠商保留 32768 65535

OperationalStatus

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

物件的目前狀態。此屬性繼承自 CIM_ManagedSystemElement，而且每個陣列元素一律會設定為 2 (OK) 。

OperationalVLANTrunkEncapsulation

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

在主幹端點/埠上使用的 VLAN 封裝類型。此屬性可以是 2 個 (不適用) (，也就是端點未在主幹模式) 中運作，特定類型 (3 - 802.1Q 或 4 - Cisco ISL) ，5 (Negotiate) (，也就是端點正在交涉封裝類型) 。只有當端點在主幹模式中運作時，此屬性才適用， (請參閱 OperationalEndpointMode 屬性以取得其他詳細資料) 。此屬性繼承自 CIM_VLANEndpoint。

未知 (0)
其他 (1)
不適用 (2)
802.1Q (3)
Cisco ISL (4)
交涉 (5)
DMTF 保留 (6 32767)
廠商保留 (32768 65535)

OtherEnabledState

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

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

OtherEndpointMode

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

當 OperationalEndpointMode 屬性的值設定為 1 (Other) 時，此 VLAN 端點所支援的 VLAN 端點模型類型。當OperationalEndpointMode屬性是 1 以外的任何值時，此屬性應該設定為Null。此屬性繼承自 CIM_VLANEndpoint。

OtherTrunkEncapsulation

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

當 OperationalVLANTrunkEncapsulation 屬性的值設定為 1 (Other) 時，此 VLAN 端點所支援的 VLAN 封裝類型。當所需的封裝屬性是 1 以外的任何值時，這個屬性應該設定為 Null 。此屬性繼承自 CIM_VLANEndpoint。

OtherTypeDescription

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

當這個類別的 Type 屬性 (或其任何子類別) 設定為 1 (Other) 時，通訊協定端點的類型。此屬性繼承自 CIM_ProtocolEndpoint，而且一律設定為「虛擬乙太網路」。

PrimaryStatus

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

提供高階狀態資訊。這個屬性應該與 DetailedStatus 屬性搭配使用，以提供元素及其子元件的高階和詳細的健全狀態資訊。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

ProtocolIFType

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

IANA ifType MIB。此屬性繼承自 CIM_ProtocolEndpoint，而且一律設定為 1 (Other) 。

ProtocolType

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

此屬性繼承自 CIM_ProtocolEndpoint ，且不會使用。

RequestedState

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

管理服務的最後一個要求或所需狀態。此屬性繼承自 CIM_EnabledLogicalElement，而且一律設定為 12 (不適用) 。

值	意義
12	不適用。

狀態

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

描述專案的狀態。此屬性繼承自 CIM_ManagedSystemElement。

「OK」

「錯誤」

「已降級」

「未知」

「Pred Fail」

「Starting」

「Stopping」

「服務」

「Stressed」

「NonRecover」

「沒有連絡人」

「Lost Comm」

StatusDescriptions

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

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

SupportedEndpointModes

資料類型： uint16 陣列
存取類型：唯讀
限定詞： ArrayType (「Indexed」)

此埠支援的端點模式。

SystemCreationClassName

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

範圍系統的建立類別名稱。此屬性繼承自 CIM_ServiceAccessPoint，且一律會設定為「Msvm_VirtualSwitch」

SystemName

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

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

TimeOfLastStateChange

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

上次變更專案啟用狀態的日期和時間。此屬性繼承自 CIM_EnabledLogicalElement，但不受支援。

TransitioningToState

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

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

備註

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

範例

請參閱查詢網路物件。

規格需求

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

另請參閱

CIM_VLANEndpoint
CIM_VLANEndpoint

Msvm_VLANEndpoint 類別

語法

成員

方法

屬性

備註

範例

規格需求

另請參閱

意見反應

意見反應

其他資源