_Classe disque logique Win32

La classe WMI _ disque logique Win32 représente une source de données qui correspond à 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 par ordre alphabétique, et non par 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;
  string   Size;
  string   Status;
  uint16   StatusInfo;
  boolean  SupportsDiskQuotas;
  boolean  SupportsFileBasedCompression;
  string   SystemCreationClassName;
  string   SystemName;
  boolean  VolumeDirty;
  string   VolumeName;
  string   VolumeSerialNumber;
};

Membres

La classe _ disque logique Win32 possède les types de membres suivants :

Méthodes

La classe _ disque logique Win32 possède 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 redémarrage suivant.
Réinitialiser Non implémenté. Pour plus d’informations sur l’implémentation de cette méthode, consultez la méthode Reset dans le _ disque logique CIM pour la documentation.
ScheduleAutoChk Planifie l’exécution de chkdsk au prochain redémarrage si le bit d’intégrité 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 le _ disque logique CIM.

Propriétés

La classe _ disque logique Win32 possède ces propriétés.

y accéder

Type de données : UInt16

Type d'accès : Lecture seule

Type d’accès aux médias disponible.

Cette propriété est héritée de la _ StorageExtent CIM.

Inconnu (0)

Lecture (1)

Accessible en écriture (2)

Accessible en écriture

Lecture/écriture prise en charge (3)

Écriture unique (4)

Disponibilité

Type de données : UInt16

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("MIF. |État opérationnel DMTF | 003,5 "," MIB. |Hôte IETF-ressources-MIB. hrDeviceStatus ")

Disponibilité et état 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 pleine puissance

Avertissement (4)

Dans le test (5)

Non applicable (6)

Mise hors tension (7)

Hors ligne (8)

Hors connexion

Hors service (9)

Détérioré (10)

Non installé (11)

Erreur d’installation (12)

Économie d’énergie-inconnu (13)

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

Économie d’énergie-mode faible puissance (14)

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

Économie d’énergie-veille (15)

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

Cycle d’alimentation (16)

Économie d’énergie-Avertissement (17)

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

En Pause (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é.

Suspendu (21)

L’appareil est calme.

BlockSize

Type de données : UInt64

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("MIB. IETF | Host-Resources-MIB. hrStorageAllocationUnits "), Units (" bytes ")

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

Cette propriété est héritée de la _ StorageExtent CIM.

Pour plus d’informations sur l’utilisation des valeurs UInt64 dans les scripts, consultez scripts dans WMI.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

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

Description succincte de l’objet d’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 (« | fonctions du système de fichiers win32api | GetVolumeInformation | FS _ vol _ est _ compressé »)

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

ConfigManagerErrorCode

Type de données : UInt32

Type d'accès : Lecture seule

Qualificateurs : Schema ("Win32")

Windows Code d’erreur Configuration Manager.

Cette propriété est héritée de CIM _ LogicalDevice.

Ce périphérique fonctionne correctement. (0)

L’appareil fonctionne correctement.

Ce périphérique n’est pas configuré correctement. (1)

L’appareil n’est pas configuré correctement.

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

Le pilote de cet appareil est peut-être endommagé ou votre système ne dispose peut-être pas de suffisamment de mémoire ou d’autres ressources. (3)

Le pilote de cet appareil est peut-être endommagé ou la mémoire ou d’autres ressources du système sont peut-être insuffisantes.

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

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

le pilote de cet appareil a besoin d’une ressource qui ne peut pas être gérée par Windows. (5)

le pilote de l’appareil requiert une ressource qui ne peut pas être gérée par Windows.

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 de l’appareil est manquant. (8)

Le chargeur de pilote de l’appareil est manquant.

Ce périphérique ne fonctionne pas correctement, car le microprogramme de contrôle ne signale pas correctement les ressources pour l’appareil. (9)

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

Impossible de démarrer cet appareil. (10)

Impossible de démarrer l’appareil.

Échec de cet appareil. (11)

Échec de l’appareil.

Ce périphérique ne peut pas trouver suffisamment de ressources disponibles. douze

L’appareil ne peut pas trouver suffisamment de ressources libres à utiliser.

Windows ne pouvez pas vérifier les ressources de ce périphérique. (13)

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

Ce périphérique ne peut pas fonctionner correctement tant que vous n’avez pas redémarré votre ordinateur. (14)

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

Cet appareil ne fonctionne pas correctement en raison d’un problème de réénumération. (15)

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

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.

Ce périphérique demande un type de ressource inconnu. (17)

L’appareil demande un type de ressource inconnu.

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

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

Échec lors de l’utilisation du chargeur VxD. (19)

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

Le Registre est peut-être endommagé.

Défaillance du système : essayez de modifier le pilote de 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 du matériel. 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 de cet appareil. Si cela ne fonctionne pas, consultez la documentation de votre matériel. (23)

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

Ce périphérique n’est pas présent, ne fonctionne pas correctement ou tous ses pilotes ne sont pas installés. (24)

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

Windows est toujours en cours d’installation sur cet appareil. (25)

Windows est toujours en cours de configuration de l’appareil.

Windows est toujours en cours d’installation sur cet appareil. (26)

Windows est toujours en cours de configuration de l’appareil.

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

L’appareil n’a pas une 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.

Ce périphérique est désactivé, car le microprogramme de l’appareil ne lui a pas donné les ressources requises. (29)

L’appareil est désactivé. Le microprogramme de l’appareil n’a pas fourni 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 : Schema ("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 : _ clé CIM

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

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 : clé, remplacement (« DeviceID »), MappingStrings (« WMI »)

Identificateur unique du disque logique à partir d’autres périphériques 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 Notes ci-dessous.

DriveType

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 représenté par ce disque logique.

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 désactivé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, ainsi que 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 d’erreur et de correction pris en charge par cette extension de stockage.

Cette propriété est héritée de la _ StorageExtent CIM.

FileSystem

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , fonctions du système de fichiers GetVolumeInformation)

Système de fichiers sur le disque logique.

Exemple : "NTFS"

FreeSpace

Type de données : UInt64

Type d'accès : Lecture seule

Qualificateurs : Units ("bytes")

Espace, en octets, disponible sur le disque logique.

Cette propriété est héritée du _ disque logique CIM.

Pour plus d’informations sur l’utilisation des valeurs UInt64 dans les scripts, consultez 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 requiert 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’unité 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 du système de fichiers GetVolumeInformation)

longueur maximale d’un composant de nom de fichier pris en charge par le lecteur Windows. Un composant de nom de fichier est cette partie d’un nom de fichier entre 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

Média

Type de données : UInt32

Type d'accès : Lecture seule

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

Type de support actuellement présent dans le lecteur logique. Cette valeur sera l’une des valeurs de l' _ énumération de type de média 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)

disquette 5 pouces (1)

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

disquette 3 pouces (2)

Disquette 3 1/2 pouces – 1,44 Mo-512 octets/secteur

disquette 3 pouces (3)

Disquette 3 1/2 pouces – 2,88 Mo-512 octets/secteur

disquette 3 pouces (4)

Disquette 3 1/2 pouces – 20,8 Mo-512 octets/secteur

disquette 3 pouces (5)

Disquette 3 1/2 pouces-720 Ko-512 octets/secteur

disquette 5 pouces (6)

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

disquette 5 pouces (7)

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

disquette 5 pouces (8)

Disquette 5 1/4 pouces-320 ko-1024 octets/secteur

disquette 5 pouces (9)

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

disquette 5 pouces (10)

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

Support amovible autre que disquette (11)

Disque dur fixe (12)

disquette 3 pouces (13)

Disquette 3 1/2 pouces – 120 Mo-512 octets/secteur

disquette 3 pouces (14)

Disquette 3 1/2 pouces-640 Ko-512 octets/secteur

disquette 5 pouces (15)

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

disquette 5 pouces (16)

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

disquette 3 pouces (17)

Disquette 3 1/2 pouces – 1,2 Mo-512 octets/secteur

disquette 3 pouces (18)

Disquette 3 1/2 pouces – 1,23 Mo-1024 octets/secteur

disquette 5 pouces (19)

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

disquette 3 pouces (20)

Disquette 3 1/2 pouces – 128 Mo-512 octets/secteur

disquette 3 pouces (21)

Disquette 3 1/2 pouces – 230 Mo-512 octets/secteur

disquette 8 pouces (22)

Disquette 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. Lorsqu’elle est sous-classée, cette propriété peut être substitué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. |Hôte IETF-ressources-MIB. hrStorageSize ")

Nombre total de blocs consécutifs, chacun bloquant la taille de la valeur contenue dans la propriété BlockSize , qui forme cette extension de stockage. La taille totale de l’extension 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’extension de stockage.

Cette propriété est héritée de la _ StorageExtent CIM.

Pour plus d’informations sur l’utilisation des valeurs UInt64 dans les scripts, consultez scripts dans WMI.

PNPDeviceID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Schema ("Win32")

Windows Identificateur d’appareil Plug-and-Play de l’unité 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 d’alimentation spécifiques d’un périphérique 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 le jeu de fonctionnalités exact 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.

État d’alimentation définissable (5)

La méthode SetPowerState est prise en charge. Cette méthode se trouve sur la classe parente du _ LogicalDevice CIM et peut être implémentée. Pour plus d’informations, consultez conception de Classes format MOF (MOF).

Cycle d’alimentation pris en charge (6)

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

Mise sous tension minutée prise en charge (7)

Power-On chronométré pris en charge

