kelas CIM_DataFile

Artikel
11/10/2023

Kelas CIM_DataFile mewakili kumpulan data bernama atau kode yang dapat dieksekusi. Hanya instans file pada disk tetap lokal yang akan dikembalikan.

Penting

Kelas CIM (Model Informasi Umum) DMTF (Distributed Management Task Force) adalah kelas induk tempat kelas WMI dibangun. WMI saat ini hanya mendukung skema versi CIM 2.x.

Sintaks berikut disederhanakan dari kode Managed Object Format (MOF) dan menyertakan semua properti yang diwariskan. Properti tercantum dalam urutan alfabet, bukan urutan MOF.

Sintaks

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

Anggota

Kelas CIM_DataFile memiliki jenis anggota ini:

Metode
Properti

Metode

Kelas CIM_DataFile memiliki metode ini.

Metode	Deskripsi
ChangeSecurityPermissions	Mengubah izin keamanan untuk file logis yang ditentukan di jalur objek. Diimplementasikan oleh WMI.
ChangeSecurityPermissionsEx	Mengubah izin keamanan untuk file logis yang ditentukan di jalur objek. Diimplementasikan oleh WMI.
Kompres	Menggunakan kompresi NTFS untuk mengompresi file logis (atau direktori) yang ditentukan dalam jalur objek. Diimplementasikan oleh WMI.
CompressEx	Mengompresi file logis (atau direktori) yang ditentukan dalam jalur objek. Diimplementasikan oleh WMI.
Salinan	Menyalin file logis (atau direktori) yang ditentukan dalam jalur objek ke lokasi yang ditentukan oleh parameter input. Diimplementasikan oleh WMI.
CopyEx	Menyalin file logis (atau direktori) yang ditentukan dalam jalur objek ke lokasi yang ditentukan oleh parameter input. Diimplementasikan oleh WMI.
Hapus	Menghapus file logis (atau direktori) yang ditentukan dalam jalur objek. Diimplementasikan oleh WMI.
DeleteEx	Menghapus file logis (atau direktori) yang ditentukan dalam jalur objek. Diimplementasikan oleh WMI.
GetEffectivePermission	Menentukan apakah penelepon memiliki izin agregat yang ditentukan oleh argumen Izin . Diimplementasikan oleh WMI.
Ubah nama	Mengganti nama file logis (atau direktori) yang ditentukan dalam jalur objek. Diimplementasikan oleh WMI.
TakeOwnerShip	Mendapatkan kepemilikan file logis yang ditentukan dalam jalur objek. Diimplementasikan oleh WMI.
TakeOwnerShipEx	Mendapatkan kepemilikan file logis yang ditentukan dalam jalur objek. Diimplementasikan oleh WMI.
Batalkan kompresi	Membongkar file logis (atau direktori) yang ditentukan dalam jalur objek. Diimplementasikan oleh WMI.
UncompressEx	Membongkar file logis (atau direktori) yang ditentukan dalam jalur objek. Diimplementasikan oleh WMI.

Properti

Kelas CIM_DataFile memiliki properti ini.

AccessMask

Jenis data: uint32
Jenis akses: Baca-saja
Kualifikasi: Skema ("Win32"), DisplayName ("Hak Akses")

Bitmask yang mewakili hak akses yang diperlukan untuk mengakses atau melakukan operasi tertentu pada file. Untuk nilai bit, lihat Konstanta Hak Akses File dan Direktori.

Catatan

Pada volume FAT, nilai FULL_ACCESS dikembalikan sebagai gantinya, yang menunjukkan tidak ada keamanan yang telah diatur pada objek.

Properti ini diwariskan dari CIM_LogicalFile.

FILE_READ_DATA (file) atau FILE_LIST_DIRECTORY (direktori) (1)

FILE_WRITE_DATA (file) atau FILE_ADD_FILE (direktori) (2)

FILE_APPEND_DATA (file) atau FILE_ADD_SUBDIRECTORY (direktori) (4)

FILE_READ_EA (8)

FILE_WRITE_EA (16)

FILE_EXECUTE (file) atau FILE_TRAVERSE (direktori) (32)

FILE_DELETE_CHILD (direktori) (64)

FILE_READ_ATTRIBUTES (128)

FILE_WRITE_ATTRIBUTES (256)

HAPUS (65536)

READ_CONTROL (131072)

WRITE_DAC (262144)

WRITE_OWNER (524288)

SINKRONKAN (1048576)

Mengarsipkan

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: Skema ("Win32"), DisplayName ("Harus Diarsipkan")

Jika True, file harus diarsipkan.

Properti ini diwariskan dari CIM_LogicalFile.

Caption

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MaxLen (64), DisplayName ("Keterangan")

Deskripsi tekstual singkat objek.

Properti ini diwariskan dari CIM_ManagedSystemElement.

Dikompresi

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: Skema ("Win32"), DisplayName ("Terkompresi")

Jika True, file dikompresi.

Properti ini diwariskan dari CIM_LogicalFile.

CompressionMethod

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: DisplayName ("Metode Kompresi")

String bentuk bebas yang menunjukkan algoritma atau alat yang digunakan untuk mengompres file logis. Jika skema kompresi tidak diketahui atau tidak dijelaskan, gunakan "Tidak Diketahui". Jika file logis dikompresi, tetapi skema kompresi tidak diketahui atau tidak dijelaskan, gunakan "Terkompresi". Jika file logis tidak dikompresi, gunakan "Tidak Dikompresi".

Properti ini diwariskan dari CIM_LogicalFile.

CreationClassName

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: CIM_Key, DisplayName ("Nama Kelas")

Nama kelas.

Properti ini diwariskan dari CIM_LogicalFile.

CreationDate

Jenis data: tanggalwaktu
Jenis akses: Baca-saja
Kualifikasi: DisplayName ("Tanggal Pembuatan")

Tanggal dan waktu pembuatan file.

Properti ini diwariskan dari CIM_LogicalFile.

CSCreationClassName

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Disebarluaskan ("CIM_FileSystem.CSCreationClassName"), CIM_Key, DisplayName ("Nama Kelas Sistem Komputer")

Kelas sistem komputer.

Properti ini diwariskan dari CIM_LogicalFile.

CSName

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Disebarluaskan ("CIM_FileSystem.CSName"), CIM_Key, DisplayName ("Nama Sistem Komputer")

Nama sistem komputer.

Properti ini diwariskan dari CIM_LogicalFile.

Keterangan

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: DisplayName ("Description")

Deskripsi tekstual objek.

Properti ini diwariskan dari CIM_ManagedSystemElement.

Drive

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Tetap, Skema ("Win32"), DisplayName ("Drive")

Huruf kandar (termasuk titik dua yang mengikuti huruf kandar) file.

Contoh: "c:"

Properti ini diwariskan dari CIM_LogicalFile.

EightDotThreeFileName

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Skema ("Win32"), DisplayName ("Eight Dot Three File Name")

Nama file yang kompatibel dengan DOS.

Contoh: "c:\progra~1"

Properti ini diwariskan dari CIM_LogicalFile.

Dienkripsi

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: Skema ("Win32"), DisplayName ("Dienkripsi")

Jika True, file dienkripsi.

Properti ini diwariskan dari CIM_LogicalFile.

EncryptionMethod

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: DisplayName ("Metode Enkripsi")

String bentuk bebas yang mengidentifikasi algoritma atau alat yang digunakan untuk mengenkripsi file logis. Jika skema enkripsi tidak dimanjakan (misalnya, untuk alasan keamanan), gunakan "Tidak Diketahui". Jika file dienkripsi, tetapi skema enkripsinya tidak diketahui atau tidak diungkapkan, gunakan "Terenkripsi". Jika file logis tidak dienkripsi, gunakan "Tidak Dienkripsi".

Properti ini diwariskan dari CIM_LogicalFile.

Ekstensi

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Tetap, Skema ("Win32"), DisplayName ("Ekstensi File")

Ekstensi nama file tanpa periode sebelumnya (titik).

Contoh: "txt", "mof", "mdb"

Properti ini diwariskan dari CIM_LogicalFile.

FileName

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Tetap, Skema ("Win32"), DisplayName ("Nama File")

Nama file tanpa ekstensi nama file. Contoh: "MyDataFile"

Properti ini diwariskan dari CIM_LogicalFile.

Filesize

Jenis data: uint64
Jenis akses: Baca-saja
Kualifikasi: DisplayName ("Ukuran"), Unit ("byte")

Ukuran file, dalam byte.

Untuk informasi selengkapnya tentang menggunakan nilai uint64 dalam skrip, lihat Pembuatan Skrip di WMI.

Properti ini diwariskan dari CIM_LogicalFile.

FileType

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Skema ("Win32"), DisplayName ("Jenis File")

Deskriptor yang mewakili jenis file yang ditunjukkan oleh properti Ekstensi .

Properti ini diwariskan dari CIM_LogicalFile.

FSCreationClassName

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Disebarluaskan ("CIM_FileSystem.CreationClassName"), CIM_Key, DisplayName ("Nama Kelas Sistem File")

Kelas sistem file.

Properti ini diwariskan dari CIM_LogicalFile.

FSName

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Disebarluaskan ("CIM_FileSystem.Nama"), CIM_Key, DisplayName ("Nama Sistem File")

Nama sistem file.

Properti ini diwariskan dari CIM_LogicalFile.

Tersembunyi

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: Skema ("Win32"), DisplayName ("Tersembunyi")

Jika True, file disembunyikan.

Properti ini diwariskan dari CIM_LogicalFile.

InstallDate

Jenis data: tanggalwaktu
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("MIF. DMTF|ComponentID|001.5"), DisplayName ("Tanggal Penginstalan")

Menunjukkan kapan objek diinstal. Kurangnya nilai tidak menunjukkan bahwa objek tidak diinstal.

Properti ini diwariskan dari CIM_ManagedSystemElement.

InUseCount

Jenis data: uint64
Jenis akses: Baca-saja
Kualifikasi: DisplayName ("Jumlah Buka File Saat Ini")

Jumlah "file terbuka" yang saat ini aktif terhadap file.

Untuk informasi selengkapnya tentang menggunakan nilai uint64 dalam skrip, lihat Pembuatan Skrip di WMI.

Properti ini diwariskan dari CIM_LogicalFile.

LastAccessed

Jenis data: tanggalwaktu
Jenis akses: Baca-saja
Kualifikasi: DisplayName ("Terakhir Diakses")

Tanggal dan waktu file terakhir diakses.

Properti ini diwariskan dari CIM_LogicalFile.

LastModified

Jenis data: tanggalwaktu
Jenis akses: Baca-saja
Kualifikasi: DisplayName ("Terakhir Diubah")

Tanggal dan waktu file terakhir diubah.

Properti ini diwariskan dari CIM_LogicalFile.

Produsen

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Skema ("Win32"), DisplayName ("Produsen")

String produsen dari sumber daya versi (jika ada).

Nama

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Kunci

Properti Nama adalah string yang mewakili nama yang diwariskan yang berfungsi sebagai kunci instans file logis dalam sistem file. Nama jalur lengkap harus disediakan.

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

Properti ini diwariskan dari CIM_LogicalFile.

Jalur

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Tetap, Skema ("Win32"), DisplayName ("Path")

Jalur file termasuk garis miring terdepan dan di belakang. Contoh: "\windows\system\"

Properti ini diwariskan dari CIM_LogicalFile.

Mudah dibaca

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: DisplayName ("Dapat Dibaca")

Jika True, file dapat dibaca.

Properti ini diwariskan dari CIM_LogicalFile.

Keadaan

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MaxLen (10), DisplayName ("Status")

String yang menunjukkan status objek saat ini. Status operasional dan non-operasional dapat ditentukan. Status operasional dapat mencakup "OK", "Degraded", dan "Pred Fail". "Pred Fail" menunjukkan bahwa elemen berfungsi dengan baik, tetapi memprediksi kegagalan (misalnya, hard disk drive berkemampuan SMART).

Status non-operasional dapat mencakup "Kesalahan", "Mulai", "Berhenti", dan "Layanan". "Layanan" dapat berlaku selama resilvering cermin disk, memuat ulang daftar izin pengguna, atau pekerjaan administratif lainnya. Tidak semua pekerjaan tersebut online, tetapi elemen terkelola tidak "OK" atau di salah satu status lainnya.

Properti ini diwariskan dari CIM_ManagedSystemElement.

Nilai mencakup yang berikut:

OK ("OK")

Kesalahan ("Kesalahan")

Terdegradasi ("Terdegradasi")

Tidak diketahui ("Tidak Diketahui")

Pred Fail ("Pred Fail")

Memulai ("Memulai")

Menghentikan ("Berhenti")

Layanan ("Layanan")

Stres ("Stres")

NonRecover ("NonRecover")

Tidak Ada Kontak ("Tidak Ada Kontak")

Comm Hilang ("Hilang Comm")

Log

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: Skema ("Win32"), DisplayName ("File Sistem")

Jika True, file adalah file sistem.

Properti ini diwariskan dari CIM_LogicalFile.

Versi

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Skema ("Win32"), DisplayName ("Versi")

String versi dari sumber daya versi (jika ada).

Dapat ditulis

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: DisplayName ("Writeable")

Jika True, file dapat ditulis.

Properti ini diwariskan dari CIM_LogicalFile.

Keterangan

Kelas CIM_DataFile berasal dari CIM_LogicalFile.

WMI mengimplementasikan kelas CIM_DataFile dan semua metodenya. Kelas CIM_DataFile adalah kelas dinamis.

Dokumentasi ini berasal dari deskripsi kelas CIM yang diterbitkan oleh DMTF. Microsoft mungkin telah membuat perubahan untuk memperbaiki kesalahan kecil, sesuai dengan standar dokumentasi Microsoft SDK, atau memberikan informasi lebih lanjut.

Karena tujuan keamanan, WMI tidak secara langsung mendukung panggilan komputer jarak jauh dan menginstruksikannya untuk menyalin file ke dirinya sendiri. Namun, Anda dapat menggunakan bahasa pemrograman yang relevan untuk memanggil FTP atau RoboCopy, misalnya.

Contoh

Sampel kode VBS berikut menjelaskan cara melakukan pencarian kartubebas standar pada datafile. Perhatikan bahwa pembatas garis miring terbalik harus diloloskan dengan garis miring terbalik lain (\\). Selain itu, saat menggunakan "CIM_DataFile.FileName" dalam klausa WHERE, proses WMIPRVSE akan memindai semua direktori pada perangkat penyimpanan yang tersedia. Ini mungkin memakan waktu, terutama jika Anda telah memetakan berbagi jarak jauh, dan dapat memicu peringatan 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

Cuplikan berikut membatasi rentang pencarian ke drive, jalur, dan ekstensi file tertentu.

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

Sampel kode PowerShell berikut mengambil nilai atribut tunggal.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Ruang nama	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Bagikan melalui

kelas CIM_DataFile

Sintaks

Anggota

Metode

Properti

Keterangan

Contoh

Persyaratan

Baca juga

Saran dan Komentar

Sumber Daya Tambahan: