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

Die folgende Syntax ist Managed Object Format (MOF)-Code vereinfacht 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 diese Typen von Membern:

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 Übertragungseinheit (MAXIMUM TRANSMISSION Unit, MTU), die unterstützt werden kann. Diese Eigenschaft wird von CIM _ NetworkPortgeerbt.

AdditionalAvailability

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Zusätzliche Verfügbarkeit und zusätzlicher Status des Geräts, die über die in der Availability-Eigenschaft angegebene hinausgehen. Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt und immer auf 6 (Nicht zutreffend) festgelegt.

Autosense

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Gibt an, ob der Netzwerkport die Geschwindigkeit oder andere Kommunikationsmerkmale der angefügten Netzwerkmedien automatisch bestimmen kann. Diese Eigenschaft wird von CIM _ NetworkPortgeerbt.

Verfügbarkeit

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die primäre Verfügbarkeit und der Status des Geräts. Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt.

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 aufgelisteten Werte sind eine Teilmenge der Werte, die in der RequestedStatesSupported-Eigenschaft der zugeordneten Instanz von CIM _ EnabledLogicalElementCapabilities enthalten sind, wobei die ausgewählten Werte eine Funktion des aktuellen Zustands des CIM _ EnabledLogicalElementsind. Diese Eigenschaft kann ungleich 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 den Satz möglicher Werte nicht als Funktion des aktuellen Zustands bestimmen kann.

Diese Eigenschaft wird von CIM _ EnabledLogicalElementgeerbt.

Aktiviert (2)

Deaktiviert (3)

Herunterfahren (4)

Offline (6)

Test (7)

Zurückstellen (8)

Stille (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 eine Ersatzgruppe (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 bereitstellt, die im Eigenschaftenarray Capabilities angegeben sind. Beachten Sie, dass jeder Eintrag dieses Arrays mit dem Eintrag im Capabilities-Eigenschaftenarray verknüpft ist, das sich am gleichen Index befindet. Diese Eigenschaft wird von CIM _ EthernetPort geerbt und nicht verwendet.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine kurze Beschreibung des -Objekts. Diese Eigenschaft wird von CIM _ ManagedElementgeerbt.

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 _ ManagedSystemElementgeerbt.

CreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Der Name der Klasse oder der Unterklasse, die bei der Erstellung einer Instanz verwendet wird. Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Eine Beschreibung des -Objekts. Diese Eigenschaft wird von CIM _ ManagedElementgeerbt.

DetailedStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Ergänzt die PrimaryStatus-Eigenschaft durch zusätzliche Statusdetails. Ein NULL-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

Deviceid

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

ElementName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Ein Anzeigename für das Objekt. Diese Eigenschaft wird von CIM _ ManagedElementgeerbt.

EnabledCapabilities

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Die Funktionen, die in der Liste aller unterstützten Funktionen aktiviert sind, die im Eigenschaftenarray Capabilities definiert sind. Diese Eigenschaft wird von CIM _ EthernetPortgeerbt, aber nicht verwendet.

EnabledDefault

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die Standard- oder Startkonfiguration eines Administrators für den aktivierten Zustand eines Elements. Diese Eigenschaft wird von CIM _ EnabledLogicalElementgeerbt.

EnabledState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der aktivierte und deaktivierte Status dieses Elements. Diese Eigenschaft wird von CIM _ EnabledLogicalElementgeerbt.

ErrorCleared

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt, aber nicht verwendet.

ErrorDescription

Datentyp: string

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt, aber nicht verwendet.

FullDuplex

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Gibt an, ob der Port im Vollduplexmodus ausgeführt wird. Diese Eigenschaft wird von CIM _ NetworkPortgeerbt.

HealthState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die aktuelle Integrität des Elements. Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

IdentifyingDescriptions

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Ein Array von Freiformzeichenfolgen, die Erklärungen und Details hinter den Einträgen im OtherIdentifyingInfo-Array 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 _ ManagedSystemElementgeerbt.

InstanceID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

Identifiziert eine Instanz dieser Klasse eindeutig. Diese Eigenschaft wird von CIM _ ManagedElementgeerbt.

LastErrorCode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt, aber nicht verwendet.

LinkTechnology

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Eine Enumeration der Typen von Links. Bei Festlegung auf 1 (Other) enthält die zugehörige Eigenschaft OtherLinkTechnology eine Zeichenfolgenbeschreibung des Linktyps. Diese Eigenschaft wird von CIM _ NetworkPortgeerbt.

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 _ EthernetPortgeerbt.

MaxQuiesceTime

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt, 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 _ LogicalPortgeerbt.

Name

Datentyp: string

Zugriffstyp: Schreibgeschützt

Ein Anzeigename für das Objekt. Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

NetworkAddresses

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Ethernet/802.3 MAC-Adressen, die als zwölf Hexadezimalziffern formatiert sind (z. B. "010203040506"), wobei jedes Paar eines der sechs Oktette der MAC-Adresse in kanonischer Bitreihenfolge darstellt (das Gruppenadressbit befindet sich im unteren Bit des ersten Zeichens der Zeichenfolge). Diese Eigenschaft wird von CIM _ EthernetPortgeerbt und nicht verwendet.

OperatingStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Stellt aktuelle Statusinformationen für die Betriebsbedingung des Elements bereit und kann zum Bereitstellen weiterer Details in Bezug auf den Wert der EnabledState-Eigenschaft verwendet werden. Ein NULL-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

OperationalStatus

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Der aktuelle Status des Elements. Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt und 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 bereitstellt, die als "Other" angegeben sind. Diese Eigenschaft wird von CIM _ EthernetPort geerbt und nicht verwendet.

OtherEnabledState

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

OtherIdentifyingInfo

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Alle Daten zusätzlich zu Geräte-ID-Informationen, die zum Identifizieren eines logischen Geräts verwendet werden können. Diese Eigenschaft wird von CIM _ LogicalDevice geerbt und nicht verwendet.

OtherLinkTechnology

Datentyp: string

Zugriffstyp: Schreibgeschützt

Ein Zeichenfolgenwert, der LinkTechnology beschreibt, wenn er auf 1 (Other) festgelegt ist. Diese Eigenschaft wird von CIM _ NetworkPortgeerbt.

OtherNetworkPortType

Datentyp: string

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM _ NetworkPort geerbt und auf NULL festgelegt.

OtherPortType

Datentyp: string

Zugriffstyp: Schreibgeschützt

Der Typ des Moduls, wenn PortType auf 1 (Other) festgelegt ist. Diese Eigenschaft wird von CIM _ LogicalPortgeerbt.

PermanentAddress

Datentyp: string

Zugriffstyp: Schreibgeschützt

Die Netzwerkadresse, die im 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 Eigenschaft PermanentAddress sollte leer gelassen werden, wenn keine hartcodierte Adresse für den Netzwerkadapter vorhanden ist. Diese Eigenschaft wird von CIM _ NetworkPortgeerbt.

Portnumber

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Netzwerkports sind 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 _ NetworkPortgeerbt.

Porttype

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der spezifische Modus, der derzeit für den Port aktiviert ist. Bei Festlegung auf 1 (Other) enthält die verknüpfte Eigenschaft OtherPortType eine Zeichenfolgenbeschreibung des Porttyps. Diese Eigenschaft wird von CIM _ EthernetPortgeerbt.

PowerManagementCapabilities

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt, aber nicht verwendet.

PowerManagementSupported

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt, aber nicht verwendet.

PowerOnHours

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt, aber nicht verwendet.

PrimaryStatus

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Stellt statusinformationen auf hoher Ebene bereit. Diese Eigenschaft sollte in Verbindung mit der DetailedStatus-Eigenschaft verwendet werden, um detaillierte und detaillierte Integritätsstatusinformationen für das Element und seine Unterkomponenten bereitzustellen. Ein NULL-Wert gibt an, dass diese Eigenschaft nicht implementiert ist. Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

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 _ LogicalPortgeerbt.

RequestedState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der zuletzt angeforderte oder gewünschte Zustand für den Verwaltungsdienst. Diese Eigenschaft wird von CIM _ EnabledLogicalElementgeerbt.

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

Der aktuelle Status des Elements. Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.

StatusDescriptions

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-Formular. 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 Instanz übergibt. Diese Eigenschaft wird von CIM _ EnabledLogicalElement geerbt.

UsageRestriction

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

In einigen Fällen kann ein logischer Port als Front-End- oder Back-End-Port identifiziert werden. Wenn die Verwendung des Ports nicht eingeschränkt ist, sollte der Wert auf 4 (Nicht eingeschränkt) festgelegt werden. Diese Eigenschaft wird von CIM _ LogicalPort geerbt.

Hinweise

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

Weitere Informationen

CIM _ EthernetPort

CIM _ EthernetPort