_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
CIMWin32. mof
DLL
CIMWin32.dll

Voir aussi

_LOGICALFILE CIM

Tâches WMI : fichiers et dossiers

Constantes de droits d’accès aux fichiers et aux répertoires