Msvm_DiskDrive, classe

  • Article

Représente un disque dur à l’intérieur d’une machine virtuelle. Ce disque dur peut être un périphérique direct (si un disque dur physique a été attaché à la machine virtuelle) ou un périphérique synthétique 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, deux pools de ressources sont associés à cette classe, l’un pour les disques durs pass-through et l’autre pour les disques durs virtuels. Les disques durs ne peuvent être ajoutés ou supprimés du contrôleur SCSI virtuel que lorsque la machine virtuelle est en ligne. Les disques ne peuvent être ajoutés ou supprimés du contrôleur IDE virtuel que lorsque la machine virtuelle est hors connexion.

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_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 a 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.
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_DiskDrive possède ces propriétés.

Disponibilité supplémentaire

Type de données : uint16 array

Type d'accès : Lecture seule

Cette propriété est héritée de CIM_LogicalDevice et 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 : 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.

Capabilities

Type de données : uint16 array

Type d'accès : Lecture seule

Fonctionnalités de l’appareil d’accès au média. Cette propriété est héritée de CIM_MediaAccessDevice et elle est définie sur 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 « Prise en charge de 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 les fonctionnalités d’appareil d’accès 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 Capabilities , situé au même index. Cette propriété est héritée de CIM_MediaAccessDevice.

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

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 non 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_MediaAccessDevice et 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’un 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 CIM_MediaAccessDevice et 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 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

Adresse ou autres informations d’identification permettant de nommer de manière unique l’appareil logique. Cette propriété est héritée de CIM_LogicalDevice.

DriveNumber

Type de données : uint32

Type d'accès : Lecture seule

Nombre de lecteurs physiques sur le système informatique d’hébergement.

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.

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

Valeur Signification
Unknown
0
 Impossible de déterminer l’état de l’élément.
Autres
1
Activé
2
 L’élément est en cours d’exécution.
Désactivé
3
 L’élément est désactivé.
Fermeture
4
 L’élément est en train d’atteindre 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 termine peut-être des commandes, et il supprime toutes les nouvelles demandes.
En test
7
 L’élément est dans un état de test.
Différé
8
 L’élément termine peut-être des commandes, mais il met en file d’attente toutes les nouvelles demandes.
Mettre en suspens
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 il ne traite qu’un ensemble restreint de commandes. Toutes les autres demandes sont mises en file d’attente.
Démarrage en cours
10
 L’élément est en train d’atteindre 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 et de correction d’erreurs pris en charge par cet appareil. Cette propriété est héritée de CIM_MediaAccessDevice et 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 fonctionnel. Cette propriété est héritée de CIM_ManagedSystemElement et 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_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.

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_MediaAccessDevice et est définie sur 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

Temps, 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 (autrement dit, le disque tourne à des vitesses nominales). Pour les lecteurs de bande, il s’agit du moment entre l’injection d’un média et le signalement qu’il est prêt pour une application. Il s’agit généralement de la zone BOT 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

Temps, en millisecondes, pour passer du premier emplacement sur le support à l’emplacement le plus éloigné par rapport à l’heure. Pour un lecteur de disque, cela représente une recherche complète et un délai de rotation complet. Pour les lecteurs de bande, il s’agit d’une recherche 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 ce n’est pas nécessairement vrai.) Cette propriété est héritée de CIM_MediaAccessDevice et est définie sur 0.

MaxBlockSize

Type de données : uint64

Type d'accès : Lecture seule

Taille de bloc maximale, en octets, pour le média accessible par l’appareil. Cette propriété est héritée de CIM_MediaAccessDevice et est définie sur 512 pour les lecteurs de disque dur virtuel, variable pour les lecteurs pass-through.

MaxMediaSize

Type de données : uint64

Type d'accès : Lecture seule

Taille maximale, en kilo-octets, du média pris en charge par cet appareil. Les kilo-octets sont interprétés comme le nombre d’octets multipliés par 1000 (et non le nombre d’octets multiplié par 1024). Cette propriété est héritée de CIM_MediaAccessDevice et est définie sur 2 000 000 000 000 pour les disques durs virtuels, variable pour les lecteurs pass-through.

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

Nombre maximal d’unités pouvant être utilisées avant le nettoyage de l’appareil. Cette propriété est héritée de CIM_MediaAccessDevice et 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_MediaAccessDevice et est définie sur True.

MinBlockSize

Type de données : uint64

Type d'accès : Lecture seule

Taille de bloc minimale, en octets, pour le média accessible par l’appareil. Cette propriété est héritée de CIM_MediaAccessDevice et est définie sur 512.

MountCount

Type de données : uint64

Type d'accès : Lecture seule

Pour un appareil qui prend en charge le support amovible, le nombre de fois que ce média a été monté pour le transfert de données ou pour propre l’appareil. Pour les appareils qui accèdent à des supports 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_MediaAccessDevice et 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 multimédia doit être nettoyé ; sinon, False. Cette propriété est héritée de CIM_MediaAccessDevice et est définie sur False.

NumberOfMediaSupported

Type de données : uint32

Type d'accès : Lecture seule

Nombre maximal de plusieurs supports individuels pouvant être pris en charge ou insérés. Cette propriété est héritée de CIM_MediaAccessDevice et est définie sur 1.

OperatingStatus

Type de données : uint16

Type d'accès : Lecture seule

Fournit des informations de status actuelles sur 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émarrage (3)

Arrêt (4)

Arrêté (5)

Abandonné (6)

Dormant (7)

Terminé (8)

Migration (9)

Emigrating (10)

Immigration (11)

Capture instantanée (12)

Arrêt ( 13)

En 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

É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 et 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_LogicalDevice et 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 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.. )

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. Une instance particulière de CIM_EnabledLogicalElement 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 CIM_EnabledLogicalElement.

Sécurité

Type de données : uint16

Type d'accès : Lecture seule

Sécurité opérationnelle définie pour l’appareil. Cette propriété est héritée de CIM_MediaAccessDevice et est définie sur 3 (Aucun).

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

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 le support amovible, date et heure les plus récentes à laquelle le média a été monté sur l’appareil. Pour les appareils qui accèdent à des supports 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_MediaAccessDevice et est définie sur 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 CIM_EnabledLogicalElement et 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 le support amovible, la durée totale (en secondes) pendant laquelle le média a été monté pour le transfert de données ou pour propre l’appareil. Pour les appareils qui accèdent à des supports 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_MediaAccessDevice et 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 vers lequel le instance effectue la transition. Cette propriété est héritée de CIM_EnabledLogicalElement.

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 taux de données brut soutenu. Les taux maximums ou les taux en supposant que la compression ne doit pas être signalée dans cette propriété. Cette propriété est héritée de CIM_MediaAccessDevice et est définie sur 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_MediaAccessDevice et est définie sur 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_MediaAccessDevice et est définie sur 0.

UnloadTime

Type de données : uint64

Type d'accès : Lecture seule

Temps, en millisecondes, entre la lecture ou l’écriture d’un média et son déchargement. Cette propriété est héritée de CIM_MediaAccessDevice et est définie sur 0.

Notes

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.

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_DiskDrive

CIM_DiskDrive

Classes de stockage