classe Win32_Directory

La classe Win32_DirectoryWMI représente une entrée d’annuaire sur un système d’ordinateur exécutant Windows. Un répertoire est un type de fichier qui regroupe logiquement des fichiers de données et fournit des informations de chemin pour les fichiers regroupés. Exemple : C:\TEMP. Win32_Directory n’inclut pas de répertoires de 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 a ces types de membres :

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é du 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é du fichier logique spécifié dans le chemin d’accès de l’objet.
Compresser Méthode de classe qui compresse le fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet.
CompressEx Méthode de classe qui compresse le fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet.
Copie 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 le répertoire) spécifié dans le chemin d’accès de l’objet.
DeleteEx Méthode de classe qui supprime le fichier logique (ou le 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 de fichier, mais sur le partage sur lequel se trouve 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 désactive le fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet.
Annuler la décompressionEx Méthode de classe qui désactive le fichier logique (ou 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.

AccessMask

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 obtenir des valeurs de bits, consultez Constantes des droits d’accès au fichier et au répertoire.

Remarque

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 des données à partir 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)

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

Accorde l’accès à la suppression.

READ_CONTROL (131072)

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

WRITE_DAC (262144)

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

WRITE_OWNER (524288)

Affecte le propriétaire d’écriture.

SYNCHRONISE (1048576)

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

ACCESS_SYSTEM_SECURITY (18809343)

Contrôle la possibilité d’obtenir ou de définir la liste de contrôle d’accès partagé 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 d’archivage 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 à l’aide 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 (« Méthode de compression »)

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 représenter 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 classe »)

Nom de la première classe concrète à afficher dans la chaîne d’héritage utilisée dans la création d’une instance. Lorsqu’elle est utilisée avec les autres propriétés de clé de la classe, cette propriété permet à toutes les instances de cette classe et à 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 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 ordinateur »)

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

Lecteur

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 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 (« Huit points trois noms de fichier »)

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 (« Encrypted »)

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 représenter qu’il n’est pas connu 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 : fixe, schéma (« Win32 »), DisplayName (« Extension de fichier »)

Extension de nom de fichier pour l’objet 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 de 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 (« Size »), Units (« bytes »)

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, consultez Scripting in 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 Microsoft Access Application. Un fichier .asp a probablement le type de fichier HTML Document. Les dossiers sont généralement signalés 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 la classe de 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 « fichiers s’ouvre » qui sont 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, consultez Scripting in WMI.

LastAccessed

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Dernier accès »)

Date à laquelle le fichier a été consulté pour la dernière fois. 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 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’une instance de fichier logique 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 d’accès du fichier. Le chemin 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 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 (« État »)

Chaîne qui indique l’état actuel de l’objet.

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édéfinu (« Échec prédéfinu »)

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 (« writeable »)

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. Cela ne signifie pas que tous les dossiers sont identiques, cependant. 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 ajouter, supprimer ou modifier ce contenu. 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 les 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 serez, sans aucun travail supplémentaire, également savoir comment gérer des fichiers.

La classe d’association Win32_Subdirectory est également utilisée pour gérer les fichiers et dossiers. La classe Win32_Subdirectory associe 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, les journaux ne sont pas considérés comme un sous-dossier de C:\.

Vous pouvez récupérer les propriétés d’un 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 affichées dans le tableau 11.1. Pour récupérer les propriétés d’un dossier unique, construisez une requête WQL (Query Language) Windows pour la classe Win32_Directory, en vous assurant d’inclure le nom du dossier. Par exemple, cette requête se lie 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 du chemin d’accès.

Si vous souhaitez limiter la récupération des 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 sur le lecteur C :

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

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

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

Configuration requise

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