Msvm_SyntheticEthernetPort-Klasse

Stellt einen synthetischen Ethernet-Adapter dar. Dieser Adapter ist der bevorzugte Netzwerkadapter aufgrund seiner Leistung und weil Änderungen an ihm sofort wirksam werden können, während er verwendet wird (Hot-Konfigurierbarkeit).

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

Syntax

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SyntheticEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName;
  string   SystemName;
  string   CreationClassName;
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = 6;
  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[];
};

Member

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

• Methoden
• Eigenschaften

Methoden

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

Methode	BESCHREIBUNG
EnableDevice	Diese Methode wird nicht unterstützt.
OnlineGeräte	Diese Methode wird nicht unterstützt.
QuiesceDevice	Diese Methode wird nicht unterstützt.
RequestStateChange	Fordert eine Zustandsänderung an.
Zurücksetzen	Setzt das Gerät zurück.
RestoreProperties	Diese Methode wird nicht unterstützt.
SaveProperties	Diese Methode wird nicht unterstützt.
SetPowerState	Diese Methode wird nicht unterstützt.

Eigenschaften

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

ActiveMaximumTransmissionUnit

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten ("Bytes")

Die aktive oder ausgehandelte maximale Transmission Unit (MTU), die unterstützt werden kann. Diese Eigenschaft wird von CIM_NetworkPort geerbt.

ZusätzlicheVerfügbarkeit

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Zusätzliche Verfügbarkeit und status des Geräts, die über die in der Availability-Eigenschaft angegebenen hinausgehen. Diese Eigenschaft wird von CIM_LogicalDevice geerbt und ist immer auf 6 (nicht zutreffend) festgelegt.

Autosense

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Gibt an, ob der Netzwerkport in der Lage ist, die Geschwindigkeit oder andere Kommunikationseigenschaften der angeschlossenen Netzwerkmedien automatisch zu bestimmen. Diese Eigenschaft wird von CIM_NetworkPort geerbt.

Verfügbarkeit

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die primäre Verfügbarkeit und status des Geräts. Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

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 (.. )

Capabilities

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Die Funktionen des Ethernet-Ports. Das Gerät kann beispielsweise AlertOnLan, WakeOnLan, Lastenausgleich oder FailOver unterstützen. Wenn Failover- oder Lastenausgleichsfunktionen aufgeführt sind, sollte auch ein SpareGroup (Failover) oder ExtraCapacityGroup (Lastenausgleich) definiert werden, um die Funktion vollständig zu beschreiben. Diese Eigenschaft wird von CIM_EthernetPort geerbt und nicht verwendet.

CapabilityDescriptions

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Ein Array von Freiformzeichenfolgen, das ausführlichere Erklärungen für alle EthernetPort-Features bietet, die im Eigenschaftenarray Capabilities angegeben sind. Beachten Sie, dass jeder Eintrag dieses Arrays mit dem Eintrag im Eigenschaftenarray Capabilities verknüpft ist, das sich im selben Index befindet. Diese Eigenschaft wird von CIM_EthernetPort geerbt und nicht verwendet.

Caption

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine kurze Beschreibung des Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

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_LogicalDevice geerbt.

Beschreibung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM_ManagedElement geerbt.

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.

DeviceID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine Adresse oder andere identifizierende Informationen, die zum eindeutigen Benennen des logischen Geräts verwendet werden. Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

ElementName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

EnabledCapabilities

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Die Funktionen, die aus der Liste aller unterstützten funktionen aktiviert werden, die im Eigenschaftenarray Capabilities definiert sind. Diese Eigenschaft wird von CIM_EthernetPort geerbt, aber nicht verwendet.

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.

EnabledState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die aktivierten und deaktivierten Zustände dieses Elements. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

ErrorCleared

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

ErrorDescription

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

FullDuplex

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Gibt an, ob der Port im Vollduplexmodus ausgeführt wird. Diese Eigenschaft wird von CIM_NetworkPort geerbt.

HealthState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die aktuelle Integrität des Elements. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

IdentifyingDescriptions

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Ein Array von Freiformzeichenfolgen, die Erklärungen und Details hinter den Einträgen im Array OtherIdentifyingInfo bereitstellen. Diese Eigenschaft wird von CIM_LogicalDevice geerbt und nicht verwendet.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Das Datum, an dem der Ethernet-Port dem virtuellen Computer hinzugefügt wurde. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

InstanceID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

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

LastErrorCode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

LinkTechnology

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Eine Enumeration der Linktypen. Wenn sie auf 1 (Sonstige) festgelegt ist, enthält die zugehörige Eigenschaft OtherLinkTechnology eine Zeichenfolgenbeschreibung des Linktyps. Diese Eigenschaft wird von CIM_NetworkPort geerbt.

Ethernet (2)

MaxDataSize

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Die maximale Größe des Felds INFO (nicht MAC), das empfangen oder übertragen wird. Diese Eigenschaft wird von CIM_EthernetPort geerbt.

MaxQuiesceTime

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

MaxSpeed

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten ("Bits pro Sekunde")

Die maximale Bandbreite des Ports in Bits pro Sekunde. Diese Eigenschaft wird von CIM_LogicalPort geerbt.

Name

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

NetworkAddresses

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Ethernet/802.3 MAC-Adressen, die als zwölf Hexadezimalstellen formatiert sind (z. B. "010203040506"), wobei jedes Paar eines der sechs Oktette der MAC-Adresse in kanonischer Bitreihenfolge darstellt (das Gruppenadressenbit befindet sich im Bit der niedrigen Reihenfolge des ersten Zeichens der Zeichenfolge). Diese Eigenschaft wird von CIM_EthernetPort 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.

OperationalStatus

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Der aktuelle status des Elements. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt und ist immer auf 2 (OK) festgelegt.

OtherEnabledCapabilities

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Ein Array von Freiformzeichenfolgen, das ausführlichere Erklärungen für alle aktivierten Funktionen bietet, die als "Sonstige" angegeben sind. Diese Eigenschaft wird von CIM_EthernetPort geerbt und nicht verwendet.

OtherEnabledState

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der aktivierte oder deaktivierte Zustand des Elements, wenn die EnabledState-Eigenschaft auf 1 (Sonstige) festgelegt ist. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

OtherIdentifyingInfo

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Alle Daten, zusätzlich zu Geräte-ID-Informationen, die verwendet werden könnten, um ein logisches Gerät zu identifizieren. Diese Eigenschaft wird von CIM_LogicalDevice geerbt und nicht verwendet.

OtherLinkTechnology

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Ein Zeichenfolgenwert, der LinkTechnology beschreibt, wenn er auf 1 (Sonstige) festgelegt ist. Diese Eigenschaft wird von CIM_NetworkPort geerbt.

OtherNetworkPortType

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_NetworkPort geerbt und auf NULL festgelegt.

OtherPortType

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der Modultyp, wenn PortType auf 1 (Sonstige) festgelegt ist. Diese Eigenschaft wird von CIM_LogicalPort geerbt.

PermanentAddress

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Die Netzwerkadresse, die in den Port hartcodiert ist. Diese hartcodierte Adresse kann mithilfe eines Firmwareupgrades oder einer Softwarekonfiguration geändert werden. Wenn diese Änderung vorgenommen wird, sollte das Feld gleichzeitig aktualisiert werden. Die PermanentAddress-Eigenschaft sollte leer bleiben, wenn keine hartcodierte Adresse für den Netzwerkadapter vorhanden ist. Diese Eigenschaft wird von CIM_NetworkPort geerbt.

Portnumber

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Netzwerkports werden häufig relativ zu einem logischen Modul oder einem Netzwerkelement nummeriert. Dieser Wert ist 1 für emulierte NICs, 0 für alle anderen. Diese Eigenschaft wird von CIM_NetworkPort geerbt.

Porttype

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der spezifische Modus, der derzeit für den Port aktiviert ist. Wenn sie auf 1 (Sonstige) festgelegt ist, enthält die zugehörige Eigenschaft OtherPortType eine Zeichenfolgenbeschreibung des Porttyps. Diese Eigenschaft wird von CIM_EthernetPort geerbt.

PowerManagementCapabilities

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

PowerManagementSupported

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

PowerOnHours

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

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.

RequestedSpeed

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten ("Bits pro Sekunde")

Die angeforderte Bandbreite des Ports in Bits pro Sekunde. Die tatsächliche Bandbreite wird in der Speed-Eigenschaft gemeldet. Diese Eigenschaft wird von CIM_LogicalPort geerbt.

RequestedState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der letzte angeforderte oder gewünschte Zustand für den Verwaltungsdienst. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Geschwindigkeit

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten ("Bits pro Sekunde")

Die aktuelle Bandbreite des Ports in Bits pro Sekunde. Für Ports, die in der Bandbreite variieren, oder für Ports, bei denen keine genaue Schätzung vorgenommen werden kann, sollte diese Eigenschaft die nominale Bandbreite enthalten. Diese Eigenschaft wird von CIM_NetworkPort geerbt.

Status

Datentyp: string

Zugriffstyp: Schreibgeschützt

Die aktuelle status des Elements. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

StatusBeschreibungen

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Zeichenfolgen, die die verschiedenen OperationalStatus-Arraywerte beschreiben. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

StatusInfo

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

SupportedMaximumTransmissionUnit

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten ("Bytes")

Die maximale Übertragungseinheit (MTU), die unterstützt werden kann. Diese Eigenschaft wird von CIM_NetworkPort geerbt.

SystemCreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Der Name der Erstellungsklasse des Bereichssystems. Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Systemname

Datentyp: string

Zugriffstyp: Schreibgeschützt

Der NetBIOS-Name des Hostcomputersystems. Diese Eigenschaft enthält die ID des virtuellen Computers im GUID-Format . Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

TimeOfLastStateChange

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Das Datum oder die Uhrzeit der letzten Änderung des aktivierten Zustands des Elements. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

TotalPowerOnHours

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

TransitioningToState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

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

UsageRestriction

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Unter bestimmten Umständen kann ein logischer Port als Front-End- oder Back-End-Port identifiziert werden. Wenn keine Einschränkung für die Verwendung des Ports besteht, sollte der Wert auf 4 (nicht eingeschränkt) festgelegt werden. Diese Eigenschaft wird von CIM_LogicalPort geerbt.

Bemerkungen

Der Zugriff auf die Msvm_SyntheticEthernetPort-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_EthernetPort

CIM_EthernetPort