_Classe de répertoire Win32

La classe WMI de l' _ Annuaire Win32 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 des fichiers de données et fournit des informations de chemin d’accès pour les fichiers groupés. Exemple : C : \ temp. Win32 _ Le répertoire 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 par ordre alphabétique, et non par 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 de _ répertoire win32 possède les types de membres suivants :

Méthodes

La classe de _ répertoire win32 possède 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.
Dens 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 vers 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 vers l’emplacement spécifié par le paramètre filename .
DELETE 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 a les autorisations agrégées spécifiées par l’argument d' autorisation non seulement sur l’objet de fichier, mais sur le partage sur lequel le fichier ou le répertoire réside (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écompresse le fichier logique (ou le répertoire) spécifié dans le chemin d’accès de l’objet.
UncompressEx Méthode de classe qui décompresse le fichier logique (ou le répertoire) spécifié dans le chemin d’accès de l’objet.

Propriétés

La classe de _ répertoire win32 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 binaire qui représente les droits d’accès requis pour accéder ou effectuer des opérations spécifiques sur l’annuaire. Pour les valeurs de bit, consultez constantes de droits d’accès aux fichiers et aux répertoires.

Notes

Sur les volumes FAT, la valeur d' _ accès complet 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 la _ LogicalFile CIM.

Fichier _ LIRE les _ données (fichier) ou _ _ Répertoire de liste de fichiers (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.

Fichier _ ÉCRIRE des _ données (fichier) ou _ Ajouter un fichier _ (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.

Fichier _ Ajouter des _ données (fichier) ou _ un _ sous-répertoire d’ajout de fichier (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.

Fichier _ LIRE _ EA (8)

Accorde le droit de lire les attributs étendus.

Fichier _ ÉCRIRE _ EA (16)

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

Fichier _ EXECUTe (file) ou FILE _ Traversal (Directory) (32)

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

Fichier _ SUPPRIMER un _ enfant (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.

Fichier _ _Attributs de lecture (128)

Accorde le droit de lire les attributs du fichier.

Fichier _ _Attributs d’écriture (256)

Accorde le droit de modifier les attributs de fichier.

Supprimer (65536)

Octroie l’accès en suppression.

Lecture _ CONTRÔLE (131072)

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

Écriture _ DAC (262144)

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

Écriture _ PROPRIÉTAIRE (524288)

Affecte le propriétaire de l’écriture.

Synchroniser (1048576)

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

Accès _ _Sécurité du système (18809343)

Contrôle la capacité à récupérer ou à définir la liste 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 d’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 la _ LogicalFile CIM.

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 la _ LogicalFile CIM.

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. Si ce n’est pas possible (ou n’est pas 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 que le fichier logique est compressé ou non ; « Compressed » pour représenter le fait que le fichier est compressé, mais que son schéma de compression n’est pas connu ou qu’il n’est pas divulgué ; et « non compressés » pour indiquer que le fichier logique n’est pas compressé.

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

CreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : _ clé CIM, DisplayName ("nom de la classe")

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 la _ LogicalFile CIM.

CreationDate

Type de données : DateTime

Type d'accès : Lecture seule

Qualificateurs : DisplayName ("date de création")

Date à laquelle l’objet système de fichiers a été créé. 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 la _ LogicalFile CIM.

CSCreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : propagés ("_ système de fichiers CIM.CSCreationClassName"), _ clé CIM, DisplayName (" Computer System Class Name ")

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

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

CSName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : propagés ("_ système de fichiers CIM.CSName"), _ clé CIM, DisplayName (" nom du système de l’ordinateur ")

Nom de l’ordinateur où est stocké l’objet de système de fichiers.

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

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 : fixed, Schema ("Win32"), DisplayName ("Drive")

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

Exemple : "c :"

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

EightDotThreeFileName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Schema ("Win32"), DisplayName ("huit point trois nom de fichier")

Nom compatible MS-DOS pour le dossier.

Exemple : « c : \ PROGRA ~ 1 »

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

Chiffré

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : Schema ("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 la _ LogicalFile CIM.

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. Si ce n’est pas possible (ou n’est pas souhaité) de décrire le schéma de chiffrement (pour des raisons de sécurité, par exemple), utilisez les mots suivants : « inconnu » pour indiquer qu’il est impossible de savoir si le fichier logique est chiffré ; « Chiffré » pour représenter le chiffrement du fichier, mais son schéma de chiffrement n’est pas connu ou n’est pas divulgué ; et « non chiffrés » pour représenter le fait que le fichier logique n’est pas chiffré.

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

Extension

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : fixed, Schema ("Win32"), DisplayName ("extension de fichier")

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

Exemples : "txt", "MOF", "mdb"

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

FileName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : fixed, Schema ("Win32"), DisplayName ("file name")

Nom de fichier (sans le point ou l’extension) du fichier.

Exemple : « Autoexec »

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

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 des valeurs UInt64 dans les scripts, consultez scripts dans WMI.

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

FileType

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Schema ("Win32"), DisplayName ("type de fichier")

Type de fichier (indiqué par la propriété d' 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 comme dossiers.

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

FSCreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : propagés ("_ système de fichiers CIM.CreationClassName"), _ clé CIM, DisplayName (" nom de la classe du système de fichiers ")

Classe du système de fichiers.

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

FSName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : propagés ("_ système de fichiers CIM.Name"), _ clé CIM, 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 la _ LogicalFile CIM.

Hidden

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : schéma (« Win32 »), DisplayName (« masqué »)

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

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

InstallDate

Type de données : DateTime

Type d'accès : Lecture seule

Qualificateurs : MappingStrings ("MIF. DMTF | ComponentID | 001,5 "), DisplayName (" date d’installation ")

Indique le moment où l’objet a été installé. L’absence de 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 actuel de fichiers ouverts »)

Nombre de « ouvertures de fichier » actuellement actives sur le fichier.

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

Pour plus d’informations sur l’utilisation des valeurs UInt64 dans les scripts, consultez 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 la _ LogicalFile CIM.

LastModified

Type de données : DateTime

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Last modified »)

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 la _ LogicalFile CIM.

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é à 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 \ système \win.ini

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

Chemin d’accès

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : fixed, Schema ("Win32"), DisplayName ("path")

Chemin d’accès du fichier. Le chemin d’accès comprend les barres obliques inverses de début et de fin, mais pas la lettre de lecteur ou le nom de 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 la _ LogicalFile CIM.

R.a.

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : DisplayName ("readed")

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 la _ LogicalFile CIM.

État

Type de données : chaîne

Type d'accès : Lecture seule

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

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

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 la _ LogicalFile CIM.

Inscriptible

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« inscriptible »)

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

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

Remarques

La classe de _ répertoire win32 est dérivée du _ répertoire CIM.

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 sont similaires. Au lieu de cela, les dossiers peuvent varier considérablement. Certains dossiers sont des dossiers du 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 qu’ils ne peuvent pas ajouter, supprimer ou modifier ces contenus. Certains dossiers sont compressés pour un stockage optimal, tandis que d’autres sont masqués et invisibles pour les utilisateurs.

WMI utilise la classe de _ répertoire win32 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 aux méthodes disponibles dans la classe de _ fichier de fichier CIM , 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 pouvez, sans aucun travail supplémentaire, savoir comment gérer les fichiers.

La classe d’association de _ sous-répertoire win32 est également utilisée pour gérer des fichiers et des dossiers. La classe de _ sous-répertoire win32 lie un dossier et ses sous-dossiers immédiats. Par exemple, dans la structure de dossiers C : \ scripts \ journaux, 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 de n’importe quel dossier dans le système de fichiers à l’aide de la classe de _ répertoire win32 . 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 seul dossier, construisez une requête WQL (Windows query Language) pour la classe de _ répertoire Win32 , en veillant à 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 du chemin.

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 renvoie 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 d’un ordinateur, sachez que cette requête peut prendre plus de 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

Configuration requise

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

_Répertoire CIM

Classes du système d’exploitation