Classe Win32_LogicalDisk

La classe WMIWin32_LogicalDisk représente une source de données qui se résout en un périphérique de stockage local réel sur un système informatique exécutant Windows.

La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées dans l’ordre alphabétique, et non dans l’ordre MOF.

Syntaxe

[Dynamic, Provider("CIMWin32"), SupportsUpdate, UUID("{8502C4B7-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_LogicalDisk : CIM_LogicalDisk
{
  uint16   Access;
  uint16   Availability;
  uint64   BlockSize;
  string   Caption;
  boolean  Compressed;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  uint32   DriveType;
  boolean  ErrorCleared;
  string   ErrorDescription;
  string   ErrorMethodology;
  string   FileSystem;
  uint64   FreeSpace;
  datetime InstallDate;
  uint32   LastErrorCode;
  uint32   MaximumComponentLength;
  uint32   MediaType;
  string   Name;
  uint64   NumberOfBlocks;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  string   ProviderName;
  string   Purpose;
  boolean  QuotasDisabled;
  boolean  QuotasIncomplete;
  boolean  QuotasRebuilding;
  uint64   Size;
  string   Status;
  uint16   StatusInfo;
  boolean  SupportsDiskQuotas;
  boolean  SupportsFileBasedCompression;
  string   SystemCreationClassName;
  string   SystemName;
  boolean  VolumeDirty;
  string   VolumeName;
  string   VolumeSerialNumber;
};

Membres

La classe Win32_LogicalDisk a les types de membres suivants :

Méthodes

La classe Win32_LogicalDisk a ces méthodes.

Méthode Description
Chkdsk Appelle l’opération Chkdsk sur le disque.
ExcludeFromAutochk Exclut les disques de l’opération Chkdsk à exécuter au prochain redémarrage.
Réinitialiser Non implémenté. Pour plus d’informations sur l’implémentation de cette méthode, consultez la méthode Reset dans CIM_LogicalDisk pour obtenir de la documentation.
ScheduleAutoChk Planifie l’exécution de Chkdsk au redémarrage suivant si le bit sale a été défini.
SetPowerState Non implémenté. Pour plus d’informations sur l’implémentation de cette méthode, consultez la méthode SetPowerState dans CIM_LogicalDisk.

Propriétés

La classe Win32_LogicalDisk possède ces propriétés.

y accéder

Type de données : uint16

Type d'accès : Lecture seule

Type d’accès au média disponible.

Cette propriété est héritée de CIM_StorageExtent.

Inconnu (0)

Lisible (1)

Pouvant être écrit (2)

Accessible en écriture

Prise en charge de la lecture/écriture (3)

Écrire une seule fois (4)

Disponibilité

Type de données : uint16

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| État opérationnel|003.5 », « MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus »)

Disponibilité et status de l’appareil.

Cette propriété est héritée de CIM_LogicalDevice.

Autre (1)

Inconnu (2)

En cours d’exécution/pleine puissance (3)

En cours d’exécution ou plein régime

Avertissement (4)

Dans le test (5)

Non applicable (6)

Mise hors tension (7)

Hors ligne (8)

Hors connexion

Hors service (9)

Dégradé ( 10)

Non installé (11)

Erreur d’installation (12)

Power Save - Inconnu (13)

L’appareil est connu pour être en mode d’économie d’énergie, mais son status exact est inconnu.

Économie d’énergie - Mode Faible consommation (14)

L’appareil est dans un état d’économie d’énergie, mais il fonctionne toujours et peut présenter des performances dégradées.

Économie d’énergie - Veille (15)

L’appareil ne fonctionne pas, mais pourrait être rapidement mis à pleine puissance.

Cycle d’alimentation (16)

Power Save - Avertissement (17)

L’appareil est dans un état d’avertissement, mais également en mode économie d’énergie.

Suspendu (18)

L’appareil est suspendu.

Non prêt (19)

Le périphérique n’est pas prêt.

Non configuré (20)

L’appareil n’est pas configuré.

Quiesced (21)

L’appareil est silencieux.

BlockSize

Type de données : uint64

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIB. IETF| HOST-RESOURCES-MIB.hrStorageAllocationUnits »), Unités (« octets »)

