Msvm_VirtualEthernetSwitch-Klasse

Artikel
06/12/2023

Stellt einen virtuellen Ethernet-Switch dar. Jeder Switch verfügt über viele verschiedene Ports, an die Netzwerkadapter angefügt werden können. Der Switch selbst ist nicht sehr konfigurierbar und fungiert meist als Platzhalter.

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

Syntax

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualEthernetSwitch : CIM_ComputerSystem
{
  string   InstanceID;
  string   Caption = "Virtual Switch";
  string   Description = "Microsoft Virtual Switch";
  string   ElementName;
  datetime InstallDate;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   CreationClassName = "Msvm_VirtualEthernetSwitch";
  string   Name = "GUID";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   Roles[];
  string   NameFormat;
  string   OtherIdentifyingInfo[];
  string   IdentifyingDescriptions[];
  uint16   Dedicated[];
  string   OtherDedicatedDescriptions[];
  uint16   ResetCapability = 5;
  uint16   PowerManagementCapabilities[];
  uint32   MaxVMQOffloads;
  uint32   MaxIOVOffloads;
};

Member

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

Methoden
Eigenschaften

Methoden

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

Methode	Beschreibung
RequestStateChange	Fordert eine Zustandsänderung an.
SetPowerState	Diese Methode wird nicht unterstützt.

Eigenschaften

Die Msvm_VirtualEthernetSwitch-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-Objekts 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 "Virtueller Switch" 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.

Unbekannt (0)
Nicht verfügbar (1)
Kommunikation OK (2)
Kommunikation verloren (3)
Kein Kontakt (4)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

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_System geerbt und ist immer auf "Msvm_VirtualEthernetSwitch" festgelegt.

Dediziert

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Gibt an, ob es sich bei dem Computersystem um ein Sondersystem (für eine bestimmte Verwendung) handelt und nicht um ein Universellsystem. Diese Eigenschaft wird von CIM_ComputerSystem geerbt und ist immer auf 0 (Nicht dedizierte) festgelegt.

Beschreibung

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt

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

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.

Nicht verfügbar (0)
Keine zusätzlichen Informationen (1)
Gestresst (2)
Vorhersagefehler (3)
Nicht wiederherstellbarer Fehler (4)
Unterstützen von Entitäten im Fehler (5)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

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 ist einer der folgenden Werte.

Aktiviert (2)
Deaktiviert (3)
Aktiviert, aber offline (6)

EnabledState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der aktivierte und deaktivierte Status eines Elements. Diese Eigenschaft kann auch die Übergänge zwischen diesen angeforderten Zuständen angeben. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und immer auf 5 (Nicht zutreffend) festgelegt.

HealthState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Gibt die aktuelle Integrität des Elements an. Dieses Attribut drückt die Integrität dieses Elements aus, aber nicht unbedingt die seiner Unterkomponenten.

Wenn ein kritischer Fehler auftritt, überprüfen Sie das Ereignisprotokoll auf Details. Die EnabledState-Eigenschaft kann auch weitere Informationen enthalten. Wenn beispielsweise der Speicherplatz auf dem Datenträger kritisch niedrig ist, HealthState auf 25 festgelegt ist, wird der virtuelle Computer angehalten, und EnabledState ist auf 32768 (Angehalten) festgelegt.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Wert	Bedeutung
OK 5	Das Element ist voll funktionsfähig und funktioniert innerhalb der normalen Betriebsparameter und ohne Fehler.
Hauptfehler 20	Das Element hat einen großen Fehler erlitten.
Kritischer Fehler 25	Das Element ist nicht funktionsfähig, und die Wiederherstellung ist möglicherweise nicht möglich.

IdentifyingDescriptions

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_ComputerSystem geerbt und immer auf Null festgelegt.

InstallDate

Datentyp: datetime
Zugriffstyp: Schreibgeschützt

Das Datum und die Uhrzeit, zu der die Konfiguration des virtuellen Computers für einen virtuellen Computer erstellt wurde( null) für ein Verwaltungsbetriebssystem. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

InstanceID

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

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

MaxIOVOffloads

