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