Partager via

classe Msvm_SerialPort

  • Article

Représente un port série associé au contrôleur série.

La syntaxe suivante est le code MOF (Managed Object Format) simplifié et inclut toutes les propriétés héritées.

Syntaxe

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

Membres

La classe Msvm_SerialPort a les types de membres suivants :

Méthodes

La classe Msvm_SerialPort a 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.
Réinitialiser Réinitialise l’appareil virtuel.
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_SerialPort possède ces propriétés.

Disponibilité supplémentaire

Type de données : uint16 array

Type d'accès : Lecture seule

Toute disponibilité et status supplémentaires de l’appareil. Cette propriété est héritée de CIM_LogicalDevice.

Valeur Signification
{ 6 }
6
 Non applicable

Disponibilité

Type de données : uint16

Type d'accès : Lecture seule

Disponibilité principale et status de l’appareil. Cette propriété est héritée de CIM_LogicalDevice.

Valeur Signification
6
 Non applicable

AvailableRequestedStates

Type de données : uint16 array

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.

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 CIM_ManagedElement.

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’un 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 CIM_ManagedElement.

DetailedStatus

Type de données : uint16

Type d'accès : Lecture seule

Complète la propriété PrimaryStatus avec des détails status 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)

Stressé (2)

Échec prédictif (3)

Erreur non récupérable (4)

Entité de prise en charge dans l’erreur (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_LogicalDevice et est définie sur « Microsoft:GUID\device-specific-data », où les données spécifiques à l’appareil sont facultatives.

ElementName

Type de données : chaîne

Type d'accès : Lecture seule

Nom d’affichage de l’objet. Cette propriété est héritée de CIM_ManagedElement.

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 CIM_EnabledLogicalElement.

Valeur Signification
2
 activé

EnabledState

Type de données : uint16

Type d'accès : Lecture seule

État activé de l’élément. Il peut également indiquer les transitions entre ces états demandés. Cette propriété est héritée de CIM_EnabledLogicalElement.

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 effacé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 plus d’informations sur l’erreur enregistrée dans la propriété LastErrorCode et des informations sur 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 de 0 à 30, où 5 signifie que l’élément est entièrement sain et 30 signifie que l’élément est complètement non fonctionnel. 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 derrière les entrées dans le tableau de propriétés OtherIdentifyingInfo . Cette propriété est héritée de CIM_LogicalDevice et est 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 la machine virtuelle. 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 manière unique un instance de cette classe. Cette propriété est héritée de CIM_ManagedElement.

LastErrorCode

Type de données : uint32

Type d'accès : Lecture seule

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

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.

Maxspeed

Type de données : uint32

Type d'accès : Lecture seule

Bande passante maximale du port, en bits par seconde. Cette propriété est héritée de CIM_LogicalPort.

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_ManagedSystemElement et elle est identique à la propriété ElementName .

OperatingStatus

Type de données : uint16

Type d'accès : Lecture seule

Fournit des informations status actuelles pour la condition opérationnelle de l’élément et peut être utilisée 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ébut (3)

Arrêt (4)

Arrêté (5)

Abandonné (6)

Dormant (7)

Terminé (8)

Migration (9)

Émigrant (10)

Immigrer (11)

Capture instantanée (12)

Arrêt ( 13)

Dans Test (14)

Transition ( 15)

En service (16)

DMTF Reserved (..)

Fournisseur réservé (0x8000.. )

OperationalStatus

Type de données : tableau uint16

Type d'accès : Lecture seule

État actuel 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

Chaîne qui décrit l’é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 lorsque EnabledState a une valeur autre que 1. Cette propriété est héritée de CIM_EnabledLogicalElement.

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 appareil logique. Cette propriété est héritée de CIM_LogicalDevice et est définie sur Null.

OtherPortType

Type de données : chaîne

Type d'accès : Lecture seule

Type de module, lorsque PortType est défini sur 1 (Autre). Cette propriété est héritée de CIM_LogicalPort.

Porttype

Type de données : uint16

Type d'accès : Lecture seule

Cette propriété est héritée de CIM_LogicalPort.

Valeur Signification
1
 Autres

PowerManagementCapabilities

Type de données : tableau uint16

Type d'accès : Lecture seule

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 pendant lesquelles cet appareil a été mis sous tension 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 de status de haut niveau. Cette propriété doit être utilisée conjointement avec la propriété DetailedStatus pour fournir un status d’intégrité de haut niveau 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 Reserved (..)

Fournisseur réservé (0x8000.. )

RequestedSpeed

Type de données : uint64

Type d'accès : Lecture seule

Bande passante demandée du port, en bits par seconde. Cette propriété est héritée de CIM_LogicalPort.

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 demandés et activés ou désactivés actuels. Cette propriété est héritée de CIM_EnabledLogicalElement.

Valeur Signification
12
 Non applicable

Vitesse

Type de données : uint64

Type d'accès : Lecture seule

Bande passante du port, en bits par seconde. Cette propriété est héritée de CIM_LogicalPort.

État

Type de données : chaîne

Type d'accès : Lecture seule

Status actuelle 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 du 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’appareil 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.

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_EnabledLogicalElement et est toujours définie sur Null.

TotalPowerOnHours

Type de données : uint64

Type d'accès : Lecture seule

Nombre total d’heures pendant lesquelles cet appareil a été alimenté. 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 vers lequel le instance effectue la transition. Cette propriété est héritée de CIM_EnabledLogicalElement, mais elle n’est pas utilisée.

UsageRestriction

Type de données : uint16

Type d'accès : Lecture seule

Dans certains cas, un port logique peut être identifiable en tant que port frontal ou principal. Un exemple de cette situation est un tableau de stockage qui peut avoir des ports back-end pour communiquer avec les lecteurs de disque et des ports frontaux pour communiquer avec les hôtes. S’il n’existe aucune restriction sur l’utilisation du port, la valeur doit être définie sur 4 (non restreint). Cette propriété est héritée de CIM_LogicalPort.

Valeur Signification
4
 Non restreint

Notes

L’accès à la classe Msvm_SerialPort peut être limité par le filtrage de contrôle d’utilisateur. 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
 Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Voir aussi

CIM_LogicalPort

CIM_LogicalPort

Classes d’appareils série