CIM_DataFile classe

  • Article

La classe CIM_DataFile représente une collection nommée de données ou de code exécutable. Seules les instances de fichiers sur des disques fixes locaux seront retournées.

Important

Les classes CIM (Common Information Model) DMTF (Distributed Management Task Force) sont les classes parentes sur lesquelles les classes WMI sont créées. WMI prend actuellement uniquement en charge 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 dans l’ordre alphabétique, et non dans l’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 CIM_DataFile a les types de membres suivants :

Méthodes

La classe CIM_DataFile a 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.
Compresser 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 répertoire) spécifié dans le chemin d’accès de l’objet. Implémenté par WMI.
Copier Copie le fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet à l’emplacement spécifié par le paramètre d’entrée. Implémenté par WMI.
CopyEx Copie le fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet à l’emplacement spécifié par le paramètre d’entrée. Implémenté par WMI.
Supprimer Supprime le fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet. Implémenté par WMI.
DeleteEx Supprime le fichier logique (ou 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 Permission . Implémenté par WMI.
Renommer Renomme le fichier logique (ou 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 Annule la copie du fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet. Implémenté par WMI.
UncompressEx Annule la copie du fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet. Implémenté par WMI.

Propriétés

La classe CIM_DataFile 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 nécessaires pour accéder ou effectuer des opérations spécifiques sur le fichier. Pour les valeurs de bits, consultez Constantes des droits d’accès aux fichiers et aux répertoires.

Notes

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)

FILE_WRITE_DATA (fichier) ou FILE_ADD_FILE (répertoire) (2)

FILE_APPEND_DATA (fichier) ou FILE_ADD_SUBDIRECTORY (répertoire) (4)

FILE_READ_EA (8)

FILE_WRITE_EA (16)

FILE_EXECUTE (fichier) ou FILE_TRAVERSE (répertoire) (32)

FILE_DELETE_CHILD (répertoire) (64)

FILE_READ_ATTRIBUTES (128)

FILE_WRITE_ATTRIBUTES (256)

DELETE (65536)

READ_CONTROL (131072)

WRITE_DAC (262144)

WRITE_OWNER (524288)

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

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

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 non 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 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 classe.

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 et heure de création du fichier.

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 classe système de l’ordinateur »)

Classe du système informatique.

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 système de l’ordinateur »)

Nom du système informatique.

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.

Disque

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Fixe, Schéma (« Win32 »), DisplayName (« Lecteur »)

Lettre de lecteur (y compris les deux-points qui suivent la lettre de lecteur) du fichier.

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 (« Nom de fichier à huit points trois »)

Nom de fichier compatible DOS.

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 : Schema (« Win32 »), DisplayName (« Encrypted »)

Si la valeur est True, le fichier 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 »)

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 appliqué (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 « Encrypted ». Si le fichier logique n’est pas chiffré, utilisez « Non 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 sans le point précédent (point).

Exemple : « 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 l’extension de nom de fichier. Exemple : « MyDataFile »

Cette propriété est héritée de CIM_LogicalFile.

FileSize

Type de données : uint64

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Taille »), Unités (« octets »)

Taille du fichier en octets.

Pour plus d’informations sur l’utilisation de valeurs uint64 dans des scripts, voir Scripts dans 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 »)

Descripteur qui représente le type de fichier indiqué par la propriété Extension .

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 classe du 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 »)

Nom du système de fichiers.

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

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 « fichier s’ouvre » actuellement actifs sur le fichier.

Pour plus d’informations sur l’utilisation de valeurs uint64 dans des scripts, voir Scripts dans WMI.

Cette propriété est héritée de CIM_LogicalFile.

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 CIM_LogicalFile.

LastModified

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Dernière modification »)

Date et heure de la dernière modification du fichier.

Cette propriété est héritée de CIM_LogicalFile.

Fabricant

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« Fabricant »)

Chaîne du fabricant à partir de la ressource de version (le cas échéant).

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Key

La propriété Name est une chaîne représentant le nom hérité qui sert de clé d’un fichier logique instance 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 du fichier, y compris les barres obliques inverses de début et de fin. Exemple : « \windows\system\ »

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

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

Chaîne qui indique la status actuelle de l’objet. Il est possible de définir des status opérationnels et non opérationnels. Les status opérationnelles peuvent inclure « OK », « Détérioré » et « Échec anticipé ». « Échec anticipé » indique qu’un élément fonctionne correctement, mais qu’il prédit une défaillance (par exemple, un disque dur smart).

Les status non opérationnelles peuvent inclure « Error », « Starting », « Stopping » et « Service ». « Service » peut s’appliquer pendant la miroir disque, le rechargement d’une liste d’autorisations utilisateur ou tout autre travail administratif. Tous ces travaux ne sont pas en ligne, mais l’élément managé n’est ni « OK » ni dans 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égradé (« Dégradé »)

Inconnu (« Inconnu »)

Échec du prédé (« Échec anticipé »)

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

Si la valeur est True, le fichier est un fichier système.

Cette propriété est héritée de CIM_LogicalFile.

Version

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Schéma (« 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 (« Accessible en écriture »)

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

Cette propriété est héritée de CIM_LogicalFile.

Notes

La classe CIM_DataFile est dérivée de CIM_LogicalFile.

WMI implémente la classe CIM_DataFile et toutes ses méthodes. La classe CIM_DataFile est une classe dynamique.

Cette documentation est dérivée des descriptions de classes CIM publiées par le DMTF. Microsoft a peut-être apporté des modifications pour corriger des erreurs mineures, se conformer aux normes de documentation du Kit de développement logiciel (SDK) Microsoft ou fournir des informations supplémentaires.

Pour des raisons de sécurité, WMI ne prend pas directement en charge l’appel d’un ordinateur distant et l’instruction de copier des fichiers sur lui-même. Toutefois, vous pouvez utiliser le langage de programmation approprié pour appeler FTP ou RoboCopy, par exemple.

Exemples

L’exemple de code centre de script suivant utilise une classe CIM_DataFile dans le cadre d’une application plus grande pour générer des rapports d’environnement exchange à l’aide de PowerShell.

L’exemple de code Rechercher des fichiers avec WMI PowerShell dans TechNet Gallery utilise une CIM_DataFile pour rechercher un ou plusieurs fichiers sur plusieurs ordinateurs.

L’exemple de code VBS suivant décrit comment effectuer une recherche générique standard sur un fichier de données. Notez que les délimiteurs de 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 « CIM_DataFile. FileName » dans la clause WHERE, le processus WMIPRVSE analyse tous les répertoires sur n’importe quel périphérique de stockage disponible. Cela peut prendre un certain temps, en particulier 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
 Racine\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Voir aussi

CIM_LogicalFile

Tâches WMI : fichiers et dossiers

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