Taille, en octets, des blocs qui forment cette étendue de stockage. S’il est inconnu ou si un concept de bloc n’est pas valide (par exemple, pour les étendues d’agrégation, la mémoire ou les disques logiques), entrez 1.

Cette propriété est héritée de CIM_StorageExtent.

Pour plus d’informations sur l’utilisation de valeurs uint64 dans des scripts, voir Scripts dans WMI.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64), DisplayName (« Caption »)

Brève description de l’objet une chaîne d’une ligne.

Cette propriété est héritée de CIM_ManagedSystemElement.

Compressed

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Fonctions du système de fichiers | GetVolumeInformation| FS_VOL_IS_COMPRESSED »)

Si la valeur est True, le volume logique existe en tant qu’entité compressée unique, telle qu’un volume DoubleSpace. Si la compression basée sur les fichiers est prise en charge, par exemple sur NTFS, cette propriété est False.

ConfigManagerErrorCode

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »)

Code d’erreur windows Configuration Manager.

Cette propriété est héritée de CIM_LogicalDevice.

Cet appareil fonctionne correctement. (0)

L’appareil fonctionne correctement.

Cet appareil n’est pas configuré correctement. (1)

L’appareil n’est pas configuré correctement.

Windows ne peut pas charger le pilote pour cet appareil. (2)

Le pilote de cet appareil peut être endommagé ou votre système peut manquer de mémoire ou d’autres ressources. (3)

Le pilote de cet appareil peut être endommagé ou le système peut être faible en mémoire ou d’autres ressources.

Cet appareil ne fonctionne pas correctement. L’un de ses pilotes ou votre registre peut être endommagé. (4)

L’appareil ne fonctionne pas correctement. L’un de ses pilotes ou le Registre peut être endommagé.

Le pilote de cet appareil a besoin d’une ressource que Windows ne peut pas gérer. (5)

Le pilote de l’appareil nécessite une ressource que Windows ne peut pas gérer.

La configuration de démarrage de cet appareil est en conflit avec d’autres appareils. (6)

La configuration de démarrage de l’appareil est en conflit avec d’autres appareils.

Impossible de filtrer. (7)

Le chargeur de pilote pour l’appareil est manquant. (8)

Le chargeur de pilote pour l’appareil est manquant.

Cet appareil ne fonctionne pas correctement, car le microprogramme de contrôle signale les ressources de l’appareil de manière incorrecte. (9)

L’appareil ne fonctionne pas correctement. Le microprogramme de contrôle signale incorrectement les ressources de l’appareil.

Cet appareil ne peut pas démarrer. (10)

L’appareil ne peut pas démarrer.

Cet appareil a échoué. (11)

Échec de l’appareil.

Cet appareil ne peut pas trouver suffisamment de ressources libres qu’il peut utiliser. (12)

L’appareil ne trouve pas suffisamment de ressources gratuites à utiliser.

Windows ne peut pas vérifier les ressources de cet appareil. (13)

Windows ne peut pas vérifier les ressources de l’appareil.

Cet appareil ne peut pas fonctionner correctement tant que vous ne redémarrez pas votre ordinateur. (14)

L’appareil ne peut pas fonctionner correctement tant que l’ordinateur n’est pas redémarré.

Cet appareil ne fonctionne pas correctement, car il existe probablement un problème de réinsentération. (15)

L’appareil ne fonctionne pas correctement en raison d’un problème de réinsentération possible.

Windows ne peut pas identifier toutes les ressources utilisées par cet appareil. (16)

Windows ne peut pas identifier toutes les ressources utilisées par l’appareil.

Cet appareil demande un type de ressource inconnu. (17)

L’appareil demande un type de ressource inconnu.

Réinstallez les pilotes de cet appareil. (18)

Les pilotes de périphérique doivent être réinstallés.

Échec à l’aide du chargeur VxD. (19)

Votre registre est peut-être endommagé. (20)

