_Classe de fichier de fichier CIM
La classe de _ fichier de données CIM représente une collection nommée de données ou du code exécutable. Seules les instances de fichiers sur des disques fixes locaux sont retournées.
Important
Les classes de la DMTF (Distributed Management Task Force) CIM (Common Information Model) sont les classes parentes sur lesquelles les classes WMI sont générées. WMI ne prend actuellement en charge que les schémas de version CIM 2. x.
La syntaxe suivante est simplifiée à partir de code au format 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("{8502C55A-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("All Files (CIM)"), AMENDMENT]
class CIM_DataFile : CIM_LogicalFile
{
string Caption;
string Description;
datetime InstallDate;
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 Name;
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;
string Manufacturer;
string Version;
};
Membres
La classe de _ fichier de fichier CIM possède les types de membres suivants :
Méthodes
La classe de _ fichier de fichier CIM possède ces méthodes.
| Méthode | Description |
|---|---|
| ChangeSecurityPermissions | Modifie les autorisations de sécurité pour le fichier logique spécifié dans le chemin d’accès de l’objet. Implémenté par WMI. |
| ChangeSecurityPermissionsEx | Modifie les autorisations de sécurité pour le fichier logique spécifié dans le chemin d’accès de l’objet. Implémenté par WMI. |
| Dens | Utilise la compression NTFS pour compresser le fichier logique (ou le répertoire) spécifié dans le chemin d’accès de l’objet. Implémenté par WMI. |
| CompressEx | Compresse le fichier logique (ou le répertoire) spécifié dans le chemin d’accès de l’objet. Implémenté par WMI. |
| Copier | 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. Implémenté par WMI. |
| CopyEx | 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. Implémenté par WMI. |
| Supprimer | Supprime le fichier logique (ou le répertoire) spécifié dans le chemin d’accès de l’objet. Implémenté par WMI. |
| DeleteEx | Supprime le fichier logique (ou le répertoire) spécifié dans le chemin d’accès de l’objet. Implémenté par WMI. |
| GetEffectivePermission | Détermine si l’appelant dispose des autorisations agrégées spécifiées par l’argument d' autorisation . Implémenté par WMI. |
| Renommer | Renomme le fichier logique (ou le répertoire) spécifié dans le chemin d’accès de l’objet. Implémenté par WMI. |
| TakeOwnerShip | Obtient la propriété du fichier logique spécifié dans le chemin d’accès de l’objet. Implémenté par WMI. |
| TakeOwnerShipEx | Obtient la propriété du fichier logique spécifié dans le chemin d’accès de l’objet. Implémenté par WMI. |
| Décompresser | Décompresse le fichier logique (ou le répertoire) spécifié dans le chemin d’accès de l’objet. Implémenté par WMI. |
| UncompressEx | Décompresse le fichier logique (ou le répertoire) spécifié dans le chemin d’accès de l’objet. Implémenté par WMI. |
Propriétés
La classe de _ fichier de fichier CIM 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 le fichier. 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)
-
Fichier _ ÉCRIRE des _ données (fichier) ou _ Ajouter un fichier _ (répertoire) (2)
-
Fichier _ Ajouter des _ données (fichier) ou un fichier _ Ajouter un _ sous-répertoire (répertoire) (4)
-
Fichier _ LIRE _ EA (8)
-
Fichier _ ÉCRIRE _ EA (16)
-
Fichier _ EXECUTe (file) ou FILE _ Traversal (Directory) (32)
-
Fichier _ SUPPRIMER un _ enfant (répertoire) (64)
-
Fichier _ _Attributs de lecture (128)
-
Fichier _ _Attributs d’écriture (256)
-
Supprimer (65536)
-
Lecture _ CONTRÔLE (131072)
-
Écriture _ DAC (262144)
-
Écriture _ PROPRIÉTAIRE (524288)
-
Synchroniser (1048576)
Archive
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : schéma (« Win32 »), DisplayName (« doit être archivé »)
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é »)
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 »)
Chaîne de forme libre qui indique l’algorithme ou l’outil utilisé pour compresser le fichier logique. Si le schéma de compression est inconnu ou n’est pas décrit, utilisez « inconnu ». Si le fichier logique est compressé, mais que le schéma de compression est inconnu ou non décrit, utilisez « compressé ». Si le fichier logique n’est pas compressé, utilisez « non 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 classe.
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 et heure de création du fichier.
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 ")
Classe du système informatique.
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 du système informatique.
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 (y compris le signe deux-points qui suit la lettre de lecteur) du fichier.
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 de fichier compatible DOS.
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")
Si la valeur est true, le fichier 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 »)
Chaîne de forme libre qui identifie l’algorithme ou l’outil utilisé pour chiffrer un fichier logique. Si le schéma de chiffrement n’est pas indulged (pour des raisons de sécurité, par exemple), utilisez « inconnu ». Si le fichier est chiffré, mais que son schéma de chiffrement est inconnu ou non divulgué, utilisez « chiffré ». Si le fichier logique n’est pas chiffré, utilisez « non 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 sans le point précédent (point).
Exemple : "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 l’extension de nom de fichier. Exemple : « MyDataFile »
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 du fichier en octets.
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")
Descripteur qui représente le type de fichier indiqué par la propriété d' extension .
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 ")
Nom du système de fichiers.
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é »)
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.
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.
LastAccessed
-
Type de données : DateTime
-
Type d'accès : Lecture seule
-
Qualificateurs : DisplayName (« dernier accès »)
Date et heure du dernier accès au fichier.
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 et heure de la dernière modification du fichier.
Cette propriété est héritée de la _ LogicalFile CIM.
Fabricant
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Schema ("Win32"), DisplayName ("Manufacturer")
Chaîne du fabricant de la ressource de version (le cas échéant).
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, y compris les barres obliques inverses de début et de fin. Exemple : « \ \ système Windows \ »
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")
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. L’état opérationnel et non opérationnel peut être défini. L’état opérationnel peut inclure « OK », « détérioré » et « échec prédit ». « Échec prédit » indique qu’un élément fonctionne correctement, mais prédit un échec (par exemple, un lecteur de disque dur intelligent).
L’état non opérationnel peut inclure « erreur », « démarrage », « arrêt » et « service ». Le « service » peut s’appliquer pendant la mise en miroir de disques, en rechargeant 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 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 »)
Si la valeur est true, le fichier est un fichier système.
Cette propriété est héritée de la _ LogicalFile CIM.
Version
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Schema ("Win32"), DisplayName ("version")
Chaîne de version de la ressource de version (le cas échéant).
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.
Notes
La classe de _ fichier de fichier CIM est dérivée de CIM _ LogicalFile.
WMI implémente la classe de _ fichier de fichier CIM et toutes ses méthodes. La classe de _ fichier de fichier CIM est une classe dynamique.
Cette documentation est dérivée des descriptions de classe CIM publiées par le DMTF. Microsoft peut avoir apporté des modifications pour corriger les erreurs mineures, se conformer aux normes de documentation du kit de développement logiciel (SDK) Microsoft ou fournir plus d’informations.
En raison de la sécurité, WMI ne prend pas directement en charge l’appel d’un ordinateur distant et lui demande de copier des fichiers vers lui-même. Toutefois, vous pouvez utiliser le langage de programmation approprié pour appeler FTP ou RoboCopy, par exemple.
Exemples
L' exemple de code du centre de script suivant utilise une classe de fichier de _ fichier CIM dans le cadre d’une application plus volumineuse pour générer des rapports d’environnement Exchange à l’aide de PowerShell.
L’exemple de code Rechercher des fichiers avec WMI PowerShell dans la Galerie TechNet utilise un fichier de _ fichier CIM pour rechercher un ou plusieurs fichiers sur plusieurs ordinateurs.
L’exemple de code VBS suivant décrit comment effectuer une recherche par caractères génériques standard sur un fichier de fichier. Notez que les séparateurs de la barre oblique inverse doivent être placés dans une séquence d’échappement avec une autre barre oblique inverse ( \ \ ). En outre, lors de l’utilisation de «**_ fichier de fichier CIM**.FileName» dans la clause WHERE, le processus Wmiprvse analyse tous les répertoires sur les périphériques de stockage disponibles. Cela peut prendre un certain temps, surtout si vous avez mappé des partages distants et peut déclencher des avertissements antivirus.
strComputer = "."
Set objWMIService = GetObject("winmgmts:" & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFiles = objWMIService.ExecQuery("Select * from CIM_DataFile where FileName Like '%~%'")
For Each objFile in colFiles
Wscript.Echo objFile.Name
Next
L’extrait de code suivant limite la plage de recherche à un lecteur, un chemin d’accès et une extension de fichier spécifiques.
Set colFiles = objWMIService.ExecQuery("Select * from CIM_DataFile where Drive='"C:"' And Path='"\\"' and Name Like '%~%' and Extension='doc' ")
L’exemple de code PowerShell suivant récupère une valeur d’attribut unique.
$computer = "."
$path = "C:\\Program Files\\Microsoft SQL Server\\MSSQL.1\\MSSQL\\LOG\\"
$filename = "ERRORLOG"
$fullname = $path + $filename
$wql = 'SELECT Archive FROM CIM_DataFile WHERE Name = "' + $fullname + '"'
Get-WmiObject -ComputerName $computer -Query $wql | foreach { $_.Archive }
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 |
|