MSFT_VirtualDisk classe
Représente un volume de stockage de sous-système.
La syntaxe suivante est simplifiée à partir du code MOF (Managed Object Format).
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 les types de membres suivants :
Méthodes
La classe MSFT_VirtualDisk a ces méthodes.
| Méthode | Description |
|---|---|
| AddPhysicalDisk | Ajoute un ou plusieurs disques physiques pour l’allocation manuelle. |
| Joindre | 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 aboutit à un nouveau disque virtuel dont les données sont identiques à celles du disque virtuel d’origine. |
| DeleteObject | Supprime le disque virtuel. |
| Detach | Détache le disque virtuel. |
| GetSecurityDescriptor | Récupère le descripteur de sécurité qui contrôle l’accès à l’objet de disque virtuel instance. |
| Masquer | Masque le disque virtuel. |
| RemovePhysicalDisk | Supprime un ou plusieurs disques physiques de l’allocation manuelle. |
| Repair | Lance une réparation du disque virtuel, en restaurant les 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’objet de disque virtuel instance. |
| SetUsage | Définit l’utilisation prévue pour le disque virtuel. |
| Afficher | Expose le disque virtuel. |
Propriétés
La classe MSFT_VirtualDisk a 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.
Inconnu (0)
Accessible en lecture (1)
Accessible en écriture (2)
Lecture/écriture (3)
Écrire une 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 le ProvisioningType du disque virtuel est fixe, AllocationSize doit avoir la même taille. Si ProvisioningType a la valeur Thin, cette valeur correspond à la quantité d’espace réellement allouée (qui doit être inférieure à Size).
DetachedReason
Type de données : UInt16
Type d'accès : Lecture seule
Raison pour laquelle ce disque virtuel est détaché. Cette propriété est définie uniquement lorsque OperationalStatus du disque virtuel inclut Detached. Notez que ce champ est spécifique aux espaces de stockage.
Inconnu (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 : unités (« octets »)
Capacité totale du pool de stockage, en octets, consommée par ce disque virtuel. Par exemple, dans le cas d’un disque virtuel en miroir 2 voies 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 affichage pouvant être définie par l’utilisateur et contenant le nom du disque virtuel.
HealthStatus
Type de données : UInt16
Type d'accès : Lecture seule
Qualificateurs : Obligatoire
Status 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 de la capacité du disque virtuel à maintenir les niveaux de résilience requis.
| Valeur | Signification |
|---|---|
| Sain 0 | Tous les disques physiques sont présents et dans un état sain. |
| Avertissement 1 | La majorité des disques physiques sont sains, mais un ou plusieurs demandes d’E/S peuvent échouer. |
| 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 | Le status 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 courants de résilience basés sur le striping. La bande est définie comme la taille de la partie d’une bande qui se trouve sur un disque physique. Ainsi, l’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 les boîtiers 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 n’est attaché au système que 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 un cliché instantané d’un autre disque virtuel.
LogicalSectorSize
Type de données : UInt64
Type d'accès : Lecture seule
Qualificateurs : unités (« octets »)
Taille du secteur logique du disque virtuel, en octets.
Nom
Type de données : Chaîne
Type d'accès : Lecture seule
Qualificateurs : obligatoire
Chaîne semi-unique (limitée au sous-système de stockage propriétaire), chaîne lisible par l’utilisateur qui est 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)
Autre (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 des 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 qui sont conservées pour le disque virtuel. Par exemple, RAID 5 conserve une copie des données, tandis que RAID 1 en conserve au moins deux.
OperationalStatus
Type de données : tableau UInt16
Type d'accès : Lecture seule
Tableau de valeurs qui indiquent les conditions de fonctionnement actuelles du disque virtuel. Contrairement à HealthStatus, cette propriété indique la status des problèmes matériels, logiciels et d’infrastructure liés à ce disque virtuel et peut contenir plusieurs valeurs.
| Valeur | Signification |
|---|---|
| Inconnu 0 | Le status opérationnel est inconnu. |
| Autre 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 de fonctionnement normal. |
| Dégradé 3 | Le disque virtuel répond aux commandes, mais ne s’exécute pas dans un état de fonctionnement optimal. |
| Stress 4 | |
| Échec prédictif 5 | |
| Erreur 6 | |
| Erreur non récupérable 7 | |
| À partir de 8 | |
| Arrêt 9 | |
| Arrêté 10 | Le disque virtuel répond aux commandes, mais ne s’exécute pas dans un état de fonctionnement optimal. |
| Dans le service 11 | Le disque virtuel est en cours de configuration, de maintenance, de nettoyage ou d’administration. |
| Aucun contact 12 | |
| Communication perdue 13 | |
| 14 abandonné | |
| Dormant 15 | |
| Entité de prise en charge dans l’erreur 16 | |
| Terminé 17 | |
| Mode Power 18 | |
| Déplacement de 19 | |
| 0xD002 détachés | Cette valeur est réservée à Windows. Disque virtuel visible par le système hôte, mais qui n’a pas d’objet de périphérique de disque. |
| 0xD003 incomplets | Le disque virtuel ne dispose pas de suffisamment de redondance restante pour réparer ou régénérer correctement ses données. |
OtherOperationalStatusDescription
Type de données : Chaîne
Type d'accès : Lecture seule
Si OperationalStatus contient Other, cette propriété est une chaîne contenant le status opérationnel défini par le fournisseur. Cette propriété doit avoir la valeur NULL si OperationalStatus ne contient pas Other.
OtherUsageDescription
Type de données : Chaîne
Type d'accès : Lecture seule
Si la propriété Utilisation du disque virtuel est définie sur Autre, cette propriété doit contenir une description de l’utilisation définie par le fournisseur ou l’utilisateur. Si Utilisation n’est pas défini sur Autre, cette propriété doit avoir la valeur NULL.
ParityLayout
Type de données : UInt16
Type d'accès : Lecture seule
Type de disposition de parité utilisé pour les paramètres de résilience basés sur la parité. Cette propriété doit avoir la valeur NULL si le disque virtuel n’utilise pas de paramètre de résilience basé sur la parité.
Parité non rotative (1)
Parité pivotée (2)
PhysicalDiskRedundancy
Type de données : UInt16
Type d'accès : Lecture seule
Nombre de disques physiques de stockage qui peuvent échouer sans compromettre la redondance des données. Par exemple : RAID 0 ne peut tolérer aucune défaillance, RAID 5 peut tolérer une défaillance d’un seul lecteur et RAID 6 peut tolérer deux défaillances.
PhysicalSectorSize
Type de données : UInt64
Type d'accès : Lecture seule
Qualificateurs : unités (« 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 du 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 sur TRUE pour ne demander aucun point de défaillance unique.
ResiliencySettingName
Type de données : Chaîne
Type d'accès : Lecture seule
Qualificateurs : Obligatoire, ModelCorrespondence {"MSFT_ResiliencySetting.Name"}
Nom du paramètre de résilience pour le 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 String », « 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 le plus élevé disponible selon 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 avoir la valeur 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)
Autre (1)
Sans restriction (2)
Réservé à 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 du disque virtuel.
Remarques
Les disques virtuels sont des unités de stockage utilisable avec un ensemble étendu d’attributs par rapport aux disques physiques. Parmi les autres attributs, citons la résilience et l’extension de capacité dynamique.
Les LUN et les espaces de stockage sont des exemples de disques virtuels.
Lorsqu’ils sont exposés à Windows, les disques virtuels apparaissent en tant que disques (Windows) dans le reste de la pile Windows.
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 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour