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 |
|
| DLL |
|