Classe CIM_DataFile
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
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 |
|
| DLL |
|
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per