classe MSFT_VirtualDisk
Représente un volume de stockage du sous-système.
La syntaxe suivante est simplifiée à partir du code du format d’objet géré (MOF).
Syntaxe
class MSFT_VirtualDisk : MSFT_StorageObject
{
String FriendlyName;
String Name;
UInt16 NameFormat;
UInt16 UniqueIdFormat;
String UniqueIdFormatDescription;
UInt16 Usage;
String OtherUsageDescription;
UInt16 HealthStatus;
UInt16 OperationalStatus[];
String OtherOperationalStatusDescription;
String ResiliencySettingName;
UInt64 Size;
UInt64 AllocatedSize;
UInt64 LogicalSectorSize;
UInt64 PhysicalSectorSize;
UInt64 FootprintOnPool;
UInt16 ProvisioningType;
UInt16 NumberOfDataCopies;
UInt16 PhysicalDiskRedundancy;
UInt16 ParityLayout;
UInt16 NumberOfColumns;
UInt64 Interleave;
Boolean RequestNoSinglePointOfFailure;
UInt16 Access;
Boolean IsSnapshot;
Boolean IsManualAttach;
Boolean IsDeduplicationEnabled;
Boolean IsEnclosureAware;
UInt16 NumberOfAvailableCopies;
UInt16 DetachedReason;
UInt64 WriteCacheSize;
};
Membres
La classe MSFT_VirtualDisk a ces types de membres :
Méthodes
La classe MSFT_VirtualDisk a ces méthodes.
| Méthode | Description |
|---|---|
| AddPhysicalDisk | Ajoute un ou plusieurs disques physiques pour l’allocation manuelle. |
| Attacher | Attache le disque virtuel. |
| CreateClone | Crée un disque virtuel qui est un clone du disque virtuel existant. |
| CreateReplica | Crée une relation de réplication entre les disques virtuels. |
| CreateSnapshot | Crée un clone d’un disque virtuel, ce qui entraîne un nouveau disque virtuel dont les données sont identiques à celles du disque virtuel d’origine. |
| DeleteObject | Supprime le disque virtuel. |
| Détacher | Détache le disque virtuel. |
| GetSecurityDescriptor | Récupère le descripteur de sécurité qui contrôle l’accès à l’instance d’objet disque virtuel. |
| Hide | Masque le disque virtuel. |
| RemovePhysicalDisk | Supprime un ou plusieurs disques physiques de l’allocation manuelle. |
| Repair | Lance une réparation du disque virtuel, la restauration des données et la redondance sur des disques physiques différents (ou nouveaux) au sein du pool de stockage. |
| Redimensionner | Redimensionne le disque virtuel. |
| SetAttributes | Définit ou met à jour différents attributs pour le disque virtuel. |
| SetFriendlyName | Définit le nom convivial du disque virtuel. |
| SetReplicationRelationship | Définit la relation de réplication entre les disques virtuels. |
| SetSecurityDescriptor | Définit le descripteur de sécurité qui contrôle l’accès à l’instance d’objet disque virtuel. |
| SetUsage | Définit l’utilisation prévue pour le disque virtuel. |
| Afficher | Expose le disque virtuel. |
Propriétés
La classe MSFT_VirtualDisk possède ces propriétés.
y accéder
Type de données : UInt16
Type d’accès : Lecture seule
Indique si le disque virtuel est disponible pour l’accès en lecture et en écriture.
Unknown (0)
Lisible (1)
Accessible en écriture (2)
Lecture/écriture (3)
Écrire une seule fois (4)
AllocatedSize
Type de données : UInt64
Type d’accès : Lecture seule
Qualificateurs : Obligatoire, Unités (« Octets »)
Taille actuellement allouée du disque virtuel. Si l’approvisionnementType du disque virtuel est fixe, AllocationSize doit être de taille égale. Si ProvisioningType est Thin, cette valeur correspond à la quantité d’espace réellement allouée (qui doit être inférieure à La taille).
DetachedReason
Type de données : UInt16
Type d’accès : Lecture seule
La raison pour laquelle ce disque virtuel est détaché. Cette propriété ne sera définie que lorsque OperationalStatus du disque virtuel inclut Détaché. Notez que ce champ est spécifique aux espaces de stockage.
Unknown (0)
Aucun (1)
Par stratégie (2)
Disques majoritaires non sains (3)
Incomplet (4)
FootprintOnPool
Type de données : UInt64
Type d'accès : Lecture seule
Qualificateurs : Units (« Octets »)
Capacité totale du pool de stockage, en octets, consommée par ce disque virtuel. Par exemple, dans le cas d’un disque virtuel mis en miroir de 2 manières dont la taille est de 1 Go, l’encombrement dans le pool serait d’environ 2 Go.
FriendlyName
Type de données : Chaîne
Type d’accès : Lecture seule
Qualificateurs : obligatoire
Chaîne orientée utilisateur qui contient le nom du disque virtuel.
HealthStatus
Type de données : UInt16
Type d’accès : Lecture seule
Qualificateurs : obligatoire
État d’intégrité du disque virtuel.
L’intégrité d’un disque virtuel est dérivée de l’intégrité des disques physiques de stockage, et indique si le disque virtuel peut conserver les niveaux de résilience requis.
| Valeur | Signification |
|---|---|
| Sain 0 | Tous les disques physiques sont présents et en bon état. |
| Avertissement 1 | La majorité des disques physiques sont en bon état, mais un ou plusieurs peuvent échouer dans les demandes d’E/S. |
| Non sain 2 | La majorité des disques physiques sont défectueux ou dans un état d’échec, et le disque virtuel n’a plus d’intégrité des données. |
| Inconnu 5 | L’état d’intégrité est inconnu. |
Interleave
Type de données : UInt64
Type d’accès : Lecture seule
Nombre d’octets qui formeront une bande dans les paramètres de résilience basés sur les bandes courants. La bande est définie comme la taille de la partie d’une bande qui se trouve sur un disque physique. Ainsi, Interleave * NumberOfColumns génère la taille d’une bande de données utilisateur.
IsDeduplicationEnabled
Type de données : booléen
Type d’accès : lecture/écriture
TRUE si la déduplication des données est activée pour le disque virtuel.
IsEnclosureAware
Type de données : booléen
Type d’accès : Lecture seule
Comportement d’allocation actuel pour ce disque virtuel. Les disques virtuels prenant en charge le boîtier sélectionnent intelligemment les disques physiques à utiliser pour leur redondance. Si la valeur est TRUE, le disque virtuel tente d’utiliser des disques physiques provenant de différents boîtiers pour équilibrer la tolérance de panne entre deux boîtiers physiques ou plus.
IsManualAttach
Type de données : booléen
Type d’accès : lecture/écriture
TRUE si ce disque virtuel est attaché uniquement au système si un appel explicite est effectué à la méthode Attach . Notez que cette propriété est spécifique aux espaces de stockage.
IsSnapshot
Type de données : booléen
Type d’accès : Lecture seule
TRUE si ce disque virtuel est une cliché instantané d’un autre disque virtuel.
LogicalSectorSize
Type de données : UInt64
Type d'accès : Lecture seule
Qualificateurs : Units (« Octets »)
Taille du secteur logique du disque virtuel, en octets.
Nom
Type de données : String
Type d’accès : Lecture seule
Qualificateurs : obligatoire
Chaîne semi-unique (délimitée au sous-système de stockage propriétaire), chaîne lisible par l’homme utilisée pour identifier le disque virtuel.
NameFormat
Type de données : UInt16
Type d’accès : Lecture seule
Qualificateurs : obligatoire
Format de la propriété Name .
Inconnu (0)
Other (1)
VPD83NAA6 (2)
VPD83NAA5 (3)
VPD83Type2 (4)
VPD83Type1 (5)
VPD83Type0 (6)
SNVM (7)
NodeWWN (8)
NAA (9)
EUI64 (10)
T10VID (11)
NumberOfAvailableCopies
Type de données : UInt16
Type d’accès : Lecture seule
Nombre de copies cohérentes de données disponibles.
NumberOfColumns
Type de données : UInt16
Type d’accès : Lecture seule
Nombre de disques physiques sous-jacents sur lesquels les données de ce disque virtuel sont réparties.
NumberOfDataCopies
Type de données : UInt16
Type d’accès : Lecture seule
Nombre de copies de données complètes conservées pour le disque virtuel. Par exemple, RAID 5 conserve une copie de données, tandis que RAID 1 conserve au moins deux copies.
OperationalStatus
Type de données : UInt16 tableau
Type d’accès : Lecture seule
Tableau de valeurs qui indiquent les conditions d’exploitation actuelles du disque virtuel. Contrairement à HealthStatus, cette propriété indique l’état du matériel, des logiciels et des problèmes d’infrastructure liés à ce disque virtuel et peut contenir plusieurs valeurs.
| Valeur | Signification |
|---|---|
| Inconnu 0 | Le statut opérationnel est inconnu. |
| Autres 1 | Un OperationalStatus spécifique au fournisseur a été spécifié en définissant la propriété OtherOperationalStatusDescription. |
| OK 2 | Le disque virtuel répond aux commandes et est dans un état d’exploitation normal. |
| Détérioré 3 | Le disque virtuel répond aux commandes, mais n’est pas en cours d’exécution dans un état d’exploitation optimal. |
| Stressé 4 | |
| Échec prédictif 5 | |
| Erreur 6 | |
| Erreur non récupérable 7 | |
| À partir de 8 | |
| Arrêt de 9 | |
| Arrêté 10 | Le disque virtuel répond aux commandes, mais n’est pas en cours d’exécution dans un état d’exploitation optimal. |
| Dans le service 11 | Le disque virtuel est en cours de configuration, de maintenance, de nettoyage ou d’administration. |
| Aucun contact 12 | |
| Perte de communication 13 | |
| Abandonné 14 | |
| Dormant 15 | |
| Prise en charge de l’entité dans l’erreur 16 | |
| Terminé 17 | |
| Mode d’alimentation 18 | |
| Déplacement de 19 | |
| 0xD002 détaché | Cette valeur est réservée à Windows. Disque virtuel visible par le système hôte, mais qui n’a pas d’objet d’appareil de disque. |
| 0xD003 incomplet | Le disque virtuel n’a pas suffisamment de redondance pour réparer ou régénérer correctement ses données. |
OtherOperationalStatusDescription
Type de données : String
Type d’accès : Lecture seule
Si OperationalStatus contient Other, cette propriété est une chaîne contenant l’état opérationnel défini par le fournisseur. Cette propriété doit être NULL si OperationalStatus ne contient pas Other.
OtherUsageDescription
Type de données : String
Type d’accès : Lecture seule
Si la propriété Utilisation du disque virtuel est définie sur Other, cette propriété doit contenir une description de l’utilisation définie par le fournisseur ou l’utilisateur. Si l’utilisation n’est pas définie sur Other, cette propriété doit être NULL.
ParitéLayout
Type de données : UInt16
Type d’accès : Lecture seule
Type de disposition de parité utilisée pour les paramètres de résilience basés sur la parité. Cette propriété doit être NULL si le disque virtuel n’utilise pas de paramètre de résilience basé sur la parité.
Parité non pivotée (1)
Parité pivotée (2)
PhysicalDiskRedundancy
Type de données : UInt16
Type d’accès : Lecture seule
Nombre de disques physiques de stockage pouvant échouer sans compromettre la redondance des données. Par exemple : RAID 0 ne peut tolérer aucun échec, RAID 5 peut tolérer une défaillance de lecteur unique, et RAID 6 peut tolérer deux défaillances.
PhysicalSectorSize
Type de données : UInt64
Type d'accès : Lecture seule
Qualificateurs : Units (« Octets »)
Taille du secteur physique du disque virtuel, en octets.
ProvisioningType
Type de données : UInt16
Type d’accès : Lecture seule
Qualificateurs : obligatoire
Schéma d’approvisionnement pour le disque virtuel.
| Valeur | Signification |
|---|---|
| Inconnu 0 | Le schéma d’approvisionnement est inconnu. |
| Mince 1 | La capacité du disque virtuel est allouée à la demande. |
| Correction 2 | La capacité du disque virtuel est entièrement allouée au moment de la création. |
RequestNoSinglePointOfFailure
Type de données : booléen
Type d’accès : Lecture seule
Définissez la valeur TRUE pour demander aucun point de défaillance unique.
ResiliencySettingName
Type de données : Chaîne
Type d’accès : Lecture seule
Qualificatifs : Required, ModelCorrespondence {"MSFT_ResiliencySetting.Name"}
Nom du paramètre de résilience du disque virtuel.
Taille
Type de données : UInt64
Type d’accès : Lecture seule
Qualificateurs : Obligatoire, Unités (« Octets »)
Taille logique, en octets, du disque virtuel.
UniqueIdFormat
Type de données : UInt16
Type d’accès : Lecture seule
Qualificateurs : Obligatoire, Valeurs ( « Vendor Specific », « Vendor Id », « EUI64 », « FCPH Name », « SCSI Name String », ValueMap (« 0 », « 1 », « 2 », « 3 », « 8 »), ModelCorrespondence {"MSFT_StorageObject.UniqueId"}
Type d’identificateur utilisé dans la propriété UniqueId que cette classe hérite de la classe MSFT_StorageObject . Cet identificateur doit être l’identificateur disponible le plus élevé à l’aide de l’ordre de préférence suivant : 8 (le plus élevé), 3, 2, 1, 0 (le plus bas).
Par exemple, si l’appareil de disque virtuel expose des identificateurs de type 0, 1 et 3, UniqueId doit être l’identificateur de type 3, et UniqueIdFormat doit être défini sur 3.
UniqueIdFormatDescription
Type de données : Chaîne
Type d’accès : Lecture seule
Qualificateurs : ModelCorrespondence {"MSFT_StorageObject.UniqueId"}, ModelCorrespondence {"MSFT_VirtualDisk.UniqueIdFormat"}
Certaines valeurs pour UniqueIdFormat peuvent inclure différents sous-formats. Cette propriété est une chaîne de forme libre utilisée pour décrire le format spécifique utilisé dans UniqueId.
Utilisation
Type de données : UInt16
Type d’accès : lecture/écriture
Qualificateurs : obligatoire
Utilisation prévue pour ce disque virtuel.
Inconnu (0)
Other (1)
Unrestricted (2)
Réservé pour ComputerSystem (le serveur de blocs) (3)
Réservé par les services de réplication (4)
Réservé par Migration Services (5)
Source de réplica local (6)
Source de réplica distant (7)
Cible de réplica local (8)
Cible de réplica distant (9)
Source ou cible du réplica local (10)
Source ou cible du réplica distant (11)
Cible de réplica delta (12)
Composant d’élément (13)
Réservé en tant que contributeur de pool (14)
Membre de volume composite (15)
Membre VirtualDisk composite (16)
Réservé à l’sparing (17)
WriteCacheSize
Type de données : UInt64
Type d’accès : Lecture seule
Taille du cache d’écriture pour le disque virtuel.
Notes
Les disques virtuels sont des unités de stockage utilisables avec un ensemble étendu d’attributs par rapport aux disques physiques. Parmi les attributs supplémentaires, citons la résilience et l’extension de capacité dynamique.
Les unités logiques et les espaces de stockage sont des exemples de disques virtuels.
Les disques virtuels, lorsqu’ils sont exposés à Windows, apparaissent sous forme de disques (Windows) dans le reste de la pile Windows.
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\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |