_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 |
|
| DLL |
|