Msvm_VLANEndpoint-Klasse

Artikel
06/12/2023

Stellt den VLAN-Endpunkt eines Switchports dar. Die Konfiguration dieses Endpunkts ändert die Art und Weise, wie der Switchport VLAN-Pakete über den Switch sendet.

Die folgende Syntax ist vereinfachter MOF-Code (Managed Object Format) und enthält alle geerbten Eigenschaften.

Syntax

[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[];
};

Member

Die Msvm_VLANEndpoint-Klasse verfügt über die folgenden Membertypen:

Methoden
Eigenschaften

Methoden

Die Msvm_VLANEndpoint-Klasse verfügt über diese Methoden.

Methode	Beschreibung
RequestStateChange	Fordert eine Zustandsänderung an.

Eigenschaften

Die Msvm_VLANEndpoint-Klasse verfügt über diese Eigenschaften.

AvailableRequestedStates

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Gibt die möglichen Werte für den RequestedState-Parameter der RequestStateChange-Methode an, die zum Initiieren einer Zustandsänderung verwendet wird. Die aufgeführten Werte sind eine Teilmenge der Werte, die in der RequestedStatesSupported-Eigenschaft des zugeordneten instance von CIM_EnabledLogicalElementCapabilities enthalten sind, wobei die ausgewählten Werte eine Funktion des aktuellen Zustands des CIM_EnabledLogicalElement sind. Diese Eigenschaft kann nicht Null sein, wenn eine Implementierung den Satz möglicher Werte als Funktion des aktuellen Zustands ankündigen kann. Diese Eigenschaft ist NULL , wenn eine Implementierung nicht in der Lage ist, den Satz möglicher Werte als Funktion des aktuellen Zustands zu bestimmen.

Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Aktiviert (2)
Deaktiviert (3)
Herunterfahren (4)
Offline (6)
Test (7)
Zurückstellen (8)
Ruhe (9)
Neustart (10)
Zurücksetzen (11)
DMTF Reserved (.. )

Caption

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Eine kurze Beschreibung des Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "VLAN-Endpunkt" festgelegt.

CommunicationStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt die Fähigkeit der Instrumentierung an, mit dem zugrunde liegenden verwalteten Element zu kommunizieren. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

CreationClassName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Der Name der Klasse oder Unterklasse, die bei der Erstellung eines instance verwendet wird. Diese Eigenschaft wird von CIM_ServiceAccessPoint geerbt und ist immer auf "Msvm_VLANEndpoint" festgelegt.

Beschreibung

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt und ist immer auf "Microsoft VLAN-Endpunkt" festgelegt.

DesiredEndpointMode

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der gewünschte VLAN-Modus, der zur Verwendung angefordert wird. Der aktuelle Modus wird von der OperationalEndpointMode-Eigenschaft angegeben. Diese Eigenschaft wird von CIM_VLANEndpoint geerbt.

Wert	Bedeutung
DMTF Reserviert 0
Andere 1
zugreifen 2	Versetzt den Endpunkt/Switch-Port in den permanenten Nicht-Erkennungsmodus und handelt aus, um den Link in eine nontrunk-Verbindung zu konvertieren. Der Endpunkt wird zu einer Nontrunk-Schnittstelle.
Dynamische Auto 3	Ermöglicht dem Endpunkt, den Link in eine Trunkverbindung zu konvertieren. Der Endpunkt wird zu einer Trunkschnittstelle, wenn die benachbarte Schnittstelle auf trunk oder wünschenswerten Modus festgelegt ist.
Dynamisch wünschenswert 4	Bewirkt, dass der Endpunkt aktiv versucht, den Link in eine Trunkverbindung zu konvertieren. Der Endpunkt wird zu einer Trunkschnittstelle, wenn die benachbarte Schnittstelle auf Trunkmodus, wünschenswert oder Automodus festgelegt ist. Der Standardmäßige Switch-Port-Modus für alle Ethernet-Schnittstellen ist dynamisch wünschenswert.
Trunk 5	Versetzt den Endpunkt in den permanenten Trunkingmodus und verhandelt, um den Link in eine Trunkverbindung zu konvertieren. Der Endpunkt wird zu einer Trunkschnittstelle, auch wenn die benachbarte Schnittstelle keine Trunkschnittstelle ist.
Dot1Q-Tunnel 6	Konfiguriert die Schnittstelle als Tunnelendpunkt bzw. -port, der in einer asymmetrischen Verbindung mit einem 802.1Q-Trunkport verbunden wird. 802.1Q-Tunneling wird verwendet, um die VLAN-Integrität des Kunden in einem Dienstanbieternetzwerk aufrechtzuerhalten.
DMTF Reserviert 7 32767
Anbieter reserviert 32768 65535