Le Registre peut être endommagé.

Défaillance du système : essayez de modifier le pilote pour cet appareil. Si cela ne fonctionne pas, consultez la documentation de votre matériel. Windows supprime cet appareil. (21)

Défaillance du système. Si la modification du pilote de périphérique n’est pas efficace, consultez la documentation matérielle. Windows supprime l’appareil.

Cet appareil est désactivé. (22)

L’appareil est désactivé.

Défaillance du système : essayez de modifier le pilote pour cet appareil. Si cela ne fonctionne pas, consultez votre documentation matérielle. (23)

Défaillance du système. Si la modification du pilote de périphérique n’est pas efficace, consultez la documentation matérielle.

Cet appareil n’est pas présent, ne fonctionne pas correctement ou n’a pas tous ses pilotes installés. (24)

L’appareil n’est pas présent, ne fonctionne pas correctement ou n’a pas tous ses pilotes installés.

Windows configure toujours cet appareil. (25)

Windows configure toujours l’appareil.

Windows configure toujours cet appareil. (26)

Windows configure toujours l’appareil.

Cet appareil n’a pas de configuration de journal valide. (27)

L’appareil n’a pas de configuration de journal valide.

Les pilotes de cet appareil ne sont pas installés. (28)

Les pilotes de périphérique ne sont pas installés.

Cet appareil est désactivé, car le microprogramme de l’appareil ne lui a pas donné les ressources nécessaires. (29)

L’appareil est désactivé. Le microprogramme de l’appareil ne fournissait pas les ressources requises.

Cet appareil utilise une ressource de demande d’interruption (IRQ) qu’un autre appareil utilise. (30)

L’appareil utilise une ressource IRQ qu’un autre appareil utilise.

Cet appareil ne fonctionne pas correctement, car Windows ne peut pas charger les pilotes requis pour cet appareil. (31)

L’appareil ne fonctionne pas correctement. Windows ne peut pas charger les pilotes de périphérique requis.

ConfigManagerUserConfig

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »)

Si la valeur est True, l’appareil utilise une configuration définie par l’utilisateur.

Cette propriété est héritée de CIM_LogicalDevice.

CreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : CIM_Key

Nom de la première classe concrète à apparaître dans la chaîne d’héritage utilisée dans la création d’un instance. Lorsqu’elle est utilisée avec les autres propriétés clés de la classe, la propriété permet à toutes les instances de cette classe et de ses sous-classes d’être identifiées de manière unique.

Cette propriété est héritée de CIM_LogicalDevice.

Description

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Description »)

Description de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

DeviceID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Key, Override (« DeviceId »), MappingStrings (« WMI »)

Identificateur unique du disque logique d’autres appareils sur le système.

Cette propriété est héritée de CIM_LogicalDevice.

Pour obtenir un exemple de code qui récupère cette propriété, consultez la section Remarques ci-dessous.

Type de lecteur

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| FileFunctions| GetDriveType »)

Valeur numérique qui correspond au type de lecteur de disque que ce disque logique représente.

Inconnu (0)

Aucun répertoire racine (1)

Disque amovible (2)

Disque local (3)

Lecteur réseau (4)

Disque compact (5)

Disque RAM (6)

ErrorCleared

Type de données : booléen

Type d'accès : Lecture seule

Si la valeur est True, l’erreur signalée dans LastErrorCode est maintenant effacée.

Cette propriété est héritée de CIM_LogicalDevice.

ErrorDescription

Type de données : chaîne

Type d'accès : Lecture seule

Plus d’informations sur l’erreur enregistrée dans LastErrorCode et des informations sur les actions correctives qui peuvent être prises.

Cette propriété est héritée de CIM_LogicalDevice.

ErrorMethodology

Type de données : chaîne

Type d'accès : Lecture seule

Type de détection et de correction d’erreur pris en charge par cette extension de stockage.

Cette propriété est héritée de CIM_StorageExtent.

Fichiers

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Fonctions de système de fichiersGetVolumeInformation)

Système de fichiers sur le disque logique.

