Classe CIM_DataFile

Articolo
11/30/2023

La classe CIM_DataFile rappresenta una raccolta denominata di dati o codice eseguibile. Verranno restituite solo le istanze di file nei dischi fissi locali.

Importante

Le classi CIM (Distributed Management Task Force) (Common Information Model) DMTF (Distributed Management Task Force) sono le classi padre su cui vengono compilate le classi WMI. WMI supporta attualmente solo gli schemi di versione CIM 2.x.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà sono elencate in ordine alfabetico, non in ordine MOF.

Sintassi

[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;
};

Membri

La classe CIM_DataFile include questi tipi di membri:

Metodi
Proprietà

Metodi

La classe CIM_DataFile dispone di questi metodi.

Metodo	Descrizione
ChangeSecurityPermissions	Modifica le autorizzazioni di sicurezza per il file logico specificato nel percorso dell'oggetto. Implementato da WMI.
ChangeSecurityPermissionsEx	Modifica le autorizzazioni di sicurezza per il file logico specificato nel percorso dell'oggetto. Implementato da WMI.
Compressione	Usa la compressione NTFS per comprimere il file logico (o la directory) specificato nel percorso dell'oggetto. Implementato da WMI.
CompressEx	Comprime il file logico (o la directory) specificato nel percorso dell'oggetto. Implementato da WMI.
Copia	Copia il file logico (o la directory) specificato nel percorso dell'oggetto nel percorso dell'oggetto specificato dal parametro di input. Implementato da WMI.
CopyEx	Copia il file logico (o la directory) specificato nel percorso dell'oggetto nel percorso dell'oggetto specificato dal parametro di input. Implementato da WMI.
CANC	Elimina il file logico (o la directory) specificato nel percorso dell'oggetto. Implementato da WMI.
DeleteEx	Elimina il file logico (o la directory) specificato nel percorso dell'oggetto. Implementato da WMI.
GetEffectivePermission	Determina se il chiamante dispone delle autorizzazioni aggregate specificate dall'argomento Permission . Implementato da WMI.
Rinomina	Rinomina il file logico (o la directory) specificato nel percorso dell'oggetto. Implementato da WMI.
TakeOwnerShip	Ottiene la proprietà del file logico specificato nel percorso dell'oggetto. Implementato da WMI.
TakeOwnerShipEx	Ottiene la proprietà del file logico specificato nel percorso dell'oggetto. Implementato da WMI.
Decomprimere	Decomprime il file logico (o la directory) specificato nel percorso dell'oggetto. Implementato da WMI.
UncompressEx	Decomprime il file logico (o la directory) specificato nel percorso dell'oggetto. Implementato da WMI.

Proprietà

La classe CIM_DataFile ha queste proprietà.

Accessmask

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: Schema ("Win32"), DisplayName ("Diritti di accesso")

Maschera di bit che rappresenta i diritti di accesso necessari per accedere o eseguire operazioni specifiche sul file. Per i valori di bit, vedere Costanti diritti di accesso file e directory.

Nota

Nei volumi FAT, viene restituito il valore FULL_ACCESS , che indica che non è stata impostata alcuna sicurezza nell'oggetto .

Questa proprietà viene ereditata da CIM_LogicalFile.

FILE_READ_DATA (file) o FILE_LIST_DIRECTORY (directory) (1)

FILE_WRITE_DATA (file) o FILE_ADD_FILE (directory) (2)

FILE_APPEND_DATA (file) o FILE_ADD_SUBDIRECTORY (directory) (4)

FILE_READ_EA (8)

FILE_WRITE_EA (16)

FILE_EXECUTE (file) o FILE_TRAVERedizione Standard (directory) (32)

FILE_DELETE_CHILD (directory) (64)

FILE_READ_ATTRIBUTES (128)

FILE_WRITE_ATTRIBUTES (256)

DELETE (65536)

READ_CONTROL (131072)

WRITE_DAC (262144)

WRITE_OWNER (524288)

SYNCHRONIZE (1048576)

Archiviazione

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: schema ("Win32"), DisplayName ("Deve essere archiviato")

Se True, il file deve essere archiviato.

Questa proprietà viene ereditata da CIM_LogicalFile.

Caption

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MaxLen (64), DisplayName ("Caption")

Breve descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Compressed

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: schema ("Win32"), DisplayName ("compresso")

Se True, il file viene compresso.

Questa proprietà viene ereditata da CIM_LogicalFile.

CompressionMethod

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Metodo di compressione")

Stringa in formato libero che indica l'algoritmo o lo strumento usato per comprimere il file logico. Se lo schema di compressione è sconosciuto o non descritto, usare "Sconosciuto". Se il file logico è compresso, ma lo schema di compressione è sconosciuto o non descritto, usare "Compressed". Se il file logico non è compresso, usare "Non compresso".

Questa proprietà viene ereditata da CIM_LogicalFile.

CreationClassName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: CIM_Key, DisplayName ("Nome classe")

Nome della classe.

Questa proprietà viene ereditata da CIM_LogicalFile.

CreationDate

Tipo di dati: datetime
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Data creazione")

Data e ora della creazione del file.

Questa proprietà viene ereditata da CIM_LogicalFile.

CSCreationClassName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: propagati ("CIM_FileSystem.CSCreationClassName"), CIM_Key, DisplayName ("Computer System Class Name")

Classe del sistema informatico.

Questa proprietà viene ereditata da CIM_LogicalFile.

CSName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: propagati ("CIM_FileSystem.CSName"), CIM_Key, DisplayName ("Nome sistema computer")

Nome del sistema del computer.

Questa proprietà viene ereditata da CIM_LogicalFile.

Descrizione

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Description")

Descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Guida

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Fisso, Schema ("Win32"), DisplayName ("Unità")

Lettera di unità (inclusi i due punti che seguono la lettera di unità) del file.

Esempio: "c:"

Questa proprietà viene ereditata da CIM_LogicalFile.

EightDotThreeFileName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Schema ("Win32"), DisplayName ("Eight Dot Three File Name")

Nome file compatibile con DOS.

Esempio: "c:\progra~1"

Questa proprietà viene ereditata da CIM_LogicalFile.

Crittografata

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: Schema ("Win32"), DisplayName ("Encrypted")

Se True, il file viene crittografato.

Questa proprietà viene ereditata da CIM_LogicalFile.

Encryptionmethod

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Metodo di crittografia")

Stringa in formato libero che identifica l'algoritmo o lo strumento usato per crittografare un file logico. Se lo schema di crittografia non è indulgente (per motivi di sicurezza, ad esempio), usare "Sconosciuto". Se il file è crittografato, ma il relativo schema di crittografia è sconosciuto o non divulgato, usare "Encrypted". Se il file logico non è crittografato, usare "Non crittografato".

Questa proprietà viene ereditata da CIM_LogicalFile.

Estensione

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Fixed, Schema ("Win32"), DisplayName ("Estensione file")

Estensione del nome file senza il punto precedente (punto).

Esempio: "txt", "mof", "mdb"

Questa proprietà viene ereditata da CIM_LogicalFile.

FileName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Fixed, Schema ("Win32"), DisplayName ("File Name")

Nome file senza l'estensione del nome file. Esempio: "MyDataFile"

Questa proprietà viene ereditata da CIM_LogicalFile.

Dimensione

Tipo di dati: uint64
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Dimensioni"), Unità ("byte")

Dimensioni del file, in byte.

Per altre informazioni sull'uso di valori uint64 negli script, vedere Scripting in WMI.

Questa proprietà viene ereditata da CIM_LogicalFile.

Filetype

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Schema ("Win32"), DisplayName ("Tipo di file")

Descrittore che rappresenta il tipo di file indicato dalla proprietà Extension .

Questa proprietà viene ereditata da CIM_LogicalFile.

FSCreationClassName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: propagati ("CIM_FileSystem.CreationClassName"), CIM_Key, DisplayName ("Nome classe file system")

Classe del file system.

Questa proprietà viene ereditata da CIM_LogicalFile.

FSName

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: propagati ("CIM_FileSystem.Name"), CIM_Key, DisplayName ("Nome file system")

Nome del file system.

Questa proprietà viene ereditata da CIM_LogicalFile.

Hidden

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: Schema ("Win32"), DisplayName ("Hidden")

Se True, il file è nascosto.

Questa proprietà viene ereditata da CIM_LogicalFile.

InstallDate

Tipo di dati: datetime
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("MIF. DMTF |ComponentID|001.5"), DisplayName ("Data di installazione")

Indica quando l'oggetto è stato installato. La mancanza di un valore non indica che l'oggetto non è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

InUseCount

Tipo di dati: uint64
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Conteggio apertura file corrente")

Numero di "file aperti" attualmente attivi nel file.

Per altre informazioni sull'uso di valori uint64 negli script, vedere Scripting in WMI.

Questa proprietà viene ereditata da CIM_LogicalFile.

LastAccessed

Tipo di dati: datetime
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Ultimo accesso")

Data e ora dell'ultimo accesso al file.

Questa proprietà viene ereditata da CIM_LogicalFile.

LastModified

Tipo di dati: datetime
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Ultima modifica")

Data e ora dell'ultima modifica del file.

Questa proprietà viene ereditata da CIM_LogicalFile.

Produttore

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Schema ("Win32"), DisplayName ("Manufacturer")

Stringa del produttore dalla risorsa della versione (se presente).

Nome

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Chiave

La proprietà Name è una stringa che rappresenta il nome ereditato che funge da chiave di un'istanza di file logica all'interno di un file system. È necessario specificare i nomi completi dei percorsi.

Esempio: C:\Windows\system\win.ini

Questa proprietà viene ereditata da CIM_LogicalFile.

Percorso

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Fixed, Schema ("Win32"), DisplayName ("Path")

Percorso del file che include le barre rovesciata iniziali e finali. Esempio: "\windows\system\"

Questa proprietà viene ereditata da CIM_LogicalFile.

Leggibile

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("leggibile")

Se True, il file può essere letto.

Questa proprietà viene ereditata da CIM_LogicalFile.

Stato

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: MaxLen (10), DisplayName ("Status")

Stringa che indica lo stato corrente dell'oggetto. È possibile definire lo stato operativo e non operativo. Lo stato operativo può includere "OK", "Danneggiato" e "Pred Fail". "Pred Fail" indica che un elemento funziona correttamente, ma prevede un errore (ad esempio, un'unità disco rigido abilitata per SMART).

Lo stato non operativo può includere "Error", "Starting", "Stopping" e "Service". Il "servizio" può essere applicato durante il ridimensionamento del mirroring del disco, il ricaricamento di un elenco di autorizzazioni utente o altre operazioni amministrative. Non tutte queste operazioni sono online, ma l'elemento gestito non è né "OK" né in uno degli altri stati.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sono inclusi i valori seguenti:

OK ("OK ")

Errore ("Errore ")

Degradato ("degradato")

Sconosciuto ("Sconosciuto")

Pred Fail ("Pred Fail ")

Avvio ("Starting ")

Arresto ("arresto ")

Servizio ("Servizio")

Sottolineato ("sottolineato ")

NonRecover ("NonRecover ")

Nessun contatto ("Nessun contatto ")

Lost Comm ("Lost Comm ")

Di sistema

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: Schema ("Win32"), DisplayName ("File di sistema")

Se True, il file è un file di sistema.

Questa proprietà viene ereditata da CIM_LogicalFile.

Versione

Tipo di dati: string
Tipo di accesso: sola lettura
Qualificatori: Schema ("Win32"), DisplayName ("Version")

Stringa di versione dalla risorsa di versione (se presente).

Scrivibile

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Scrivibile")

Se True, il file può essere scritto.

Questa proprietà viene ereditata da CIM_LogicalFile.

Osservazioni:

La classe CIM_DataFile deriva da CIM_LogicalFile.

WMI implementa la classe CIM_DataFile e tutti i relativi metodi. La classe CIM_DataFile è una classe dinamica.

Questa documentazione è derivata dalle descrizioni delle classi CIM pubblicate da DMTF. Microsoft potrebbe aver apportato modifiche agli errori secondari corretti, conformi agli standard della documentazione di Microsoft SDK o fornire altre informazioni.

A causa di scopi di sicurezza, WMI non supporta direttamente la chiamata a un computer remoto e indica a esso di copiare i file in se stesso. Tuttavia, è possibile usare il linguaggio di programmazione pertinente per chiamare FTP o RoboCopy, ad esempio.

Esempi

Nell'esempio di codice VBS seguente viene descritto come eseguire una ricerca con caratteri jolly standard in un file di dati. Si noti che i delimitatori barra rovesciata devono essere preceduti da un'altra barra rovesciata (\\). Inoltre, quando si usa "CIM_DataFile.FileName" nella clausola WHERE, il processo WMIPRV edizione Standard analizzerà tutte le directory in qualsiasi dispositivo di archiviazione disponibile. Questo potrebbe richiedere del tempo, soprattutto se sono state mappate condivisioni remote e possono attivare avvisi 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

Il frammento di codice seguente limita l'intervallo di ricerca a un'unità, un percorso e un'estensione di file specifici.

Set colFiles = objWMIService.ExecQuery("Select * from CIM_DataFile where Drive='"C:"' And Path='"\\"' and Name Like '%~%' and Extension='doc' ")

Nell'esempio di codice di PowerShell seguente viene recuperato un singolo valore di attributo.

 $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 }

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Spazio dei nomi	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

CIM_LogicalFile
Attività WMI: file e cartelle
Costanti diritti di accesso a file e directory

Condividi tramite

Classe CIM_DataFile

Sintassi

Membri

Metodi

Proprietà

Osservazioni:

Esempi

Requisiti

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive