_Classe MappedLogicalDisk Win32

La classe WMI _ MappedLogicalDisk WMI représente les périphériques de stockage réseau mappés en tant que disques logiques sur le système informatique.

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 et les méthodes sont classées par ordre alphabétique, et non par ordre MOF.

Syntaxe

[Dynamic, Provider("CIMWin32"), UUID("{BCF02FFE-5560-4de2-B419-272918693426}"), AMENDMENT]
class Win32_MappedLogicalDisk : CIM_LogicalDisk
{
  uint16   Access;
  uint16   Availability;
  uint64   BlockSize;
  string   Caption;
  boolean  Compressed;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  string   ErrorMethodology;
  string   FileSystem;
  uint64   FreeSpace;
  datetime InstallDate;
  uint32   LastErrorCode;
  uint32   MaximumComponentLength;
  string   Name;
  uint64   NumberOfBlocks;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  string   ProviderName;
  string   Purpose;
  boolean  QuotasDisabled;
  boolean  QuotasIncomplete;
  boolean  QuotasRebuilding;
  string   SessionID;
  uint64   Size;
  string   Status;
  uint16   StatusInfo;
  boolean  SupportsDiskQuotas;
  boolean  SupportsFileBasedCompression;
  string   SystemCreationClassName;
  string   SystemName;
  string   VolumeName;
  string   VolumeSerialNumber;
};

Membres

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

Méthodes

La classe Win32 _ MappedLogicalDisk possède ces méthodes.

Méthode Description
Réinitialiser Non implémenté. Pour implémenter cette méthode, consultez la méthode Reset dans le _ disque logique CIM.
SetPowerState Non implémenté. Pour implémenter cette méthode, consultez la méthode SetPowerState dans le _ disque logique CIM.

Propriétés

La classe Win32 _ MappedLogicalDisk a ces propriétés.

y accéder

Type de données : UInt16

Type d'accès : Lecture seule

État de l’accès au périphérique.

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

Inconnu (0)

Lecture (1)

Accessible en écriture (2)

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, bien qu’il soit é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. Si ce concept n’est pas valide pour le type d’appareil, la valeur est 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 »)

Brève description de l’objet.

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 fichier est compressé.

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 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.

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. Quand elle est utilisée avec les autres propriétés de clé de la classe, cette propriété autorise l’identification unique de 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 tableau de la mémoire.

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

Exemple : « Memory Array 1 »

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 des informations sur toutes les actions correctives qui peuvent être effectuées.

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

ErrorMethodology

Type de données : chaîne

Type d'accès : Lecture seule

Types de contrôle d’erreur utilisés par le matériel.

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)

Type d'accès : Lecture seule

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 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 ")

Type d'accès : Lecture seule

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)

contient la longueur maximale d’un composant de nom de fichier pris en charge par le lecteur Windows.

Exemple : 255

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName ("Name")

Étiquette de l’objet.

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). La 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 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 | Windows fonctions réseau | WNetGetConnection")

Nom du 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 qui décrit 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

Si la valeur est true, la gestion de quota n’est pas activée pour ce volume.

QuotasIncomplete

Type de données : booléen

Type d'accès : Lecture seule

Si la valeur est true, la gestion de quota a été utilisée mais a été désactivée. 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, le système de fichiers est configuré pour la gestion de quota.

IDsession

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : clé

ID de la session de l’utilisateur. L’utilisateur peut être connecté à l’aide d’une connexion locale ou d’une session de terminal.

Taille

Type de données : UInt64

Type d'accès : Lecture seule

Qualificateurs : Units ("bytes")

Taille du disque logique.

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

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

É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édit 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 ». L’état du service s’applique aux tâches administratives, telles que 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 l’un des autres États.

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

Les valeurs sont :

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, le système de fichiers sur lequel ce lecteur réseau est mappé 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 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é 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 : Propaged ("CIM _ System.Name"), _ clé CIM

Nom du système d’étendue.

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

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. Cette valeur de propriété peut comporter jusqu’à 32 caractères.

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. Cette valeur de propriété peut avoir un maximum de 11 caractères.

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

Exemple : « A8C3-D032 »

Notes

Les instances retournées pour cette classe sont les suivantes, en supposant que l’utilisateur A énumère les instances :

  • Le fournisseur recherche une session d’ouverture de session de l’utilisateur A sur cet ordinateur :

    • S’il y en a une (et une seule) de cette ouverture de session, le fournisseur retourne les lecteurs mappés de cette session.
    • S’il existe plusieurs sessions pour l’utilisateur A sur l’ordinateur, aucune instance de lecteur mappée n’est retournée (car le fournisseur n’a pas de moyen raisonnable de choisir la session à utiliser).
  • Si aucune session de l’utilisateur A n’est en cours d’exécution et qu’il existe un utilisateur connecté localement B :

    • S’il existe une seule session pour l’utilisateur B, le fournisseur emprunte l’identité d’un et retourne les lecteurs mappés de l’utilisateur B. Ce cas de figure prend en charge le scénario de support technique qui souhaite voir les instances d’un utilisateur connecté localement. Toutefois, le fait que les instances soient retournées dépend des paramètres de stratégie de sécurité locale dans les outils d’administration du panneau de configuration. Si la stratégie suivante est définie sur « créateur d’objet », aucune instance de lecteur mappée n’est retournée, même si un est membre du groupe administrateurs :

      « Objet système : propriétaire par défaut pour les objets créés par les membres du groupe administrateurs ».

    • Là encore, si plusieurs sessions de l’utilisateur B sont en cours d’exécution sur l’ordinateur, le fournisseur n’a aucun moyen de décider de ce qu’il faut utiliser. Dans ce cas, aucune instance de lecteur mappée n’est retournée.

Pour plus d’informations sur l’utilisation de Win32 _ MappedLogicalDisk, consultez Comment puis-je déterminer quels lecteurs sont mappés à des partages réseau ?

Exemples

L’extrait de code PowerShell suivant montre les lecteurs mappés.

Get-WmiObject Win32_MappedLogicalDisk | Select Name, ProviderName, FileSystem, Size, FreeSpace | Format-Table

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