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