MSVM _ SerialController, classe

Représente les fonctionnalités et la gestion du contrôleur série. Les contrôleurs série sont des périphériques logiques qui sont toujours présents dans un ordinateur virtuel, et ne sont donc pas alloués par le biais d’un pool de ressources. Une instance de contrôleur série est toujours présente dans un ordinateur virtuel. Les contrôleurs série ont un nombre fixe d’instances de port. Cette implémentation prend en charge deux ports par contrôleur.

Notes

Les contrôleurs série sont facultatifs dans les ordinateurs virtuels de génération 2.

La syntaxe suivante est simplifiée format MOF (MOF) et comprend toutes les propriétés héritées.

Syntaxe

[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;
};

Membres

La classe MSVM _ SerialController possède les types de membres suivants :

Méthodes

La classe MSVM _ SerialController possède ces méthodes.

Méthode Description
EnableDevice Cette méthode n'est pas prise en charge.
OnlineDevice Cette méthode n'est pas prise en charge.
QuiesceDevice Cette méthode n'est pas prise en charge.
RequestStateChange Demande un changement d’État.
Initialisation Réinitialise l’appareil.
RestoreProperties Cette méthode n'est pas prise en charge.
SaveProperties Cette méthode n'est pas prise en charge.
SetPowerState Cette méthode n'est pas prise en charge.

Propriétés

La classe MSVM _ SerialController possède les propriétés suivantes.

AdditionalAvailability

Type de données : tableau UInt16

Type d'accès : Lecture seule

Disponibilité et état supplémentaires de l’appareil. Cette propriété est héritée de CIM _ LogicalDevice.

Valeur Signification
6,3
6
Non applicable

Disponibilité

Type de données : UInt16

Type d'accès : Lecture seule

Disponibilité et état principaux de l’appareil. Cette propriété est héritée de CIM _ LogicalDevice.

Valeur Signification
6
Non applicable

AvailableRequestedStates

Type de données : tableau UInt16

Type d'accès : Lecture seule

Indique les valeurs possibles pour le paramètre RequestedState de la méthode RequestStateChange . Cette propriété est héritée de CIM _ EnabledLogicalElement, mais elle n’est pas utilisée.

Capabilities

Type de données : tableau UInt16

Type d'accès : Lecture seule

La mise en mémoire tampon et d’autres fonctionnalités du contrôleur série qui peuvent être inhérentes au matériel de puce. Cette propriété est héritée de la _ SerialController CIM.

CapabilityDescriptions

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Tableau de chaînes de forme libre qui fournit des explications plus détaillées sur les fonctionnalités du contrôleur série indiquées dans le tableau de fonctionnalités . Cette propriété est héritée de la _ SerialController CIM.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Brève description de l’objet. Cette propriété est héritée de la _ propriété ManagedElement CIM.

CommunicationStatus

Type de données : UInt16

Type d'accès : Lecture seule

Indique la capacité de l’instrumentation à communiquer avec l’élément managé sous-jacent. Une valeur null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM _ ManagedSystemElement.

Inconnu (0)

Non disponible (1)

Communication OK (2)

Communication perdue (3)

Aucun contact (4)

DMTF réservé (..)

Fournisseur réservé (0x8000.. )

CreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Nom de la classe ou de la sous-classe utilisée dans la création d’une instance. Cette propriété est héritée de CIM _ LogicalDevice.

Description

Type de données : chaîne

Type d'accès : Lecture seule

Description de l'objet . Cette propriété est héritée de la _ propriété ManagedElement CIM.

DetailedStatus

Type de données : UInt16

Type d'accès : Lecture seule

Complète la propriété PrimaryStatus avec des détails d’État supplémentaires. Une valeur null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM _ ManagedSystemElement.

Non disponible (0)

Aucune information supplémentaire (1)

Souligné (2)

Défaillance prédictive (3)

Erreur non récupérable (4)

Entité de prise en charge erronée (5)

DMTF réservé (..)

Fournisseur réservé (0x8000.. )

DeviceID

Type de données : chaîne

Type d'accès : Lecture seule

Cette propriété est héritée de CIM _ LogicalDeviceet est toujours définie sur « Microsoft :< > GUID».

ElementName

Type de données : chaîne

Type d'accès : Lecture seule

Nom complet de l’objet. Cette propriété est héritée de la _ propriété ManagedElement CIM.

EnabledDefault

Type de données : UInt16

Type d'accès : Lecture seule

Configuration par défaut ou de démarrage d’un administrateur pour l’état activé d’un élément. Cette propriété est héritée de la _ EnabledLogicalElement CIM.

Valeur Signification
2
activé

EnabledState

Type de données : UInt16

Type d'accès : Lecture seule

États activés et désactivés d’un élément. Il peut également indiquer les transitions entre ces États demandés. Cette propriété est héritée de la _ EnabledLogicalElement CIM.

Valeur Signification
5
Non applicable

ErrorCleared

Type de données : booléen

Type d'accès : Lecture seule

Indique si l’erreur signalée dans la propriété LastErrorCode est maintenant désactivée. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

ErrorDescription

Type de données : chaîne

Type d'accès : Lecture seule

Chaîne qui fournit des informations supplémentaires sur l’erreur enregistrée dans la propriété LastErrorCode et des informations sur toutes les actions correctives qui peuvent être effectuées. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

HealthState

Type de données : UInt16

Type d'accès : Lecture seule

Intégrité actuelle de l’élément. Cela exprime l’intégrité de cet élément, mais pas nécessairement celle de ses sous-composants. Les valeurs possibles sont comprises entre 0 et 30, où 5 signifie que l’élément est entièrement sain et 30 signifie que l’élément est complètement non opérationnel. Cette propriété est héritée de CIM _ ManagedSystemElement.

IdentifyingDescriptions

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Tableau de chaînes de forme libre qui fournissent des explications et des détails sur les entrées du tableau de propriétés OtherIdentifyingInfo . Cette propriété est héritée de CIM _ LogicalDeviceet est toujours définie sur null.

InstallDate

Type de données : DateTime

Type d'accès : Lecture seule

Date et heure de création de la configuration de l’ordinateur virtuel. Cette propriété est héritée de CIM _ ManagedSystemElement.

InstanceID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : clé

Identifie de façon unique une instance de cette classe. Cette propriété est héritée de la _ propriété ManagedElement CIM.

LastErrorCode

Type de données : UInt32

Type d'accès : Lecture seule

Dernier code d’erreur signalé par l’unité logique. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

MaxBaudRate

Type de données : UInt32

Type d'accès : Lecture seule

Débit en bauds maximal, en bits par seconde, pris en charge par le contrôleur série. Cette propriété est héritée de la _ SerialController CIM.

MaxNumberControlled

Type de données : UInt32

Type d'accès : Lecture seule

Nombre maximal d’entités directement adressables qui sont prises en charge par ce contrôleur. La valeur 0 doit être utilisée si le nombre est inconnu ou illimité. Protocole utilisé par le contrôleur pour accéder aux appareils contrôlés. Cette propriété est héritée du _ contrôleur CIM.

MaxQuiesceTime

Type de données : UInt64

Type d'accès : Lecture seule

Cette propriété est dépréciée. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Étiquette par laquelle l’objet est connu. Cette propriété est héritée de CIM _ ManagedSystemElementet est identique à la propriété ElementName .

OperatingStatus

Type de données : UInt16

Type d'accès : Lecture seule

Fournit des informations sur l’état actuel de la condition opérationnelle de l’élément et peut être utilisé pour fournir plus de détails concernant la valeur de la propriété EnabledState . Une valeur null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM _ ManagedSystemElement.

Inconnu (0)

Non disponible (1)

Maintenance (2)

Démarrage (3)

Arrêt (4)

Arrêté (5)

Abandonné (6)

Dormant (7)

Terminé (8)

Migration (9)

Emigrating (10)

Inmigration (11)

Capture d’instantanés (12)

Arrêt (13)

Dans le test (14)

Transition (15)

En service (16)

DMTF réservé (..)

Fournisseur réservé (0x8000.. )

OperationalStatus

Type de données : tableau UInt16

Type d'accès : Lecture seule

États actuels de l’objet. Cette propriété est héritée de CIM _ ManagedSystemElement.

OtherEnabledState

Type de données : chaîne

Type d'accès : Lecture seule

État activé ou désactivé de l’élément lorsque la propriété EnabledState a la valeur 1 (autre). Cette propriété doit avoir la valeur null quand EnabledState a une valeur autre que 1. Cette propriété est héritée de la _ EnabledLogicalElement CIM.

OtherIdentifyingInfo

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Toutes les données supplémentaires, au-delà des informations d’ID d’appareil, qui peuvent être utilisées pour identifier un périphérique logique. Cette propriété est héritée de CIM _ LogicalDeviceet est toujours définie sur null.

PowerManagementCapabilities

Type de données : tableau UInt16

Type d'accès : Lecture seule

Les fonctionnalités de gestion de l’alimentation de l’appareil. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

PowerManagementSupported

Type de données : booléen

Type d'accès : Lecture seule

Indique si l’appareil peut être géré par l’alimentation. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

PowerOnHours

Type de données : UInt64

Type d'accès : Lecture seule

Nombre d’heures consécutives de mise sous tension de cet appareil depuis son dernier cycle d’alimentation. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

PrimaryStatus

Type de données : UInt16

Type d'accès : Lecture seule

Fournit des informations d’état de haut niveau. Cette propriété doit être utilisée conjointement avec la propriété DetailedStatus pour fournir un état d’intégrité élevé et détaillé de l’élément et de ses sous-composants. Une valeur null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM _ ManagedSystemElement.

Inconnu (0)

OK (1)

Détérioré (2)

Erreur (3)

DMTF réservé (..)

Fournisseur réservé (0x8000.. )

ProtocolDescription

Type de données : chaîne

Type d'accès : Lecture seule

Chaîne qui fournit des informations supplémentaires relatives au protocole pris en charge par le contrôleur. Cette propriété est héritée du _ contrôleur CIM.

ProtocolSupported

Type de données : UInt16

Type d'accès : Lecture seule

Protocole utilisé par le contrôleur pour accéder aux appareils contrôlés. Cette propriété est héritée du _ contrôleur CIM.

Valeur Signification
26
IEEE-488

RequestedState

Type de données : UInt16

Type d'accès : Lecture seule

Dernier État demandé ou souhaité pour l’élément. L’état réel de l’élément est représenté par EnabledState. Cette propriété est fournie pour comparer les derniers États activés et actuellement activés ou désactivés. Cette propriété est héritée de la _ EnabledLogicalElement CIM.

Valeur Signification
12
Non applicable

Sécurité

Type de données : UInt16

Type d'accès : Lecture seule

La sécurité opérationnelle pour le contrôleur. Cette propriété est héritée de la _ SerialController CIM.

Valeur Signification
3
Aucun

État

Type de données : chaîne

Type d'accès : Lecture seule

État actuel de l’objet. Cette propriété est héritée de CIM _ ManagedSystemElement, mais elle n’est pas utilisée.

StatusDescriptions

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Chaînes qui décrivent les différentes valeurs de tableau OperationalStatus . Cette propriété est héritée de CIM _ ManagedSystemElement.

StatusInfo

Type de données : UInt16

Type d'accès : Lecture seule

État actuel de l’unité logique. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

SystemCreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Nom de la classe de création du système d’étendue. Cette propriété est héritée de CIM _ LogicalDevice.

SystemName

Type de données : chaîne

Type d'accès : Lecture seule

Identificateur unique de la machine virtuelle d’étendue. Cette propriété est héritée de CIM _ LogicalDevice.

TimeOfLastReset

Type de données : DateTime

Type d'accès : Lecture seule

La dernière fois que le contrôleur a été mis sous tension. Cette propriété est héritée du _ contrôleur CIM.

TimeOfLastStateChange

Type de données : DateTime

Type d'accès : Lecture seule

Date ou heure de la dernière modification de l’état activé de l’élément. Cette propriété est héritée de CIM _ EnabledLogicalElementet est toujours définie sur null.

TotalPowerOnHours

Type de données : UInt64

Type d'accès : Lecture seule

Nombre total d’heures d’alimentation de cet appareil. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

TransitioningToState

Type de données : UInt16

Type d'accès : Lecture seule

Indique l’État cible de la transition de l’instance. Cette propriété est héritée de CIM _ EnabledLogicalElement, mais elle n’est pas utilisée.

Remarques

L’accès à la classe MSVM _ SerialController peut être limité par le filtrage UAC. Pour plus d’informations, consultez contrôle de compte d’utilisateur et WMI.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 8 [ applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2012 [ applications de bureau uniquement]
Espace de noms
\Virtualisation racine \ v2
MOF
WindowsVirtualization. v2. mof
DLL
Vmms.exe

Voir aussi

_SERIALCONTROLLER CIM

_SERIALCONTROLLER CIM

Classes d’appareils série