La méthode SetPowerState peut être appelée avec le paramètre PowerState défini à 5 (cycle d’alimentation) et l' heure définie sur une date et une heure spécifiques, ou un 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 le biais de l’alimentation (il peut être mis en mode veille, et ainsi de suite). Cette propriété n’indique pas que les fonctionnalités de gestion de l’alimentation sont actuellement activées, mais uniquement que l’appareil logique est capable d’effectuer la gestion de 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 | Windows fonctions réseau | WNetGetConnection")

Chemin d’accès réseau à l’unité 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 la _ StorageExtent CIM.

QuotasDisabled

Type de données : booléen

Type d'accès : Lecture seule

Indique que la gestion de quota 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 de quota a été utilisée mais 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 de quota.

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 dans le processus actif de compilation des informations et de configuration du disque pour la gestion des quotas.

Taille

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Units ("bytes")

Taille du lecteur de disque.

Cette propriété est héritée du _ disque logique CIM.

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

État

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (10), DisplayName ("Status")

État actuel de l’objet. Divers États opérationnels et inopérationnels peuvent être définis. Les États opérationnels sont les suivants : « OK », « détérioré » et « échec prévu » (un élément, tel qu’un lecteur de disque dur intelligent, peut fonctionner correctement, mais prédire une défaillance dans un avenir proche). Les États qui ne sont pas opérationnels sont les suivants : « erreur », « démarrage », « arrêt » et « service ». Le dernier, « service », peut s’appliquer pendant la réargentation en miroir d’un disque, le rechargement d’une liste d’autorisations utilisateur ou d’autres tâches administratives. Tous les travaux de ce type ne sont pas en ligne, mais l’élément géré n’est ni « OK », ni de 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étérioré (« détérioré »)

Inconnu ("inconnu")

Échec prévu (« échec prédit »)

Démarrage en cours (« démarrage »)

Arrêt en cours (« arrêt »)

Service (« service »)

Stressed (« stressed »)

Non récupéré (« non récupéré »)

Aucun contact (« aucun contact »)

Communication perdue (« inversée comm »)

StatusInfo

Type de données : UInt16

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("MIF. |État opérationnel DMTF | 003,3 ")

État de l’unité logique. Si cette propriété ne s’applique pas à l’unité 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 | Functions du système de fichiers | GetVolumeInformation | FS _ compression de fichier _ ")

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 : Propaged ("CIM _ System.CreationClassName"), _ clé CIM

Valeur de la propriété de l’étendue CreationClassName de l’ordinateur.

Cette propriété est héritée de CIM _ LogicalDevice.

SystemName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Propaged ("CIM _ System.Name"), _ clé CIM

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 _ est un _ volume _ sale »)

Si la valeur est true, le disque nécessite l’exécution de chkdsk lors du prochain redémarrage. Cette propriété s’applique uniquement aux instances de disque logique qui représentent un disque physique de 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 du système de fichiers GetVolumeInformation)

Nom du volume du disque logique.

Contraintes : maximum 32 caractères.

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

VolumeSerialNumber

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("win32api | , fonctions du système de fichiers GetVolumeInformation)

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

Contraintes : 11 caractères au maximum.

Exemple : « A8C3-D032 »

Notes

La classe _ disque logique Win32 est dérivée du _ disque logique CIM 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 de stockage. Toutefois, après l’installation d’un lecteur de disque physique, 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 sous-division d’une partition à laquelle a été affectée sa propre lettre de lecteur. (Il est possible d’avoir une partition à laquelle aucune lettre de lecteur n’a été affectée.) Lorsque vous communiquez avec le lecteur C ou le lecteur 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 sur le lecteur E, vous l’enregistrez sur le lecteur logique. Les disques physiques composent le matériel qui compose un lecteur, y compris des composants tels que les têtes, les secteurs et les cylindres. En revanche, les lecteurs logiques ont des propriétés telles que l’espace disque, l’espace disque disponible et les lettres de lecteur.

Notes

La classe disque _ logique Win32 peut être utilisée uniquement pour énumérer les propriétés de 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 à l’aide de disque _ logique Win32 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 de l' extracteur d’informations WMI sur la Galerie TechNet utilise la classe _ disque logique Win32 pour récupérer des informations matérielles à partir de plusieurs ordinateurs distants.

La récupération d’informations sur le disque à l’aide de WMI/CIM... L’exemple de code PowerShell sur la Galerie TechNet utilise le _ disque logique Win32 pour récupérer DeviceID, nom_volume et la taille d’un appareil cible. En particulier, cet exemple comprend une gestion rigoureuse des exceptions et retourne un seul objet par ordinateur, plutôt que par disque.

Enterprise l’écriture de scripts implique souvent la configuration du matériel et des logiciels sur des ordinateurs distants ; à son tour, vous devez savoir, à l’avance, le type de lecteur de disque installé 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 lecteurs de disque dur 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
\Cimv2 racine
MOF
CIMWin32. mof
DLL
CIMWin32.dll

Voir aussi

_Disque logique CIM

Classes matérielles du système informatique

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