Freigeben über

Msvm_SerialPort-Klasse

  • Artikel

Stellt einen seriellen Port dar, der dem seriellen Controller zugeordnet ist.

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

Syntax

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SerialPort : CIM_LogicalPort
{
  string   InstanceID;
  string   Caption;
  string   Description = "Microsoft Virtual Serial Port";
  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_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_SerialPort";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability = 6;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  uint64   Speed = 115200;
  uint32   MaxSpeed = 115200;
  uint64   RequestedSpeed = 115200;
  uint16   UsageRestriction = 4;
  uint16   PortType = 1;
  string   OtherPortType = "Serial Port";
};

Member

Die Msvm_SerialPort-Klasse verfügt über folgende Membertypen:

Methoden

Die Msvm_SerialPort-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 virtuelle 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_SerialPort-Klasse verfügt über diese Eigenschaften.

Zusätzliche Verfügbarkeit

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Alle zusätzlichen Verfügbarkeiten und status des Geräts. Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

Wert Bedeutung
{ 6 }
6
 Nicht zutreffend

Verfügbarkeit

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

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

Wert Bedeutung
6
 Nicht zutreffend

AvailableRequestedStates

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Gibt die möglichen Werte für den RequestedState-Parameter der RequestStateChange-Methode an. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt, aber nicht verwendet.

Caption

Datentyp: string

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.

Unbekannt (0)

Nicht verfügbar (1)

Kommunikation OK (2)

Verlorene Kommunikation (3)

Kein Kontakt (4)

DMTF Reserviert (..)

Vendor Reserved (0x8000.. )

CreationClassName

Datentyp: string

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: string

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.

Nicht verfügbar (0)

Keine zusätzlichen Informationen (1)

Gestresst (2)

Vorhersagefehler (3)

Nicht wiederherstellbarer Fehler (4)

Unterstützende Entität im Fehler (5)

DMTF Reserviert (..)

Vendor Reserved (0x8000.. )

DeviceID

Datentyp: string

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_LogicalDevice geerbt und auf "Microsoft:GUID\device-specific-data" festgelegt, wobei gerätespezifische Daten optional sind.

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.

Wert Bedeutung
2
 Aktiviert

EnabledState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der aktivierte Zustand des Elements. Es kann auch die Übergänge zwischen diesen angeforderten Zuständen angeben. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Wert Bedeutung
5
 Nicht zutreffend

ErrorCleared

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Gibt an, ob der in der LastErrorCode-Eigenschaft gemeldete Fehler jetzt gelöscht wird. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

ErrorDescription

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die weitere Informationen zu dem in der LastErrorCode-Eigenschaft aufgezeichneten Fehler und Informationen zu etwaigen Korrekturmaßnahmen bereitstellt. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

HealthState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die aktuelle Integrität des Elements. Dies 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.

IdentifyingDescriptions

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Ein Array von Freiformzeichenfolgen, die Erklärungen und Details hinter den Einträgen im OtherIdentifyingInfo-Eigenschaftsarray bereitstellen. Diese Eigenschaft wird von CIM_LogicalDevice geerbt und auf NULL festgelegt.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Das Datum und die Uhrzeit der Erstellung der Konfiguration des virtuellen Computers. 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

Der letzte Fehlercode, der vom logischen Gerät gemeldet wurde. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

MaxQuiesceTime

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft ist veraltet. Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

MaxSpeed

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

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

Name

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

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)

Im Test (14)

Übergang (15)

Im Dienst (16)

DMTF Reserviert (..)

Vendor Reserved (0x8000.. )

OperationalStatus

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Die aktuellen Status des -Objekts. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

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.

OtherIdentifyingInfo

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Alle zusätzlichen Daten, die über Geräte-ID-Informationen hinaus verwendet werden können, um ein logisches Gerät zu identifizieren. Diese Eigenschaft wird von CIM_LogicalDevice geerbt und auf Null festgelegt.

OtherPortType

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Porttype

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_LogicalPort geerbt.

Wert Bedeutung
1
 Sonstiges

PowerManagementCapabilities

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Die Energieverwaltungsfunktionen des Geräts. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

PowerManagementSupported

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Gibt an, ob das Gerät energieverwaltet werden kann. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

PowerOnHours

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Die Anzahl der aufeinanderfolgenden Stunden, die dieses Gerät seit dem letzten Einschalten eingeschaltet wurde. 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 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.. )

RequestedSpeed

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

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

RequestedState

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Der letzte angeforderte oder gewünschte Zustand für das Element. 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.

Wert Bedeutung
12
 Nicht zutreffend

Geschwindigkeit

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

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

Status

Datentyp: string

Zugriffstyp: Schreibgeschützt

Die aktuelle status des -Objekts. Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt, aber nicht verwendet.

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

Der aktuelle Zustand des logischen Geräts. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

SystemCreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Systemname

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der eindeutige Bezeichner für den virtuellen Bereichscomputer. Diese Eigenschaft wird von CIM_LogicalDevice geerbt.

TimeOfLastStateChange

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Das Datum oder die Uhrzeit, zu dem sich der aktivierte Status des Elements zuletzt geändert hat. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt und ist immer auf NULL festgelegt.

TotalPowerOnHours

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Die Gesamtzahl der Stunden, die dieses Gerät mit Strom versorgt hat. 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, aber nicht verwendet.

UsageRestriction

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Unter bestimmten Umständen kann ein logischer Port als Front-End- oder Back-End-Port identifiziert werden. Ein Beispiel für diese Situation wäre ein Speicherarray, das über Back-End-Ports verfügen kann, um mit Datenträgern und Front-End-Ports zu kommunizieren, um mit Hosts zu kommunizieren. Wenn es keine Einschränkung für die Verwendung des Ports gibt, sollte der Wert auf 4 (Nicht eingeschränkt) festgelegt werden. Diese Eigenschaft wird von CIM_LogicalPort geerbt.

Wert Bedeutung
4
 Nicht eingeschränkt

Bemerkungen

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

Anforderungen

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

Siehe auch

CIM_LogicalPort

CIM_LogicalPort

Klassen serieller Geräte