Exemple : « NTFS »

FreeSpace

Type de données : uint64

Type d'accès : Lecture seule

Qualificateurs : unités (« octets »)

Espace, en octets, disponible sur le disque logique.

Cette propriété est héritée de CIM_LogicalDisk.

Pour plus d’informations sur l’utilisation de valeurs uint64 dans des scripts, voir Scripts dans WMI.

InstallDate

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| ComponentID|001.5 »), DisplayName (« Date d’installation »)

Date et heure d’installation de l’objet. Cette propriété ne nécessite pas de valeur pour indiquer que l’objet est installé.

Cette propriété est héritée de CIM_ManagedSystemElement.

LastErrorCode

Type de données : uint32

Type d'accès : Lecture seule

Dernier code d’erreur signalé par l’appareil logique.

Cette propriété est héritée de CIM_LogicalDevice.

MaximumComponentLength

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Fonctions de système de fichiersGetVolumeInformation)

Longueur maximale d’un composant de nom de fichier pris en charge par le lecteur Windows. Un composant de nom de fichier est la partie d’un nom de fichier entre les barres obliques inverses. La valeur peut être utilisée pour indiquer que les noms longs sont pris en charge par le système de fichiers spécifié. Par exemple, pour un système de fichiers FAT prenant en charge les noms longs, la fonction stocke la valeur 255, plutôt que l’indicateur 8,3 précédent. Les noms longs peuvent également être pris en charge sur les systèmes qui utilisent le système de fichiers NTFS.

Exemple : 255

MediaType

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Fonctions d’entrée et de sortie de l’appareil | DeviceIoControl »)

Type de média actuellement présent dans le lecteur logique. Cette valeur est l’une des valeurs de l’énumération MEDIA_TYPE définie dans Winioctl.h. La valeur peut ne pas être exacte pour les lecteurs amovibles s’il n’y a actuellement aucun média dans le lecteur.

Le format est inconnu (0)

Disque de 5 pouces ( 1)

5 1/4 pouces de disquette - 1,2 Mo - 512 octets/secteur

Disquette de 3 pouces (2)

3 disquettes de 1/2 pouces - 1,44 Mo -512 octets/secteur

Disque de 3 pouces ( 3)

3 disquettes de 1/2 pouces - 2,88 Mo - 512 octets/secteur

Disquette de 3 pouces (4)

3 disquettes de 1/2 pouces - 20,8 Mo - 512 octets/secteur

Disque de 3 pouces ( 5)

3 disquettes de 1/2 pouces - 720 Ko - 512 octets/secteur

Disquette de 5 pouces (6)

Disquette de 5 1/4 pouces - 360 Ko - 512 octets/secteur

Disque de 5 pouces ( 7)

Disquette de 5 1/4 pouces - 320 Ko - 512 octets/secteur

Disquette de 5 pouces (8)

Disquette de 5 1/4 pouces - 320 Ko - 1 024 octets/secteur

Disque de 5 pouces ( 9)

Disquette de 5 1/4 pouces - 180 Ko - 512 octets/secteur

Disque de 5 pouces ( 10)

Disquette de 5 1/4 pouces - 160 Ko - 512 octets/secteur

Support amovible autre que la disquette (11)

Support de disque dur fixe (12)

Disque de 3 pouces ( 13)

3 disquettes de 1/2 pouces - 120 Mo - 512 octets/secteur

Disque de 3 pouces ( 14)

3 disquettes de 1/2 pouces - 640 Ko - 512 octets/secteur

Disque de 5 pouces ( 15)

Disquette de 5 1/4 pouces - 640 Ko - 512 octets/secteur

Disquette de 5 pouces (16)

Disquette de 5 1/4 pouces - 720 Ko - 512 octets/secteur

Disque de 3 pouces ( 17)

3 disquettes de 1/2 pouces - 1,2 Mo - 512 octets/secteur

Disque de 3 pouces (18)

3 disquettes de 1/2 pouces - 1,23 Mo - 1 024 octets/secteur

Disquette de 5 pouces (19)

Disquette de 5 1/4 pouces - 1,23 Mo - 1 024 octets/secteur

Disquette de 3 pouces (20)

3 disquettes de 1/2 pouces - 128 Mo - 512 octets/secteur

Disque de 3 pouces ( 21)

3 disquettes de 1/2 pouces - 230 Mo - 512 octets/secteur

Disque de 8 pouces ( 22)

Disquette de 8 pouces - 256 Ko - 128 octets/secteur

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Name »)

Étiquette par laquelle l’objet est connu. En cas de sous-classe, cette propriété peut être remplacée pour être une propriété de clé.

Cette propriété est héritée de CIM_ManagedSystemElement.

NumberOfBlocks

Type de données : uint64

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIB. IETF| HOST-RESOURCES-MIB.hrStorageSize »)

Nombre total de blocs consécutifs, chaque bloc de la taille de la valeur contenue dans la propriété BlockSize , qui forme cette extension de stockage. La taille totale de l’étendue de stockage peut être calculée en multipliant la valeur de la propriété BlockSize par la valeur de cette propriété. Si la valeur de BlockSize est 1, cette propriété correspond à la taille totale de l’étendue de stockage.

Cette propriété est héritée de CIM_StorageExtent.

Pour plus d’informations sur l’utilisation de valeurs uint64 dans des scripts, voir Scripts dans WMI.

PNPDeviceID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »)

Windows Plug-and-Play identificateur d’appareil de l’appareil logique.

Cette propriété est héritée de CIM_LogicalDevice.

Exemple : « *PNP030b »

PowerManagementCapabilities

Type de données : tableau uint16

Type d'accès : Lecture seule

Tableau des fonctionnalités spécifiques liées à l’alimentation d’un appareil logique.

Cette propriété est héritée de CIM_LogicalDevice.

Inconnu (0)

Non pris en charge (1)

Désactivé (2)

Activé (3)

Les fonctionnalités de gestion de l’alimentation sont actuellement activées, mais l’ensemble exact des fonctionnalités est inconnu ou les informations ne sont pas disponibles.

Modes d’économie d’énergie entrés automatiquement (4)

L’appareil peut modifier son état d’alimentation en fonction de l’utilisation ou d’autres critères.

Power State Settable (5)

La méthode SetPowerState est prise en charge. Cette méthode se trouve dans la classe CIM_LogicalDevice parent et peut être implémentée. Pour plus d’informations, consultez Conception de classes MOF (Managed Object Format).

Power Cycling pris en charge (6)

La méthode SetPowerState peut être appelée avec le paramètre PowerState défini sur 5 (Cycle d’alimentation).

Prise en charge de l’alimentation chrono timed (7)

Power-On chrono timed pris en charge

La méthode SetPowerState peut être appelée avec le paramètre PowerState défini sur 5 (Cycle d’alimentation) et l’heure définie sur une date et une heure spécifiques, ou intervalle, pour la mise sous tension.

PowerManagementSupported

Type de données : booléen

Type d'accès : Lecture seule

Si la valeur est True, l’appareil peut être géré par l’alimentation (peut être mis en mode suspension, etc.). Cette propriété n’indique pas que les fonctionnalités de gestion de l’alimentation sont actuellement activées, mais seulement que l’appareil logique est capable de gérer l’alimentation.

Cette propriété est héritée de CIM_LogicalDevice.

ProviderName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Fonctions de mise en réseau Windows | WNetGetConnection »)

Chemin réseau de l’appareil logique.

Objectif

Type de données : chaîne

Type d'accès : Lecture seule

Chaîne de forme libre décrivant le média et son utilisation.

Cette propriété est héritée de CIM_StorageExtent.

QuotasDisabled

Type de données : booléen

Type d'accès : Lecture seule

Indique que la gestion des quotas n’est pas activée (TRUE) sur ce système.

QuotasIncomplete

Type de données : booléen

Type d'accès : Lecture seule

Indique que la gestion des quotas a été utilisée, mais qu’elle a été désactivée (True). Incomplet fait référence aux informations laissées dans le système de fichiers après la désactivation de la gestion des quotas.

QuotasRebuilding

Type de données : booléen

Type d'accès : Lecture seule

Si la valeur est True, indique que le système de fichiers est en cours de compilation des informations et de configuration du disque pour la gestion des quotas.

Taille

Type de données : uint64

Type d'accès : Lecture seule

Qualificateurs : unités (« octets »)

Taille du lecteur de disque.

Cette propriété est héritée de CIM_LogicalDisk.

Pour obtenir un exemple de code qui récupère cette propriété, consultez la section Remarques ci-dessous.

État

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (10), DisplayName (« Status »)

Status actuelle de l’objet. Différents états opérationnels et non opérationnels peuvent être définis. Les états opérationnels incluent : « OK », « Détérioré » et « Échec anticipé » (un élément, tel qu’un lecteur de disque dur smart, peut fonctionner correctement, mais prédire une défaillance dans un avenir proche). Les états non coopératifs incluent : « Erreur », « Démarrage », « Arrêt » et « Service ». Ce dernier, « Service », peut s’appliquer lors de la miroir-resilver d’un disque, du rechargement d’une liste d’autorisations utilisateur ou d’autres tâches administratives. Tous ces travaux ne sont pas en ligne, mais l’élément managé n’est ni « OK », ni dans l’un des autres états.

Cette propriété est héritée de CIM_ManagedSystemElement.

Les valeurs sont notamment les suivantes :

OK (« OK »)

Erreur (« Erreur »)

Dégradé (« Dégradé »)

Inconnu (« Inconnu »)

Échec du prédé (« Échec anticipé »)

Démarrage (« Démarrage »)

Arrêt (« Arrêt »)

Service (« Service »)

Stressé (« Stressé »)

NonRecover (« NonRecover »)

Aucun contact (« Aucun contact »)

Lost Comm (« Lost Comm »)

StatusInfo

Type de données : uint16

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| État opérationnel|003.3 »)

État de l’appareil logique. Si cette propriété ne s’applique pas à l’appareil logique, la valeur 5 (Non applicable) doit être utilisée.

Cette propriété est héritée de CIM_LogicalDevice.

Autre (1)

Inconnu (2)

Activé (3)

Désactivé (4)

Non applicable (5)

SupportsDiskQuotas

Type de données : booléen

Type d'accès : Lecture seule

Si la valeur est True, ce volume prend en charge les quotas de disque.

SupportsFileBasedCompression

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Fonctions du système de fichiers | GetVolumeInformation| FS_FILE_COMPRESSION »)

Si la valeur est True, la partition de disque logique prend en charge la compression basée sur les fichiers, comme c’est le cas avec le système de fichiers NTFS. Cette propriété a la valeur False lorsque la propriété Compressed a la valeur True.

SystemCreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : propagé (« CIM_System. CreationClassName »), CIM_Key

Valeur de la propriété CreationClassName de l’ordinateur 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

Qualificateurs : propagé (« CIM_System. Nom « ), CIM_Key

Nom du système d’étendue.

Cette propriété est héritée de CIM_LogicalDevice.

VolumeDirty

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« FSCTL_IS_VOLUME_DIRTY »)

Si la valeur est True, le disque nécessite l’exécution de ChkDsk au prochain redémarrage. Cette propriété s’applique uniquement aux instances de disque logique qui représentent un disque physique dans l’ordinateur. Elle ne s’applique pas aux lecteurs logiques mappés.

VolumeName

Type de données : chaîne

Type d’accès : Lecture/écriture

Qualificateurs : MappingStrings (« Win32API| Fonctions de systèmede fichiers GetVolumeInformation)

Nom du volume du disque logique.

Contraintes : 32 caractères maximum.

Pour obtenir un exemple de code qui récupère cette propriété, consultez la section Remarques ci-dessous.

VolumeSerialNumber

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32API| Fonctions de systèmede fichiers GetVolumeInformation)

Numéro de série du volume du disque logique.

Contraintes : 11 caractères maximum.

