Win32_Directory classe

La classe WMI Win32_Directory représente une entrée de répertoire sur un système informatique exécutant Windows. Un répertoire est un type de fichier qui regroupe logiquement les fichiers de données et fournit des informations de chemin d’accès pour les fichiers regroupés. Exemple : C:\TEMP. Win32_Directory n’inclut pas les répertoires des lecteurs réseau.

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"), UUID("{8502C4C7-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_Directory : CIM_Directory
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  uint32   AccessMask;
  boolean  Archive;
  boolean  Compressed;
  string   CompressionMethod;
  string   CreationClassName;
  datetime CreationDate;
  string   CSCreationClassName;
  string   CSName;
  string   Drive;
  string   EightDotThreeFileName;
  boolean  Encrypted;
  string   EncryptionMethod;
  string   Extension;
  string   FileName;
  uint64   FileSize;
  string   FileType;
  string   FSCreationClassName;
  string   FSName;
  boolean  Hidden;
  uint64   InUseCount;
  datetime LastAccessed;
  datetime LastModified;
  string   Path;
  boolean  Readable;
  boolean  System;
  boolean  Writeable;
};

Membres

La classe Win32_Directory comporte les types de membres suivants :

• Méthodes
• Propriétés

Méthodes

La classe Win32_Directory a ces méthodes.

Méthode	Description
ChangeSecurityPermissions	Méthode de classe qui modifie les autorisations de sécurité pour le fichier logique spécifié dans le chemin d’accès de l’objet.
ChangeSecurityPermissionsEx	Méthode de classe qui modifie les autorisations de sécurité pour le fichier logique spécifié dans le chemin d’accès de l’objet.
Compresser	Méthode de classe qui compresse le fichier logique (ou le répertoire) spécifié dans le chemin d’accès de l’objet.
CompressEx	Méthode de classe qui compresse le fichier logique (ou le répertoire) spécifié dans le chemin d’accès de l’objet.
Copier	Méthode de classe qui copie le fichier logique ou le répertoire spécifié dans le chemin d’accès de l’objet à l’emplacement spécifié par le paramètre d’entrée.
CopyEx	Méthode de classe qui copie le fichier logique ou le répertoire spécifié dans le chemin d’accès de l’objet à l’emplacement spécifié par le paramètre FileName .
Supprimer	Méthode de classe qui supprime le fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet.
DeleteEx	Méthode de classe qui supprime le fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet.
GetEffectivePermission	Méthode de classe qui détermine si l’appelant dispose des autorisations agrégées spécifiées par l’argument Autorisations non seulement sur l’objet fichier, mais sur le partage sur lequel réside le fichier ou le répertoire (s’il se trouve sur un partage).
Renommer	Méthode de classe qui renomme le fichier logique (ou le répertoire) spécifié dans le chemin d’accès de l’objet.
TakeOwnerShip	Méthode de classe qui obtient la propriété du fichier logique spécifié dans le chemin d’accès de l’objet.
TakeOwnerShipEx	Méthode de classe qui obtient la propriété du fichier logique spécifié dans le chemin d’accès de l’objet.
Décompresser	Méthode de classe qui annule la copie du fichier logique (ou du répertoire) spécifié dans le chemin d’accès de l’objet.
UncompressEx	Méthode de classe qui annule la copie du fichier logique (ou du répertoire) spécifié dans le chemin d’accès de l’objet.

Propriétés

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

Masque d’accès

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« Droits d’accès »)

Masque de bits qui représente les droits d’accès requis pour accéder ou effectuer des opérations spécifiques sur le répertoire. Pour les valeurs de bits, consultez Constantes des droits d’accès aux fichiers et aux répertoires.

Notes

Sur les volumes FAT, la valeur FULL_ACCESS est retournée à la place, ce qui indique qu’aucune sécurité n’a été définie sur l’objet.

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

FILE_READ_DATA (fichier) ou FILE_LIST_DIRECTORY (répertoire) (1)

Accorde le droit de lire les données du fichier. Pour un répertoire, cette valeur accorde le droit de répertorier le contenu du répertoire.

FILE_WRITE_DATA (fichier) ou FILE_ADD_FILE (répertoire) (2)

Accorde le droit d’écrire des données dans le fichier. Pour un répertoire, cette valeur accorde le droit de créer un fichier dans le répertoire.

FILE_APPEND_DATA (fichier) ou FILE_ADD_SUBDIRECTORY (4)

Accorde le droit d’ajouter des données au fichier. Pour un répertoire, cette valeur accorde le droit de créer un sous-répertoire.

FILE_READ_EA (8)

Octroie le droit de lire les attributs étendus.

FILE_WRITE_EA (16)

Accorde le droit d’écrire des attributs étendus.

FILE_EXECUTE (fichier) ou FILE_TRAVERSE (répertoire) (32)

Accorde le droit d’exécuter un fichier. Pour un répertoire, le répertoire peut être parcouru.

FILE_DELETE_CHILD (répertoire) (64)

Accorde le droit de supprimer un répertoire et tous les fichiers qu’il contient (ses enfants), même si les fichiers sont en lecture seule.

FILE_READ_ATTRIBUTES (128)

Accorde le droit de lire les attributs de fichier.

FILE_WRITE_ATTRIBUTES (256)

Accorde le droit de modifier les attributs de fichier.

DELETE (65536)

Octroie l’accès de suppression.

READ_CONTROL (131072)

Octroie l’accès en lecture au descripteur de sécurité et au propriétaire.

WRITE_DAC (262144)

Octroie l’accès en écriture à la liste de contrôle d’accès discrétionnaire.

WRITE_OWNER (524288)

Affecte le propriétaire de l’écriture.

SYNCHRONIZE (1048576)

Synchronise l’accès et permet à un processus d’attendre qu’un objet passe à l’état signalé.

ACCESS_SYSTEM_SECURITY (18809343)

Contrôle la possibilité d’obtenir ou de définir la SACL dans le descripteur de sécurité d’un objet.

Archive

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« Doit être archivé »)

Indique si le bit d’archive sur le dossier a été défini. Le bit archive est utilisé par les programmes de sauvegarde pour identifier les fichiers qui doivent être sauvegardés. Si la valeur est True, le fichier doit être archivé.

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

Caption

Type de données : chaîne

Type d'accès : Lecture seule

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

Brève description textuelle 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 : Schéma (« Win32 »), DisplayName (« compressé »)

Indique si le dossier a été compressé ou non. WMI reconnaît les dossiers compressés à l’aide de WMI lui-même ou de l’interface utilisateur graphique ; Toutefois, il ne reconnaît pas .ZIP fichiers comme étant compressés. Si la valeur est True, le fichier est compressé.

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

CompressionMethod

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Compression Method »)

Algorithme ou outil (généralement une méthode) utilisé pour compresser le fichier logique. S’il n’est pas possible (ou non souhaité) de décrire le schéma de compression (peut-être parce qu’il n’est pas connu), utilisez les mots suivants : « Inconnu » pour indiquer qu’il n’est pas connu si le fichier logique est compressé ; « Compressé » pour représenter que le fichier est compressé, mais que son schéma de compression n’est pas connu ou n’est pas divulgué ; et « Non compressé » pour représenter que le fichier logique n’est pas compressé.

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

CreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : CIM_Key, DisplayName (« Nom de la classe »)

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, cette 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_LogicalFile.

CreationDate

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Date de création »)

Date de création de l’objet de système de fichiers. Pour plus d’informations sur l’utilisation des formats de date et d’heure WMI, consultez Tâches WMI : dates et heures.

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

CSCreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : propagé (« CIM_FileSystem. CSCreationClassName »), CIM_Key, DisplayName (« Nom de la classe système de l’ordinateur »)

Nom de la classe de création du système informatique d’étendue.

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

CSName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : propagé (« CIM_FileSystem. CSName »), CIM_Key, DisplayName (« Nom du système d’ordinateur »)

Nom de l’ordinateur sur lequel l’objet de système de fichiers est stocké.

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

Description

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Description »)

Description textuelle de l’objet.

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

Disque

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Fixe, Schéma (« Win32 »), DisplayName (« Lecteur »)

Lettre de lecteur du lecteur (y compris les deux-points) où l’objet système de fichiers est stocké.

Exemple : « c: »

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

EightDotThreeFileName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« Nom de fichier à huit points trois »)

Nom compatible MS-DOS pour le dossier.

Exemple : « c:\progra~1 »

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

Chiffré

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« Chiffré »)

Indique si le dossier a été chiffré ou non. Si la valeur est True, le dossier est chiffré.

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

EncryptionMethod

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Méthode de chiffrement »)

Algorithme ou outil utilisé pour chiffrer le fichier logique. S’il n’est pas possible (ou non souhaité) de décrire le schéma de chiffrement (peut-être pour des raisons de sécurité), utilisez les mots suivants : « Inconnu » pour indiquer qu’on ne sait pas si le fichier logique est chiffré ; « Chiffré » pour représenter que le fichier est chiffré, mais que son schéma de chiffrement n’est pas connu ou n’est pas divulgué ; et « Non chiffré » pour représenter que le fichier logique n’est pas chiffré.

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

Extension

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Fixed, Schema (« Win32 »), DisplayName (« File Extension »)

Extension de nom de fichier pour l’objet de système de fichiers, sans inclure le point (.) qui sépare l’extension du nom de fichier.

Exemples : « txt », « mof », « mdb »

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

FileName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Fixe, Schéma (« Win32 »), DisplayName (« Nom de fichier »)

Nom du fichier (sans point ou extension) du fichier.

Exemple : « autoexec »

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

FileSize

Type de données : uint64

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Taille »), Unités (« octets »)

Taille de l’objet système de fichiers, en octets. Bien que les dossiers possèdent une propriété FileSize , la valeur 0 est toujours retournée. Pour déterminer la taille d’un dossier, utilisez FileSystemObject ou ajoutez la taille de tous les fichiers stockés dans le dossier.

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

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

FileType

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« Type de fichier »)

Type de fichier (indiqué par la propriété Extension ).

Par exemple, un fichier .mdb est susceptible d’avoir le type de fichier Application Microsoft Access. Un fichier .asp a probablement le type de fichier Document HTML. Les dossiers sont généralement signalés simplement en tant que Dossier.

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

FSCreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : propagé (« CIM_FileSystem. CreationClassName « ), CIM_Key, DisplayName (« Nom de classe du système de fichiers »)

Classe du système de fichiers.

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

FSName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : propagé (« CIM_FileSystem. Nom »), CIM_Key, DisplayName (« Nom du système de fichiers »)

Type de système de fichiers (NTFS, FAT, FAT32) installé sur le lecteur où se trouve le fichier ou le dossier.

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

Hidden

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« Masqué »)

Indique si l’objet système de fichiers est masqué. Si la valeur est True, le fichier est masqué.

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

InstallDate

Type de données : datetime

Type d'accès : Lecture seule

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

Indique quand l’objet a été installé. L’absence d’une valeur n’indique pas que l’objet n’est pas installé.

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

InUseCount

Type de données : uint64

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Nombre d’ouvertures de fichier actuel »)

Nombre de « fichier s’ouvre » actuellement actifs sur le fichier.

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

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

LastAccessed

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Dernier accès »)

Date du dernier accès au fichier. Pour plus d’informations sur l’utilisation des formats de date et d’heure WMI, consultez Tâches WMI : dates et heures.

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

LastModified

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Dernière modification »)

Date de la dernière modification du fichier. Pour plus d’informations sur l’utilisation des formats de date et d’heure WMI, consultez Tâches WMI : dates et heures.

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

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : clé

La propriété Name est une chaîne représentant le nom hérité qui sert de clé d’un fichier logique instance dans un système de fichiers. Les noms de chemin d’accès complets doivent être fournis. Exemple : C:\Windows\system\win.ini

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

Chemin d’accès

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Fixe, Schéma (« Win32 »), DisplayName (« Chemin »)

Chemin du fichier. Le chemin d’accès inclut les barres obliques inverses de début et de fin, mais pas la lettre de lecteur ou le nom du dossier.

Pour le dossier c:\windows\system32\wbem, le chemin d’accès est \windows\system32\. Pour le dossier c:\scripts, le chemin d’accès est \.

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

Lisible

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« lisible »)

Indique si vous pouvez lire des éléments dans le dossier. Si la valeur est True, le fichier peut être lu.

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

État

Type de données : chaîne

Type d'accès : Lecture seule

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

Chaîne qui indique la status actuelle de l’objet.

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

Système

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« Fichier système »)

Indique si l’objet est un fichier système. Si la valeur est True, le fichier est un fichier système

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

Inscriptible

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Accessible en écriture »)

Si la valeur est True, le fichier peut être écrit.

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

Notes

La classe Win32_Directory est dérivée de CIM_Directory.

Vue d'ensemble

Les dossiers sont des objets de système de fichiers conçus pour contenir d’autres objets de système de fichiers. Toutefois, cela ne signifie pas que tous les dossiers se ressemblent. Au lieu de cela, les dossiers peuvent varier considérablement. Certains dossiers sont des dossiers de système d’exploitation, qui ne doivent généralement pas être modifiés par un script. Certains dossiers sont en lecture seule, ce qui signifie que les utilisateurs peuvent accéder au contenu de ce dossier, mais ne peuvent pas les ajouter, les supprimer ou les modifier. Certains dossiers sont compressés pour un stockage optimal, tandis que d’autres sont masqués et non visibles par les utilisateurs.

WMI utilise la classe Win32_Directory pour gérer les dossiers. De manière significative, les propriétés et méthodes disponibles dans cette classe sont identiques aux propriétés et méthodes disponibles dans la classe CIM_DataFile , la classe utilisée pour gérer les fichiers. Cela signifie qu’une fois que vous avez appris à gérer des dossiers à l’aide de WMI, vous savez également gérer les fichiers sans aucun travail supplémentaire.

La classe d’association Win32_Subdirectory est également utilisée pour gérer des fichiers et des dossiers. La classe Win32_Subdirectory lie un dossier et ses sous-dossiers immédiats. Par exemple, dans la structure de dossiers C:\Scripts\Logs, Logs est un sous-dossier de Scripts et Scripts est un sous-dossier du dossier racine C:\. Toutefois, Logs n’est pas considéré comme un sous-dossier de C:\.

Vous pouvez récupérer les propriétés de n’importe quel dossier dans le système de fichiers à l’aide de la classe Win32_Directory . Les propriétés disponibles à l’aide de cette classe sont indiquées dans le tableau 11.1. Pour récupérer les propriétés d’un dossier unique, créez une requête WQL (Windows Query Language) pour la classe Win32_Directory , en vous assurant d’inclure le nom du dossier. Par exemple, cette requête est liée au dossier D:\Archive :

Copy "SELECT * FROM Win32_Directory WHERE Name = 'D:\\Archive'"

Lorsque vous spécifiez un nom de fichier ou de dossier dans une requête WQL, veillez à utiliser deux barres obliques inverses (\\) pour séparer les composants de chemin d’accès.

Si vous souhaitez limiter la récupération de données à un seul lecteur de disque, incluez une clause Where spécifiant la lettre de lecteur. Par exemple, cette requête retourne une liste de tous les dossiers du lecteur C :

"SELECT * FROM Win32_Directory WHERE Drive = 'C:'"

Si vous devez énumérer tous les dossiers d’un ordinateur, sachez que cette requête peut prendre un certain temps.

Exemples

L’exemple VBScript suivant récupère les propriétés du dossier C:\Scripts.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFolders = objWMIService.ExecQuery("SELECT * FROM Win32_Directory WHERE Name = 'c:\\Scripts'")
For Each objFolder in colFolders
 Wscript.Echo "Archive: " & objFolder.Archive
 Wscript.Echo "Caption: " & objFolder.Caption
 Wscript.Echo "Compressed: " & objFolder.Compressed
 Wscript.Echo "Compression method: " & objFolder.CompressionMethod
 Wscript.Echo "Creation date: " & objFolder.CreationDate
 Wscript.Echo "Encrypted: " & objFolder.Encrypted
 Wscript.Echo "Encryption method: " & objFolder.EncryptionMethod
 Wscript.Echo "Hidden: " & objFolder.Hidden
 Wscript.Echo "In use count: " & objFolder.InUseCount
 Wscript.Echo "Last accessed: " & objFolder.LastAccessed
 Wscript.Echo "Last modified: " & objFolder.LastModified
 Wscript.Echo "Name: " & objFolder.Name
 Wscript.Echo "Path: " & objFolder.Path
 Wscript.Echo "Readable: " & objFolder.Readable
 Wscript.Echo "System: " & objFolder.System
 Wscript.Echo "Writeable: " & objFolder.Writeable
Next

L’exemple VBScript suivant retourne une liste de tous les dossiers masqués sur un ordinateur.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFiles = objWMIService.ExecQuery("SELECT * FROM Win32_Directory WHERE Hidden = True")
For Each objFile in colFiles
 Wscript.Echo objFile.Name
Next

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_Directory

Classes du système d’exploitation