classe MSFT_PhysicalDisk
Représente un lecteur ou une broche de sous-système.
La syntaxe suivante est simplifiée à partir du code MOF (Managed Object Format).
Syntaxe
class MSFT_PhysicalDisk : MSFT_StorageFaultDomain
{
UInt16 UniqueIdFormat;
String DeviceId;
String FriendlyName;
UInt16 HealthStatus;
UInt16 OperationalStatus[];
String OperationalDetails[];
String PhysicalLocation;
UInt16 VirtualDiskFootprint;
UInt16 Usage;
UInt16 SupportedUsages[];
String Description;
String PartNumber;
String FirmwareVersion;
String SoftwareVersion;
UInt64 Size;
UInt64 AllocatedSize;
UInt16 BusType;
Boolean IsWriteCacheEnabled;
Boolean IsPowerProtected;
UInt64 PhysicalSectorSize;
UInt64 LogicalSectorSize;
UInt32 SpindleSpeed;
Boolean IsIndicationEnabled;
UInt16 EnclosureNumber;
UInt16 SlotNumber;
Boolean CanPool;
UInt16 CannotPoolReason[];
String OtherCannotPoolReasonDescription;
Boolean IsPartial;
UInt16 MediaType;
};
Membres
La classe MSFT_PhysicalDisk a les types de membres suivants :
Méthodes
La classe MSFT_PhysicalDisk possède ces méthodes.
| Méthode | Description |
|---|---|
| Maintenance | Permet d’effectuer des opérations de maintenance sur le disque physique dans un pool concret, comme les mises à jour du microprogramme. |
| Réinitialiser | Réinitialise le disque physique. |
| SetAttributes | Mises à jour les attributs du disque physique. |
| SetDescription | Définit ou modifie la description du disque physique. |
| SetFriendlyName | Définit ou modifie le nom convivial du disque physique. |
| SetUsage | Définit ou modifie l’utilisation prévue pour le disque physique au sein d’un pool concret. |
| SetWriteCache | Permet d’activer ou de désactiver le cache d’écriture du disque physique. |
Propriétés
La classe MSFT_PhysicalDisk possède ces propriétés.
AllocatedSize
Type de données : UInt64
Type d'accès : Lecture seule
Qualificateurs : unités (« octets »)
Quantité totale d’espace utilisé sur ce disque physique. Cela doit inclure l’utilisation de tous les pools de stockage et d’autres données stockées sur le disque.
BusType
Type de données : UInt16
Type d'accès : Lecture seule
Qualificateurs : obligatoire
Type de bus de stockage du disque physique.
| Valeur | Signification |
|---|---|
| Inconnu 0 | Le type de bus est inconnu. |
| SCSI 1 | SCSI |
| ATAPI 2 | ATAPI |
| ATA 3 | ATA |
| 1394 4 | IEEE 1394 |
| SSA 5 | SSA |
| Fibre Channel 6 | Fibre Channel |
| USB 7 | USB |
| RAID 8 | RAID |
| iSCSI 9 | iSCSI |
| SAS 10 | Serial Attached SCSI (SAS) |
| SATA 11 | Serial ATA (SATA) |
| SD 12 | Secure Digital (SD) |
| MMC 13 | Carte multimédia (MMC) |
| MAX 14 | L’utilisation de cette valeur est réservée au système. |
| Fichier Sauvegardé Virtual 15 | File-Backed Virtual |
| espaces de stockage 16 | Espaces de stockage |
| NVMe 17 | |
| Microsoft Reserved 18.. | L’utilisation de cette valeur est réservée au système. |
CannotPoolReason
Type de données : tableau UInt16
Type d'accès : Lecture seule
Qualificateurs : obligatoire
Tableau de valeurs spécifiant les raisons pour lesquelles ce disque physique ne peut pas être ajouté à un pool concret. Cette propriété n’est valide que si la propriété CanPool a la valeur FALSE.
Inconnu (0)
Autre (1)
Dans un pool (2)
Non sain (3)
Média amovible (4)
Dans Utilisation par cluster (5)
Hors connexion (6)
Capacité insuffisante (7)
Disque de rechange (8)
Réservé par le sous-système (9)
Début (10)
Microsoft Réservé (..)
Fournisseur réservé (0x8000..)
CanPool
Type de données : Boolean
Type d'accès : Lecture seule
Qualificateurs : Obligatoire
TRUE si ce disque physique peut être ajouté à un pool concret.
Description
Type de données : Chaîne
Type d'accès : Lecture seule
Description du disque physique pouvant être définie par l’utilisateur.
DeviceId
Type de données : Chaîne
Type d'accès : Lecture seule
Adresse ou autre identificateur qui nomme de manière unique le disque physique.
EnclosureNumber
Type de données : UInt16
Type d'accès : Lecture seule
Numéro du boîtier dans lequel le disque réside physiquement.
FirmwareVersion
Type de données : Chaîne
Type d'accès : Lecture seule
Qualificateurs : Obligatoire
Représentation sous forme de chaîne de la révision du microprogramme.
Friendlyname
Type de données : Chaîne
Type d'accès : Lecture seule
Qualificateurs : Obligatoire
Un nom d’affichage convivial pour le disque physique. La valeur initiale doit être définie par le fournisseur de stockage ou le sous-système et peut être modifiée par l’utilisateur à tout moment de la durée de vie de l’objet.
HealthStatus
Type de données : UInt16
Type d'accès : Lecture seule
Indication générale de l’intégrité de l’appareil.
| Valeur | Signification |
|---|---|
| 0 | Healthy |
| 1 | Warning |
| 2 | Unhealthy |
| 5 | Unknown |
IsIndicationEnabled
Type de données : Boolean
Type d'accès : Lecture seule
Indique si les VOYANTs d’identification du disque physique sont actifs ou non. Cela est généralement utilisé dans les opérations de maintenance.
IsPartial
Type de données : Boolean
Type d'accès : Lecture seule
TRUE si ce disque physique est partiellement consommé par un système ou un service en dehors des opérations normales du pool de stockage.
IsPowerProtected
Type de données : Boolean
Type d'accès : Lecture seule
Indique si ce disque physique est équipé pour tolérer une perte de courant sans perte de données.
IsWriteCacheEnabled
Type de données : Boolean
Type d'accès : Lecture seule
Indique si la mise en cache d’écriture est activée sur ce disque physique ou non.
LogicalSectorSize
Type de données : UInt64
Type d'accès : Lecture seule
Qualificateurs : Obligatoire, Unités (« octets »)
Taille du secteur logique du disque physique, en octets. Par exemple : un disque natif 4K doit signaler 4096, tandis qu’un disque émulé de 512 octets doit signaler 512.
MediaType
Type de données : UInt16
Type d'accès : Lecture seule
Type de média du disque physique.
| Valeur | Signification |
|---|---|
| 0 | Non spécifié |
| 3 | HDD |
| 4 | SSD |
| 5 | SCM |
OperationalDetails
Type de données : Tableau de chaînes
Type d'accès : Lecture seule
Tableau de chaînes fournissant des informations supplémentaires sur un status opérationnel donné.
OperationalStatus
Type de données : tableau UInt16
Type d'accès : Lecture seule
Tableau de valeurs de status opérationnelles expliquant davantage une status d’intégrité donnée.
OtherCannotPoolReasonDescription
Type de données : Chaîne
Type d'accès : Lecture seule
Chaîne contenant la raison définie par le fournisseur pour laquelle ce disque physique ne peut pas être ajouté à un pool concret. Cette propriété doit être NULL si la valeur de la propriété CannotPoolReason n’est pas Other.
PartNumber
Type de données : Chaîne
Type d'accès : Lecture seule
Qualificateurs : Obligatoire
Représentation sous forme de chaîne du numéro de référence ou de la référence SKU du disque physique.
PhysicalLocation
Type de données : Chaîne
Type d'accès : Lecture seule
Ce champ est une chaîne de forme libre indiquant où se trouve le matériel.
PhysicalSectorSize
Type de données : UInt64
Type d'accès : Lecture seule
Qualificateurs : Obligatoire, Unités (« octets »)
Taille du secteur physique du disque physique, en octets. Par exemple : pour les disques natifs 4K et 512 octets émulés, la valeur de cette propriété doit être 4096.
Taille
Type de données : UInt64
Type d'accès : Lecture seule
Qualificateurs : unités (« octets »)
Taille de stockage physique totale du disque, en octets.
SlotNumber
Type de données : UInt16
Type d'accès : Lecture seule
Numéro de l’emplacement de boîtier dans lequel réside physiquement le disque.
SoftwareVersion
Type de données : Chaîne
Type d'accès : Lecture seule
Qualificateurs : obligatoire
Représentation sous forme de chaîne du numéro de version du logiciel.
SpindleSpeed
Type de données : UInt32
Type d'accès : Lecture seule
Qualificateurs : Obligatoire, Unités (« RPM »)
Vitesse de rotation des disques physiques basés sur une broche. Pour les périphériques SSD (SSD) ou tout autre support non rotationnel, ce membre doit être défini sur 0. Pour la rotation d’un média dont la vitesse est inconnue, ce membre doit être défini sur 0xFFFFFFFF (UINT32_MAX).
SupportedUsages
Type de données : tableau UInt16
Type d'accès : Lecture seule
Qualificateurs : obligatoire
Tableau de valeurs qui spécifient les utilisations prises en charge pour ce disque physique.
| Valeur | Signification |
|---|---|
| Inconnu 0 | L’utilisation prévue n’est pas spécifiée. |
| Sélection automatique 1 | Ce disque physique doit uniquement être utilisé pour le stockage de données. |
| Sélection manuelle 2 | Ce disque physique ne doit être utilisé que s’il est sélectionné manuellement par un administrateur au moment de la création du disque virtuel. Un disque à sélection manuelle est sélectionné à l’aide du paramètre PhysicalDisksToUse sur CreateVirtualDisk. |
| Réserve à chaud 3 | Ce disque physique doit être utilisé comme disque de secours à chaud. |
| Mise hors service 4 | Ce disque physique doit être retiré de l’utilisation. Au minimum, aucune nouvelle allocation ne doit être attribuée à ce disque. Si les disques virtuels qui résident sur ce disque sont réparés, les données doivent être déplacées vers un autre disque physique actif. |
| Journal 5 | Ce disque physique doit être utilisé comme cache pour d’autres appareils comprenant un disque virtuel. Il sauvegarde le cache d’écriture différée d’un disque virtuel, s’il est configuré. |
UniqueIdFormat
Type de données : UInt16
Type d'accès : Lecture seule
Qualificateurs : obligatoire
Indique le type d’identificateur utilisé dans le champ UniqueId (hérité de MSFT_StorageObject). L’identificateur utilisé dans UniqueId 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 physique expose des identificateurs de type 0, 1 et 3, UniqueId doit être l’identificateur de type 3 et UniqueIdFormat doit avoir la valeur 3.
Spécifique au fournisseur (0)
ID fournisseur (1)
EUI64 (2)
Nom fcph (3)
Chaîne de nom SCSI (8)
Utilisation
Type de données : UInt16
Type d'accès : Lecture seule
Qualificateurs : obligatoire
Utilisation prévue de ce disque physique au sein d’un pool concret.
Les pools de stockage doivent suivre la stratégie affectée pour un disque physique.
| Valeur | Signification |
|---|---|
| Inconnu 0 | L’utilisation prévue n’est pas spécifiée. |
| Sélection automatique 1 | Ce disque physique doit uniquement être utilisé pour le stockage de données. |
| Sélection manuelle 2 | Ce disque physique ne doit être utilisé que s’il est sélectionné manuellement par un administrateur au moment de la création du disque virtuel. Un disque à sélection manuelle est sélectionné à l’aide du paramètre PhysicalDisksToUse sur CreateVirtualDisk. |
| Réserve à chaud 3 | Ce disque physique doit être utilisé comme disque de secours à chaud. |
| Mise hors service 4 | Ce disque physique doit être retiré de l’utilisation. Au minimum, aucune nouvelle allocation ne doit être attribuée à ce disque. Si les disques virtuels qui résident sur ce disque sont réparés, les données doivent être déplacées vers un autre disque physique actif. |
| Journal 5 | Ce disque physique doit être utilisé comme cache pour d’autres appareils comprenant un disque virtuel. Il sauvegarde le cache d’écriture différée d’un disque virtuel, s’il est configuré. |
VirtualDiskFootprint
Type de données : UInt16
Type d'accès : Lecture seule
Ce champ indique la taille en octets de l’empreinte des données utilisateur des disques virtuels sur ce disque physique.
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 |