MSVM _ DiskDrive, classe

Représente un lecteur de disque dur à l’intérieur d’une machine virtuelle. Ce lecteur de disque dur peut être un périphérique direct (si un disque dur physique a été attaché à l’ordinateur virtuel) ou un périphérique synthétique qui est rempli avec un support de disque dur virtuel. Étant donné que des disques durs virtuels et physiques peuvent être ajoutés et supprimés de la machine virtuelle, il existe deux pools de ressources associés à cette classe, l’un pour les disques durs directs et l’autre pour les disques durs virtuels. Les disques durs peuvent uniquement être ajoutés ou supprimés du contrôleur SCSI virtuel lorsque l’ordinateur virtuel est en ligne. Les disques peuvent uniquement être ajoutés ou supprimés du contrôleur IDE virtuel lorsque l’ordinateur virtuel est hors connexion.

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_DiskDrive : CIM_DiskDrive
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   CreationClassName;
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  string   ErrorMethodology = "None";
  string   CompressionMethod = "Not Compressed";
  uint32   NumberOfMediaSupported = 1;
  uint64   MaxMediaSize = 2000000000;
  uint64   DefaultBlockSize = 512;
  uint64   MaxBlockSize;
  uint64   MinBlockSize = 512;
  boolean  NeedsCleaning = False;
  boolean  MediaIsLocked = True;
  uint16   Security = 3;
  datetime LastCleaned;
  uint64   MaxAccessTime = 0;
  uint32   UncompressedDataRate;
  uint64   LoadTime = 0;
  uint64   UnloadTime = 0;
  uint64   MountCount = 0;
  datetime TimeOfLastMount;
  uint64   TotalMountTime = 0;
  string   UnitsDescription;
  uint64   MaxUnitsBeforeCleaning = 0xffffffffffffffff;
  uint64   UnitsUsed = 0;
  uint32   DriveNumber;
};

Membres

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

Méthodes

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

Méthode Description
EnableDevice Cette méthode n'est pas prise en charge.
LockMedia Verrouille ou libère le média.
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 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 _ DiskDrive possède les propriétés suivantes.

AdditionalAvailability

Type de données : tableau UInt16

Type d'accès : Lecture seule

Cette propriété est héritée de CIM _ LogicalDeviceet est définie sur 6 (non applicable).

Disponibilité

Type de données : UInt16

Type d'accès : Lecture seule

Cette propriété est héritée de CIM _ LogicalDevice.

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 la _ EnabledLogicalElement CIM.

Capabilities

Type de données : tableau UInt16

Type d'accès : Lecture seule

Fonctionnalités de l’appareil d’accès aux médias. Cette propriété est héritée de la _ MediaAccessDevice CIMet est définie avec les valeurs suivantes.

Valeur Signification
3
L’entrée correspondante dans CapabilityDescriptions est « accès aléatoire ».
4
L’entrée correspondante dans CapabilityDescriptions est « prend en charge l’écriture ».

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 détaillées sur l’accès aux fonctionnalités d’appareil indiquées dans le tableau de propriétés Capabilities . Chaque entrée de ce tableau est liée à l’entrée dans le tableau de propriétés des fonctionnalités , situé dans le même index. Cette propriété est héritée de la _ MediaAccessDevice 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.. )

CompressionMethod

Type de données : chaîne

Type d'accès : Lecture seule

Chaîne qui indique l’algorithme ou l’outil utilisé pour compresser le fichier logique. Si le schéma de compression est inconnu ou n’est pas décrit, utilisez « inconnu ». Si le fichier logique est compressé, mais que le schéma de compression est inconnu ou non décrit, utilisez « compressé ». Si le fichier logique n’est pas compressé, utilisez « non compressé ». Cette propriété est héritée de CIM _ MediaAccessDeviceet est définie sur « non compressé ».

CreationClassName

Type de données : UInt16

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.

DefaultBlockSize

Type de données : UInt64

Type d'accès : Lecture seule

Taille de bloc par défaut, en octets, pour l’appareil. Cette propriété est héritée de la _ MediaAccessDevice CIMet est définie sur 512.

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

Une adresse ou d’autres informations d’identification pour nommer de façon unique l’unité logique. Cette propriété est héritée de CIM _ LogicalDevice.

DriveNumber

Type de données : UInt32

Type d'accès : Lecture seule

Le nombre de lecteurs physiques sur le système de l’ordinateur hôte.

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.

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
Inconnu
0
Impossible de déterminer l’état de l’élément.
Autre
1
Activé
2
L’élément est en cours d’exécution.
Désactivé
3
L’élément est désactivé.
Arrêt
de
4
L’élément est en cours de passage à un état désactivé.
Non applicable
5
L’élément ne prend pas en charge l’activation ou la désactivation.
Activé mais hors connexion
6
L’élément peut exécuter des commandes et supprimer toutes les nouvelles demandes.
Dans le test
7
L’élément est dans un état de test.
Différé
8
L’élément peut exécuter des commandes, mais il met en file d’attente toutes les nouvelles demandes.
Suspension
9
L’élément est activé, mais il est en mode restreint. Le comportement de l’élément est similaire à l’état activé (2), mais ne traite qu’un ensemble restreint de commandes. Toutes les autres demandes sont mises en file d’attente.
À
partir
de
10
L’élément est en train d’accéder à un état activé (2). Les nouvelles demandes sont mises en file d’attente.

ErrorCleared

Type de données : booléen

Type d'accès : Lecture seule

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

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

ErrorMethodology

Type de données : chaîne

Type d'accès : Lecture seule

Chaîne qui décrit les types de détection d’erreurs et de correction pris en charge par cet appareil. Cette propriété est héritée de la _ MediaAccessDevice CIMet est définie sur « None ».

HealthState

Type de données : UInt16

Type d'accès : Lecture seule

Intégrité actuelle de l’élément. Cet attribut 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 _ ManagedSystemElementet est toujours définie sur 5.

IdentifyingDescriptions

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Cette propriété est héritée de CIM _ LogicalDeviceet 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 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.

LastCleaned

Type de données : DateTime

Type d'accès : Lecture seule

Date et heure du dernier nettoyage de l’appareil. Cette propriété est héritée de CIM _ MediaAccessDeviceet a la valeur null.

LastErrorCode

Type de données : UInt32

Type d'accès : Lecture seule

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

LoadTime

Type de données : UInt64

Type d'accès : Lecture seule

Durée, en millisecondes, entre la charge et la possibilité de lire ou d’écrire un média. Par exemple, pour les lecteurs de disque, il s’agit de l’intervalle entre un disque qui ne tourne pas vers le disque signalant qu’il est prêt pour la lecture/écriture (c’est-à-dire le disque tournant à des vitesses nominales). Pour les lecteurs de bande, il s’agit de l’heure à partir d’un support injecté pour signaler qu’il est prêt pour une application. Il s’agit généralement de la zone de robot de la bande. Cette propriété est héritée de CIM _ MediaAccessDevice et est définie sur 0.

MaxAccessTime

Type de données : UInt64

Type d'accès : Lecture seule

Durée, en millisecondes, à passer du premier emplacement sur le média à l’emplacement le plus éloigné par rapport au temps. Pour un lecteur de disque, cela représente une recherche complète et un délai de rotation totale. Pour les lecteurs de bande, il s’agit d’une recherche à partir du début de la bande jusqu’au point le plus éloigné physiquement. (La fin d’une bande peut être à son point le plus éloigné physiquement, mais cela n’est pas nécessairement vrai.) Cette propriété est héritée de CIM _ MediaAccessDeviceet est définie sur 0.

MaxBlockSize

Type de données : UInt64

Type d'accès : Lecture seule

Taille maximale de bloc, en octets, pour les médias accessibles par l’appareil. Cette propriété est héritée de la _ MediaAccessDevice CIMet est définie sur 512 pour les lecteurs de disque dur virtuel, variable pour les lecteurs directs.

MaxMediaSize

Type de données : UInt64

Type d'accès : Lecture seule

Taille maximale, en kilo-octets, des médias pris en charge par cet appareil. Les kilo-octets sont interprétés comme le nombre d’octets multiplié par 1000 (pas le nombre d’octets multiplié par 1024). Cette propriété est héritée de la _ MediaAccessDevice CIMet est définie sur 2 milliards pour les lecteurs de disque dur virtuel, variable pour les lecteurs directs.

MaxQuiesceTime

Type de données : UInt64

Type d'accès : Lecture seule

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

MaxUnitsBeforeCleaning

Type de données : UInt64

Type d'accès : Lecture seule

Unités maximales qui peuvent être utilisées avant le nettoyage de l’appareil. Cette propriété est héritée de CIM _ MediaAccessDeviceet est définie sur 0xFFFFFFFFFFFFFFFF.

MediaIsLocked

Type de données : booléen

Type d'accès : Lecture seule

True si le média est verrouillé dans l’appareil et ne peut pas être éjecté ; Sinon, false. Cette propriété est héritée de CIM _ MediaAccessDeviceet a la valeur true.

MinBlockSize

Type de données : UInt64

Type d'accès : Lecture seule

Taille de bloc minimale, en octets, pour les médias accessibles par l’appareil. Cette propriété est héritée de la _ MediaAccessDevice CIMet est définie sur 512.

MountCount

Type de données : UInt64

Type d'accès : Lecture seule

Pour un appareil qui prend en charge les supports amovibles, le nombre de fois que ces médias ont été montés pour le transfert de données ou pour nettoyer l’appareil. Pour les appareils qui accèdent à des médias non amovibles, tels que des disques durs, cette propriété n’est pas applicable et doit être définie sur 0. Cette propriété est héritée de CIM _ MediaAccessDeviceet est définie sur 0.

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.

NeedsCleaning

Type de données : booléen

Type d'accès : Lecture seule

True si l’appareil d’accès aux médias doit être nettoyé ; Sinon, false. Cette propriété est héritée de CIM _ MediaAccessDeviceet est définie sur false.

NumberOfMediaSupported

Type de données : UInt32

Type d'accès : Lecture seule

Nombre maximal de plusieurs médias individuels qui peuvent être pris en charge ou insérés. Cette propriété est héritée de CIM _ MediaAccessDeviceet est définie sur 1.

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 CIM _ EnabledLogicalElementet est toujours définie sur null.

OtherIdentifyingInfo

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Cette propriété est héritée de CIM _ LogicalDeviceet est définie sur null.

PowerManagementCapabilities

Type de données : tableau UInt16

Type d'accès : Lecture seule

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

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

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

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. Une instance particulière de _ EnabledLogicalElement CIM peut ne pas prendre en charge la méthode RequestStateChange . Si cela se produit, la valeur 12 (non applicable) est utilisée. Cette propriété est héritée de la _ EnabledLogicalElement CIM.

Sécurité

Type de données : UInt16

Type d'accès : Lecture seule

La sécurité opérationnelle définie pour l’appareil. Cette propriété est héritée de la _ MediaAccessDevice CIMet est définie sur 3 (aucune).

État

Type de données : chaîne

Type d'accès : Lecture seule

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

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.

TimeOfLastMount

Type de données : DateTime

Type d'accès : Lecture seule

Pour un appareil qui prend en charge les supports amovibles, la date et l’heure les plus récentes de montage du média sur l’appareil. Pour les appareils qui accèdent à des médias non amovibles, tels que des disques durs, cette propriété n’a aucune signification et n’est pas applicable. Cette propriété est héritée de CIM _ MediaAccessDeviceet a la valeur null.

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 la _ EnabledLogicalElement CIMet est toujours définie sur « null ».

TotalMountTime

Type de données : UInt64

Type d'accès : Lecture seule

Pour un appareil qui prend en charge les supports amovibles, durée totale (en secondes) de montage des médias pour le transfert de données ou le nettoyage de l’appareil. Pour les appareils qui accèdent à des médias non amovibles, tels que des disques durs, cette propriété n’est pas applicable et doit être définie sur 0. Cette propriété est héritée de CIM _ MediaAccessDeviceet est définie sur 0.

TotalPowerOnHours

Type de données : UInt64

Type d'accès : Lecture seule

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 la _ EnabledLogicalElement CIM.

UncompressedDataRate

Type de données : UInt32

Type d'accès : Lecture seule

Taux de transfert de données soutenu, en Ko/s, que l’appareil peut lire et écrire sur un média. Il s’agit d’un débit de données brutes soutenu. Les taux ou taux maximaux en supposant que la compression ne doit pas être signalée dans cette propriété. Cette propriété est héritée de CIM _ MediaAccessDeviceet a la valeur null.

UnitsDescription

Type de données : chaîne

Type d'accès : Lecture seule

Unités relatives à son utilisation dans MaxUnitsBeforeCleaning. Cette propriété est héritée de CIM _ MediaAccessDeviceet a la valeur null.

UnitsUsed

Type de données : UInt64

Type d'accès : Lecture seule

Nombre actuel d’unités utilisées. Cette propriété est héritée de CIM _ MediaAccessDeviceet est définie sur 0.

UnloadTime

Type de données : UInt64

Type d'accès : Lecture seule

Durée, en millisecondes, de la possibilité de lire ou d’écrire un support à son déchargement. Cette propriété est héritée de CIM _ MediaAccessDeviceet est définie sur 0.

Remarques

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

Configuration requise

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

_DISKDRIVE CIM

_DISKDRIVE CIM

Stockage Catégories