Freigeben über

Msvm_SerialController-Klasse

  • Artikel

Stellt die Funktionen und die Verwaltung des seriellen Controllers dar. Serielle Controller sind logische Geräte, die immer in einem virtuellen Computer vorhanden sind und daher nicht über einen Ressourcenpool zugeordnet werden. Ein serieller Controller instance ist immer auf einem virtuellen Computer vorhanden. Serielle Controller verfügen über eine feste Anzahl von Portinstanzen. Diese Implementierung unterstützt zwei Ports pro Controller.

Hinweis

Serielle Controller sind in virtuellen Computern der Generation 2 optional.

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

Syntax

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SerialController : CIM_SerialController
{
  string   InstanceID;
  string   Caption = "Serial Controller";
  string   Description = "Microsoft Virtual Serial Controller";
  string   ElementName = "Serial Controller";
  datetime InstallDate;
  string   Name = "Serial Controller";
  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_SerialController";
  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;
  datetime TimeOfLastReset;
  uint16   ProtocolSupported = 26;
  uint32   MaxNumberControlled = 2;
  string   ProtocolDescription;
  uint16   Capabilities[] = { 5 };
  string   CapabilityDescriptions[] = { "16550 compatible" };
  uint32   MaxBaudRate = 115200;
  uint16   Security = 3;
};

Member

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

Methoden

Die Msvm_SerialController-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_SerialController-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.

Capabilities

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

Die Pufferung und andere Funktionen des seriellen Controllers, die in der Chiphardware enthalten sein können. Diese Eigenschaft wird von CIM_SerialController geerbt.

CapabilityDescriptions

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Ein Array von Freiformzeichenfolgen, das ausführlichere Erklärungen für alle Funktionen des seriellen Controllers enthält, die im Capabilities-Array angegeben sind. Diese Eigenschaft wird von CIM_SerialController geerbt.

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ützen von Entitäten im Fehler (5)

DMTF Reserviert (..)

Vendor Reserved (0x8000.. )

DeviceID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft wird von CIM_LogicalDevice geerbt und ist immer auf "Microsoft:<GUID>" festgelegt.

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

Die aktivierten und deaktivierten Zustände eines 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 immer 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.

MaxBaudRate

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Die maximale Baudrate in Bits pro Sekunde, die vom seriellen Controller unterstützt wird. Diese Eigenschaft wird von CIM_SerialController geerbt.

MaxNumberControlled

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Die maximale Anzahl direkt adressierbarer Entitäten, die von diesem Controller unterstützt werden. Der Wert 0 sollte verwendet werden, wenn die Zahl unbekannt oder unbegrenzt ist. Das Protokoll, das vom Controller für den Zugriff auf kontrollierte Geräte verwendet wird. Diese Eigenschaft wird von CIM_Controller geerbt.

MaxQuiesceTime

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Diese Eigenschaft ist veraltet. Diese Eigenschaft wird von CIM_LogicalDevice geerbt, aber nicht verwendet.

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

Zugriffstyp: Schreibgeschützt

Der aktivierte oder deaktivierte Zustand des Elements, wenn die EnabledState-Eigenschaft auf 1 (Sonstige) festgelegt ist. Diese Eigenschaft muss auf NULL festgelegt werden, wenn EnabledState ein anderer Wert als 1 ist. 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önnten, um ein logisches Gerät zu identifizieren. Diese Eigenschaft wird von CIM_LogicalDevice geerbt und immer auf NULL festgelegt.

PowerManagementCapabilities

Datentyp: uint16-Array

Zugriffstyp: Schreibgeschützt

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

PowerManagementSupported

Datentyp: Boolesch

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 Netzzyklus 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)

Beeinträchtigt (2)

Fehler (3)

DMTF Reserviert (..)

Vendor Reserved (0x8000.. )

ProtocolDescription

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die weitere Informationen bereitstellt, die sich auf das vom Controller unterstützte Protokoll beziehen. Diese Eigenschaft wird von CIM_Controller geerbt.

ProtocolSupported

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Das Protokoll, das vom Controller für den Zugriff auf kontrollierte Geräte verwendet wird. Diese Eigenschaft wird von CIM_Controller geerbt.

Wert Bedeutung
26
 IEEE-488

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 die zuletzt angeforderten und aktuellen aktivierten oder deaktivierten Zustände zu vergleichen. Diese Eigenschaft wird von CIM_EnabledLogicalElement geerbt.

Wert Bedeutung
12
 Nicht zutreffend

Security

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die Betriebssicherheit für den Controller. Diese Eigenschaft wird von CIM_SerialController geerbt.

Wert Bedeutung
3
 Keine

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

Zugriffstyp: Schreibgeschützt

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

TimeOfLastReset

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Das letzte Mal, wenn der Controller eingeschaltet wurde. Diese Eigenschaft wird von CIM_Controller 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 und immer auf Null festgelegt.

TotalPowerOnHours

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Die Gesamtzahl der Stunden, in denen dieses Gerät eingeschaltet wurde. 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.

Bemerkungen

Der Zugriff auf die Msvm_SerialController-Klasse kann durch 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
 Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Siehe auch

CIM_SerialController

CIM_SerialController

Serielle Geräteklassen