Datentyp: uint32
Zugriffstyp: Schreibgeschützt

Die maximale Anzahl der auf diesem Switch verfügbaren virtuellen Funktionen (Single Root E/A Virtualization, SR-IOV).

MaxVMQOffloads

Datentyp: uint32
Zugriffstyp: Lese-/Schreibzugriff

Die maximale Anzahl von VMQ-Auslagerungen (VMQ), die für einen Port auf diesem Switch zulässig sind.

Name

Datentyp: string
Zugriffstyp: Schreibgeschützt

Die Bezeichnung, unter der das Objekt bekannt ist. Diese Eigenschaft wird von CIM_System geerbt und ist immer auf "GUID" festgelegt.

NameFormat

Datentyp: string
Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die angibt, wie der Systemname mithilfe der Unterklassenheuristik generiert wurde. Diese Eigenschaft wird von CIM_ComputerSystem geerbt und immer auf Null festgelegt.

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.

Unbekannt (0)
Nicht verfügbar (1)
Wartung (2)
Ab (3)
Beenden (4)
Beendet (5)
Abgebrochen (6)
Ruhend (7)
Abgeschlossen (8)
Migrieren (9)
Auswandern (10)
Immigrieren (11)
Momentaufnahme (12)
Herunterfahren (13)
In Test (14)
Übergang (15)
Im Dienst (16)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

OperationalStatus

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Ein Array, das die aktuellen Status des Objekts enthält. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

OtherDedicatedDescriptions

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die beschreibt, wie oder warum das System dediziert wird, wenn das Dedizierte Array den Wert 2 (Sonstige) enthält. Diese Eigenschaft wird von CIM_ComputerSystem geerbt und immer auf Null festgelegt.

OtherEnabledState

Datentyp: string
Zugriffstyp: Schreibgeschützt

Der aktivierte oder deaktivierte Status des Elements, 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.

OtherIdentifyingInfo

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_ComputerSystem geerbt und immer auf Null festgelegt.

PowerManagementCapabilities

Datentyp: uint16-Array
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_ComputerSystem geerbt, aber nicht verwendet.

PrimaryOwnerContact

Datentyp: string
Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die angibt, wie der primäre Systembesitzer erreicht werden kann (z. B. eine Telefonnummer oder eine E-Mail-Adresse). Diese Eigenschaft wird von CIM_System geerbt und immer auf Null festgelegt.

PrimaryOwnerName

Datentyp: string
Zugriffstyp: Schreibgeschützt

Der Name des primären Systembesitzers. Diese Eigenschaft wird von CIM_System geerbt und immer auf Null festgelegt.

PrimaryStatus

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

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

Unbekannt (0)
OK (1)
Herabgestuft (2)
Fehler (3)
DMTF Reserviert (..)
Vendor Reserved (0x8000.. )

RequestedState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Der letzte angeforderte oder gewünschte Zustand für das Element, der an die RequestStateChange-Methode übergeben wurde, oder 12 (Nicht zutreffend), wenn keine Zustandsänderung ausgeführt wird. Der tatsächliche Zustand des Elements wird durch EnabledState dargestellt. Diese Eigenschaft wird bereitgestellt, um den zuletzt angeforderten und den aktuellen aktivierten oder deaktivierten Status zu vergleichen. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

ResetCapability

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_ComputerSystem geerbt und immer auf 5 (Nicht implementiert) festgelegt.

Rollen

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt

Ein Array von Zeichenfolgen, die die Rollen beschreiben, die das System in der It-Umgebung spielt. Diese Eigenschaft wird von CIM_System geerbt und immer auf Null festgelegt.

Status

Datentyp: string
Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die die status des Elements angibt. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

StatusBeschreibungen

Datentyp: Zeichenfolgenarray
Zugriffstyp: Schreibgeschützt
Qualifizierer: ArrayType ("indiziert")

Ein Array, das Zeichenfolgen enthält, die die entsprechenden OperationalStatus-Arraywerte beschreiben. Diese Eigenschaft wird von CIM_ManagedSystemElement 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.

TransitioningToState

Datentyp: uint16
Zugriffstyp: Schreibgeschützt

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

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

Share via