Exemple : « A8C3-D032 »

Notes

La classe Win32_LogicalDisk est dérivée de CIM_LogicalDisk qui dérive de CIM_StorageExtent. La classe CIM_StorageExtent est dérivée de CIM_LogicalDevice.

Un lecteur de disque physique est la pierre angulaire de tout système de gestion du stockage. Toutefois, une fois qu’un lecteur de disque physique a été installé, ni les utilisateurs ni les administrateurs système ne traitent généralement le matériel directement. Au lieu de cela, les utilisateurs et les administrateurs système interagissent avec les lecteurs logiques qui ont été créés sur le disque.

Un lecteur logique est une subdivision d’une partition qui a reçu sa propre lettre de lecteur. (Il est possible d’avoir une partition à laquelle aucune lettre de lecteur n’a été affectée.) Lorsque vous parlez de lecteur C ou D, vous faites référence à un lecteur logique plutôt qu’à un lecteur de disque physique. De même, lorsque vous enregistrez un document dans le lecteur E, vous l’enregistrez sur le lecteur logique. Les disques physiques composent le matériel qui compose un lecteur, y compris les composants tels que les têtes, les secteurs et les cylindres. Les lecteurs logiques, en revanche, ont des propriétés telles que l’espace disque, l’espace disque disponible et les lettres de lecteur.

Notes

La classe Win32_LogicalDisk peut uniquement être utilisée pour énumérer les propriétés des lecteurs de disque locaux. Toutefois, vous pouvez utiliser la classe Win32_MappedLogicalDisk pour énumérer les propriétés des lecteurs réseau mappés.

Exemples

Vous trouverez d’autres exemples utilisant Win32_LogicalDisk pour obtenir des données de disque ou de volume dans la rubrique Tâches WMI : Disques et systèmes de fichiers .

L’exemple de code VBScript WMI Information Retriever sur TechNet Gallery utilise la classe Win32_LogicalDisk pour récupérer des informations matérielles à partir d’un certain nombre d’ordinateurs distants.

Obtenir des informations sur le disque à l’aide de wmi/cim... L’exemple de code PowerShell sur techNet Gallery utilise Win32_LogicalDisk pour récupérer DeviceID, VolumeName et Size à partir d’un appareil cible. En particulier, cet exemple inclut une gestion rigoureuse des exceptions et retourne un seul objet par ordinateur, plutôt que par disque.

Les scripts d’entreprise impliquent souvent la configuration du matériel et des logiciels sur des ordinateurs distants ; à son tour, vous devez connaître, à l’avance, le type de lecteurs de disque installés sur un ordinateur. Par exemple, un script qui installe une application sur le lecteur E fonctionne uniquement si le lecteur E est un disque dur. Si le lecteur E représente une disquette ou un lecteur de CD-ROM, le script échoue. Le code suivant identifie les lecteurs et les types de lecteurs installés sur un ordinateur

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colDisks = objWMIService.ExecQuery ("SELECT * FROM Win32_LogicalDisk")
For Each objDisk in colDisks
 Wscript.Echo "DeviceID: "& objDisk.DeviceID 
 Select Case objDisk.DriveType
 Case 1
 Wscript.Echo "No root directory."
 Case 2
 Wscript.Echo "DriveType: Removable drive."
 Case 3
 Wscript.Echo "DriveType: Local hard disk."
 Case 4
 Wscript.Echo "DriveType: Network disk." 
 Case 5
 Wscript.Echo "DriveType: Compact disk." 
 Case 6
 Wscript.Echo "DriveType: RAM disk." 
 Case Else
 Wscript.Echo "Drive type could not be determined."
 End Select
Next