DesiredVLANTrunkEncapsulation

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der Typ der VLAN-Kapselung, die zur Verwendung angefordert wird. Die derzeit verwendete Kapselung wird von der OperationalVLANTrunkEncapsulation-Eigenschaft angegeben. Diese Eigenschaft gilt nur, wenn der Endpunkt in einem Trunkingmodus ausgeführt wird (weitere Details finden Sie in der OperationalEndpointMode-Eigenschaft ). Diese Eigenschaft ist entweder 2 (Nicht zutreffend) (d. h., der Endpunkt wird nie in einen Trunkingmodus versetzt), ein bestimmter Typ (802.1Q oder Cisco ISL) oder 5 (Negotiate) (d. h. das Ergebnis der Aushandlung zwischen dieser Schnittstelle und ihrem Nachbar). Der Wert 5 (Negotiate) ist nicht zulässig, wenn der Endpunkt die Aushandlung nicht unterstützt. Diese Funktion ist hardware- und herstellerabhängig. Diese Eigenschaft wird von CIM_VLANEndpoint geerbt.

DMTF Reserviert (0)
Sonstiges (1)
Nicht zutreffend (2)
802.1Q (3)
Cisco ISL (4)
Verhandeln (5)
DMTF Reserviert (6 32767)
Anbieter reserviert (32768 65535)

DetailedStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Ergänzt die PrimaryStatus-Eigenschaft mit zusätzlichen status Details. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

ElementName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Ein Anzeigename für das Objekt. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

EnabledDefault

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die Standard- oder Startkonfiguration eines Administrators für den aktivierten Status eines Elements. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und immer auf 2 (Aktiviert) festgelegt.

EnabledState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die aktivierten und deaktivierten Zustände dieses Elements. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt und ist immer auf 5 (nicht zutreffend) festgelegt.

GVRPStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt an, ob das GARP VLAN Registration Protocol (GVRP) auf dem Trunkendpunkt bzw. -port aktiviert oder deaktiviert ist. Diese Eigenschaft ist 2 (Nicht zutreffend), es sei denn, GVRP wird vom Endpunkt unterstützt. Diese Eigenschaft gilt nur, wenn der Endpunkt im Trunkingmodus ausgeführt wird (weitere Details finden Sie in der OperationalEndpointMode-Eigenschaft ). Diese Eigenschaft wird von CIM_VLANEndpoint geerbt.

Unbekannt (0)
Nicht zutreffend (2)
Aktiviert (3)
Deaktiviert (4 )

HealthState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Die aktuelle Integrität des Elements. Diese Eigenschaft drückt die Integrität dieses Elements aus, aber nicht unbedingt die seiner Unterkomponenten. Die möglichen Werte sind 0 bis 30, wobei 5 bedeutet, dass das Element vollständig fehlerfrei ist und 30 bedeutet, dass das Element vollständig nicht funktionsfähig ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt und ist immer auf 5 (OK) festgelegt.

InstallDate

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Das Datum und die Uhrzeit der Installation des Objekts. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt und nicht verwendet.

InstanceID

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schlüssel

Identifiziert eindeutig einen instance dieser Klasse. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

Name

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Die Bezeichnung, unter der das Objekt bekannt ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

NameFormat

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

Die Benennungsheuristik, die ausgewählt ist, um sicherzustellen, dass der Wert der Name-Eigenschaft eindeutig ist. Diese Eigenschaft wird von CIM_ProtocolEndpoint geerbt und nicht verwendet.

OperatingStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Stellt aktuelle status Informationen für den Betriebszustand des Elements bereit und kann verwendet werden, um weitere Details in Bezug auf den Wert der EnabledState-Eigenschaft bereitzustellen. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

OperationalEndpointMode

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der Konfigurationsmodus für den VLAN-Endpunkt. Diese Eigenschaft wird von CIM_VLANEndpoint geerbt.

Wert	Bedeutung
DMTF Reserviert 0
Andere 1	Der Endpunkt ist nicht VLAN-fähig.
zugreifen 2	Versetzt den Endpunkt in den permanenten Nicht-Vergrößerungsmodus und verhandelt, um den Link in eine nontrunk-Verbindung zu konvertieren. Der Endpunkt wird zu einer Nontrunk-Schnittstelle.
Dynamische Auto 3	Ermöglicht dem Endpunkt, den Link in eine Trunkverbindung zu konvertieren. Der Endpunkt wird zu einer Trunkschnittstelle, wenn die benachbarte Schnittstelle auf trunk oder wünschenswerten Modus festgelegt ist.
Dynamisch wünschenswert 4	Bewirkt, dass der Endpunkt aktiv versucht, den Link in eine Trunkverbindung zu konvertieren. Der Endpunkt wird zu einer Trunkschnittstelle, wenn die benachbarte Schnittstelle auf trunk, wünschenswert oder automatisch festgelegt ist. Dies ist der Standardmäßige Switch-Port-Modus für alle Ethernet-Schnittstellen.
Trunk 5	Versetzt den Endpunkt in den permanenten Trunkingmodus und handelt aus, um die Verknüpfung in eine Trunkverbindung zu konvertieren. Der Endpunkt wird zu einer Trunkschnittstelle, auch wenn die benachbarte Schnittstelle keine Trunkschnittstelle ist.
Dot1Q-Tunnel 6	Konfiguriert die -Schnittstelle als Tunnelendpunkt bzw. -port, der in einer asymmetrischen Verbindung mit einem 802.1Q-Trunkport verbunden wird. 802.1Q-Tunneling wird verwendet, um die VLAN-Integrität des Kunden in einem Dienstanbieternetzwerk aufrechtzuerhalten.
DMTF Reserviert 7 32767
Anbieter reserviert 32768 65535

OperationalStatus

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Die aktuellen Status des -Objekts. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt, und jedes Arrayelement ist immer auf 2 (OK) festgelegt.

OperationalVLANTrunkEncapsulation

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der Typ der VLAN-Kapselung, die auf einem Trunkendpunkt/Port verwendet wird. Diese Eigenschaft ist entweder 2 (Nicht zutreffend) (d. h. der Endpunkt wird nicht im Trunkingmodus ausgeführt), ein bestimmter Typ (3 – 802.1Q oder 4 – Cisco ISL), 5 (Negotiate) (d. h. die Endpunkte verhandeln den Kapselungstyp). Diese Eigenschaft gilt nur, wenn der Endpunkt in einem Trunkingmodus ausgeführt wird (weitere Details finden Sie in der OperationalEndpointMode-Eigenschaft ). Diese Eigenschaft wird von CIM_VLANEndpoint geerbt.

Unbekannt (0)
Sonstiges (1)
Nicht zutreffend (2)
802.1Q (3)
Cisco ISL (4)
Verhandeln (5)
DMTF Reserviert (6 32767)
Anbieter reserviert (32768 65535)

OtherEnabledState

Datentyp: String
Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die den aktivierten oder deaktivierten Zustand des Elements beschreibt, wenn die EnabledState-Eigenschaft auf 1 ("Sonstige") festgelegt ist. Diese Eigenschaft muss auf NULL festgelegt werden, wenn EnabledState einen anderen Wert als 1 aufweist. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und immer auf Null festgelegt.

OtherEndpointMode

Datentyp: string
Zugriffstyp: Schreibgeschützt

Der Typ des VLAN-Endpunktmodells, das von diesem VLAN-Endpunkt unterstützt wird, wenn der Wert der OperationalEndpointMode-Eigenschaft auf 1 (Sonstige) festgelegt ist. Diese Eigenschaft sollte auf NULL festgelegt werden, wenn die OperationalEndpointMode-Eigenschaft einen anderen Wert als 1 aufweist. Diese Eigenschaft wird von CIM_VLANEndpoint geerbt.

OtherTrunkEncapsulation

Datentyp: string
Zugriffstyp: Schreibgeschützt

Der Typ der VLAN-Kapselung, die von diesem VLAN-Endpunkt unterstützt wird, wenn der Wert der OperationalVLANTrunkEncapsulation-Eigenschaft auf 1 (Sonstige) festgelegt ist. Diese Eigenschaft sollte auf Null festgelegt werden, wenn die gewünschte Kapselungseigenschaft einen anderen Wert als 1 aufweist. Diese Eigenschaft wird von CIM_VLANEndpoint geerbt.

OtherTypeDescription

Datentyp: String
Zugriffstyp: Schreibgeschützt

Der Typ des Protokollendpunkts, wenn die Type-Eigenschaft dieser Klasse (oder einer ihrer Unterklassen) auf 1 (Sonstige) festgelegt ist. Diese Eigenschaft wird von CIM_ProtocolEndpoint geerbt und ist immer auf "Virtual Ethernet" festgelegt.

PrimaryStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Stellt allgemeine status Informationen bereit. Diese Eigenschaft sollte in Verbindung mit der DetailedStatus-Eigenschaft verwendet werden, um allgemeine und detaillierte Integrität status Informationen für das Element und seine Unterkomponenten bereitzustellen. Ein Null-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

ProtocolIFType

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der IANA ifType MIB. Diese Eigenschaft wird von CIM_ProtocolEndpoint geerbt und immer auf 1 (Sonstige) festgelegt.

Protocoltype

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_ProtocolEndpoint geerbt und nicht verwendet.

RequestedState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der letzte angeforderte oder gewünschte Status für den Verwaltungsdienst. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und immer auf 12 (Nicht zutreffend) festgelegt.

Wert	Bedeutung
12	Nicht zutreffend

Status

Datentyp: string
Zugriffstyp: Schreibgeschützt

Beschreibt die status des Elements. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

"OK"

"Fehler"

"Heruntergestuft"

"Unbekannt"

"Pred Fail" (Pred Fail)

"Wird gestartet"

"Wird beendet"

"Dienst"

"Gestresst"

"NonRecover"

"Kein Kontakt"

"Lost Comm"

StatusBeschreibungen

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt

Zeichenfolgen, die die verschiedenen OperationalStatus-Arraywerte beschreiben. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt, und jedes Arrayelement ist immer auf "OK" festgelegt.

SupportedEndpointModes

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt
Qualifizierer: ArrayType ("indiziert")

Die von diesem Port unterstützten Endpunktmodi.

SystemCreationClassName

Datentyp: string
Zugriffstyp: Schreibgeschützt

Der Name der Erstellungsklasse des Bereichssystems. Diese Eigenschaft wird von CIM_ServiceAccessPoint geerbt und ist immer auf "Msvm_VirtualSwitch" festgelegt.

Systemname

Datentyp: string
Zugriffstyp: Schreibgeschützt

Der Systemname des Bereichssystems. Diese Eigenschaft wird von CIM_ServiceAccessPoint geerbt.

TimeOfLastStateChange

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Das Datum und die Uhrzeit der letzten Änderung des aktivierten Zustands des Elements. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt, wird aber nicht unterstützt.

TransitioningToState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt den Zielzustand an, in den die instance übergehen. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt, aber nicht verwendet.

Bemerkungen

Der Zugriff auf die Msvm_VLANEndpoint-Klasse kann durch UAC-Filterung eingeschränkt werden. Weitere Informationen finden Sie unter Benutzerkontensteuerung und WMI.

Beispiele

Weitere Informationen finden Sie unter Abfragen von Netzwerkobjekten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Namespace	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Siehe auch

CIM_VLANEndpoint
CIM_VLANEndpoint