//be sure to References->Add->System.Management to your project
using System.Management;
...
{
   string strComputer = ".";
            
   ManagementScope namespaceScope = new ManagementScope("\\\\" + strComputer + "\\ROOT\\CIMV2");
   ObjectQuery diskQuery = new ObjectQuery("SELECT * FROM Win32_LogicalDisk");
   ManagementObjectSearcher mgmtObjSearcher = new ManagementObjectSearcher(namespaceScope, diskQuery);
   ManagementObjectCollection colDisks = mgmtObjSearcher.Get();

   foreach (ManagementObject objDisk in colDisks)
   {
      Console.WriteLine("Device ID : {0}", objDisk["DeviceID"]);
                
      switch ((uint)(objDisk["DriveType"]))
      {
         case 1: {   Console.WriteLine("No root directory.");
                     break;}
         case 2: {   Console.WriteLine("DriveType: Removable drive."); 
                     break;}
         case 3: {   Console.WriteLine("DriveType: Local hard disk.");
                     break;}
         case 4: {   Console.WriteLine("DriveType: Network disk.");
                     break;}
         case 5: {   Console.WriteLine("DriveType: Compact disk.");
                     break;}
         case 6: {   Console.WriteLine("DriveType: RAM disk.");
                     break;}
         default: {  Console.WriteLine("Drive type could not be determined.");
                     break;}
      }
      //Readline is in here so the user can see the result before the code exists
      Console.ReadLine();
   }
}

Les exemples suivants énumèrent l’espace libre sur tous les disques durs d’un ordinateur.

Const HARD_DISK = 3
strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colDisks = objWMIService.ExecQuery ("SELECT * FROM Win32_LogicalDisk WHERE DriveType = " & HARD_DISK & "")
For Each objDisk in colDisks
 Wscript.Echo "Device ID: " & objDisk.DeviceID 
 Wscript.Echo "Free Disk Space: " & objDisk.FreeSpace
Next

//be sure to References->Add->System.Management to your project
using System.Management;
...

const int HARD_DISK = 3;
string strComputer = ".";

ManagementScope namespaceScope = new ManagementScope("\\\\" + strComputer + "\\ROOT\\CIMV2");
ObjectQuery diskQuery = new ObjectQuery("SELECT * FROM Win32_LogicalDisk WHERE DriveType = " + HARD_DISK + "");
ManagementObjectSearcher mgmtObjSearcher = new ManagementObjectSearcher(namespaceScope, diskQuery);
ManagementObjectCollection colDisks = mgmtObjSearcher.Get();

foreach (ManagementObject objDisk in colDisks)
{
    Console.WriteLine("Device ID : {0}", objDisk["DeviceID"]);
    Console.WriteLine("Free Disk Space : {0}", objDisk["FreeSpace"]);
    Console.ReadLine();
}

L’exemple de code suivant retourne le type de système de fichiers (FAT, NTFS, FAT32, etc.) utilisé sur chaque lecteur d’un ordinateur.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\Root\CIMv2")
Set colDisks = objWMIService.ExecQuery ("Select * from Win32_LogicalDisk")
For Each objDisk in colDisks
    Wscript.Echo "DeviceID: "& vbTab &  objDisk.DeviceID  
    Wscript.Echo "File System: "& vbTab & objDisk.FileSystem
Next

Get-WMIObject Win32_LogicalDisk | Select DeviceID, FileSystem | Format=Table -AutoSize

L’exemple de code PowerShell suivant récupère des informations supplémentaires sur les disques locaux logiques.

Write-Host "Drive information for $env:ComputerName"

Get-WmiObject -Class Win32_LogicalDisk |
    Where-Object {$_.DriveType -ne 5} |
    Sort-Object -Property Name | 
    Select-Object Name, VolumeName, FileSystem, Description, VolumeDirty, `
        @{"Label"="DiskSize(GB)";"Expression"={"{0:N}" -f ($_.Size/1GB) -as [float]}}, `
        @{"Label"="FreeSpace(GB)";"Expression"={"{0:N}" -f ($_.FreeSpace/1GB) -as [float]}}, `
        @{"Label"="%Free";"Expression"={"{0:N}" -f ($_.FreeSpace/$_.Size*100) -as [float]}} |
    Format-Table -AutoSize

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
Racine\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Voir aussi

CIM_LogicalDisk

Classes matérielles du système informatique

Tâches WMI : Disques et systèmes de fichiers