kelas Win32_Directory
Kelas WMI Win32_Directory mewakili entri direktori pada sistem komputer yang menjalankan Windows. Direktori adalah jenis file yang secara logis mengelompokkan file data dan menyediakan informasi jalur untuk file yang dikelompokkan. Contoh: C:\TEMP. Win32_Directory tidak menyertakan direktori drive jaringan.
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("{8502C4C7-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_Directory : CIM_Directory
{
string Caption;
string Description;
datetime InstallDate;
string Name;
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 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;
};
Anggota
Kelas Win32_Directory memiliki jenis anggota ini:
Metode
Kelas Win32_Directory memiliki metode ini.
| Metode | Deskripsi |
|---|---|
| ChangeSecurityPermissions | Metode kelas yang mengubah izin keamanan untuk file logis yang ditentukan di jalur objek. |
| ChangeSecurityPermissionsEx | Metode kelas yang mengubah izin keamanan untuk file logis yang ditentukan di jalur objek. |
| Kompres | Metode kelas yang mengompresi file logis (atau direktori) yang ditentukan dalam jalur objek. |
| CompressEx | Metode kelas yang mengompresi file logis (atau direktori) yang ditentukan dalam jalur objek. |
| Menyalin | Metode kelas yang menyalin file logis atau direktori yang ditentukan dalam jalur objek ke lokasi yang ditentukan oleh parameter input. |
| CopyEx | Metode kelas yang menyalin file logis atau direktori yang ditentukan dalam jalur objek ke lokasi yang ditentukan oleh parameter FileName . |
| Hapus | Metode kelas yang menghapus file logis (atau direktori) yang ditentukan dalam jalur objek. |
| DeleteEx | Metode kelas yang menghapus file logis (atau direktori) yang ditentukan dalam jalur objek. |
| GetEffectivePermission | Metode kelas yang menentukan apakah penelepon memiliki izin agregat yang ditentukan oleh argumen Izin tidak hanya pada objek file, tetapi pada berbagi file atau direktori berada (jika berada di berbagi). |
| Ganti nama | Metode kelas yang mengganti nama file logis (atau direktori) yang ditentukan dalam jalur objek. |
| TakeOwnerShip | Metode kelas yang mendapatkan kepemilikan file logis yang ditentukan dalam jalur objek. |
| TakeOwnerShipEx | Metode kelas yang mendapatkan kepemilikan file logis yang ditentukan dalam jalur objek. |
| Batalkan kompresi | Metode kelas yang membatalkan kompresi file logis (atau direktori) yang ditentukan dalam jalur objek. |
| UncompressEx | Metode kelas yang membatalkan kompresi file logis (atau direktori) yang ditentukan dalam jalur objek. |
Properti
Kelas Win32_Directory 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 direktori. 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 ditetapkan pada objek .
Properti ini diwarisi dari CIM_LogicalFile.
-
-
FILE_READ_DATA (file) atau FILE_LIST_DIRECTORY (direktori) (1)
-
Memberikan hak untuk membaca data dari file. Untuk direktori, nilai ini memberikan hak untuk mencantumkan konten direktori.
-
FILE_WRITE_DATA (file) atau FILE_ADD_FILE (direktori) (2)
-
Memberikan hak untuk menulis data ke file. Untuk direktori, nilai ini memberikan hak untuk membuat file di direktori.
-
FILE_APPEND_DATA (file) atau FILE_ADD_SUBDIRECTORY (4)
-
Memberikan hak untuk menambahkan data ke file. Untuk direktori, nilai ini memberikan hak untuk membuat subdirektori.
-
FILE_READ_EA (8)
-
Memberikan hak untuk membaca atribut yang diperluas.
-
FILE_WRITE_EA (16)
-
Memberikan hak untuk menulis atribut yang diperluas.
-
FILE_EXECUTE (file) atau FILE_TRAVERSE (direktori) (32)
-
Memberikan hak untuk menjalankan file. Untuk direktori, direktori dapat dilalui.
-
FILE_DELETE_CHILD (direktori) (64)
-
Memberikan hak untuk menghapus direktori dan semua file yang dikandungnya (turunannya), meskipun file bersifat baca-saja.
-
FILE_READ_ATTRIBUTES (128)
-
Memberikan hak untuk membaca atribut file.
-
FILE_WRITE_ATTRIBUTES (256)
-
Memberikan hak untuk mengubah atribut file.
-
HAPUS (65536)
-
Memberikan akses penghapusan.
-
READ_CONTROL (131072)
-
Memberikan akses baca ke pendeskripsi dan pemilik keamanan.
-
WRITE_DAC (262144)
-
Memberikan akses tulis ke ACL diskresi.
-
WRITE_OWNER (524288)
-
Menetapkan pemilik tulis.
-
SINKRONKAN (1048576)
-
Menyinkronkan akses dan memungkinkan proses menunggu objek memasuki status tersinyap.
-
ACCESS_SYSTEM_SECURITY (18809343)
-
Mengontrol kemampuan untuk mendapatkan atau mengatur SACL dalam deskriptor keamanan objek.
Mengarsipkan
-
Jenis data: boolean
-
Jenis akses: Baca-saja
-
Kualifikasi: Skema ("Win32"), DisplayName ("Harus Diarsipkan")
Menunjukkan apakah bit arsip pada folder telah diatur. Bit arsip digunakan oleh program cadangan untuk mengidentifikasi file yang harus dicadangkan. Jika True, file harus diarsipkan.
Properti ini diwarisi dari CIM_LogicalFile.
Keterangan
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MaxLen (64), DisplayName ("Keterangan")
Deskripsi tekstual singkat dari objek .
Properti ini diwarisi dari CIM_ManagedSystemElement.
Dikompresi
-
Jenis data: boolean
-
Jenis akses: Baca-saja
-
Kualifikasi: Skema ("Win32"), DisplayName ("Terkompresi")
Menunjukkan apakah folder telah dikompresi atau tidak. WMI mengenali folder yang dikompresi menggunakan WMI itu sendiri atau menggunakan antarmuka pengguna grafis; namun, tidak mengenali file .ZIP sebagai dikompresi. Jika True, file dikompresi.
Properti ini diwarisi dari CIM_LogicalFile.
CompressionMethod
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: DisplayName ("Metode Pemadatan")
Algoritma atau alat (biasanya metode) yang digunakan untuk memadatkan file logis. Jika tidak mungkin (atau tidak diinginkan) untuk menggambarkan skema kompresi (mungkin karena tidak diketahui), gunakan kata-kata berikut: "Tidak Diketahui" untuk mewakili bahwa tidak diketahui apakah file logis dikompresi; "Terkompresi" untuk mewakili bahwa file dikompresi, tetapi skema kompresinya tidak diketahui atau tidak diungkapkan; dan "Tidak Terkompresi" untuk mewakili bahwa file logis tidak dikompresi.
Properti ini diwarisi dari CIM_LogicalFile.
CreationClassName
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: CIM_Key, DisplayName ("Nama Kelas")
Nama kelas konkret pertama yang muncul dalam rantai pewarisan yang digunakan dalam pembuatan instans. Ketika digunakan dengan properti utama kelas lainnya, properti ini memungkinkan semua instans kelas ini dan subkelasnya diidentifikasi secara unik.
Properti ini diwarisi dari CIM_LogicalFile.
CreationDate
-
Jenis data: tanggalwaktu
-
Jenis akses: Baca-saja
-
Kualifikasi: DisplayName ("Tanggal Pembuatan")
Tanggal objek sistem file dibuat. Untuk informasi selengkapnya tentang bekerja dengan format tanggal dan waktu WMI, lihat Tugas WMI: Tanggal dan Waktu.
Properti ini diwarisi dari CIM_LogicalFile.
CSCreationClassName
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Disebarluaskan ("CIM_FileSystem. CSCreationClassName"), CIM_Key, DisplayName ("Nama Kelas Sistem Komputer")
Nama kelas pembuatan sistem komputer pencakupan.
Properti ini diwarisi dari CIM_LogicalFile.
CSName
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Disebarluaskan ("CIM_FileSystem. CSName"), CIM_Key, DisplayName ("Nama Sistem Komputer")
Nama komputer tempat objek sistem file disimpan.
Properti ini diwarisi dari CIM_LogicalFile.
Deskripsi
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: DisplayName ("Description")
Deskripsi tekstual objek.
Properti ini diwarisi dari CIM_ManagedSystemElement.
Drive
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Tetap, Skema ("Win32"), DisplayName ("Drive")
Huruf kandar kandar (termasuk titik dua) tempat objek sistem file disimpan.
Contoh: "c:"
Properti ini diwarisi dari CIM_LogicalFile.
EightDotThreeFileName
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Skema ("Win32"), DisplayName ("Eight Dot Three File Name")
MS-DOS -nama yang kompatibel untuk folder.
Contoh: "c:\progra~1"
Properti ini diwarisi dari CIM_LogicalFile.
Dienkripsi
-
Jenis data: boolean
-
Jenis akses: Baca-saja
-
Kualifikasi: Skema ("Win32"), DisplayName ("Terenkripsi")
Menunjukkan apakah folder telah dienkripsi atau tidak. Jika True, folder dienkripsi.
Properti ini diwarisi dari CIM_LogicalFile.
EncryptionMethod
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: DisplayName ("Metode Enkripsi")
Algoritma atau alat yang digunakan untuk mengenkripsi file logis. Jika tidak dimungkinkan (atau tidak diinginkan) untuk menjelaskan skema enkripsi (mungkin karena alasan keamanan), gunakan kata-kata berikut: "Tidak diketahui" untuk mewakili bahwa tidak diketahui apakah file logis dienkripsi; "Dienkripsi" untuk mewakili bahwa file dienkripsi, tetapi skema enkripsinya tidak diketahui atau tidak diungkapkan; dan "Tidak Dienkripsi" untuk mewakili bahwa file logis tidak dienkripsi.
Properti ini diwarisi dari CIM_LogicalFile.
Ekstensi
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Tetap, Skema ("Win32"), DisplayName ("Ekstensi File")
Ekstensi nama file untuk objek sistem file, tidak termasuk titik (.) yang memisahkan ekstensi dari nama file.
Contoh: "txt", "mof", "mdb"
Properti ini diwarisi dari CIM_LogicalFile.
FileName
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Tetap, Skema ("Win32"), DisplayName ("Nama File")
Nama file (tanpa titik atau ekstensi) file.
Contoh: "autoexec"
Properti ini diwarisi dari CIM_LogicalFile.
FileSize
-
Jenis data: uint64
-
Jenis akses: Baca-saja
-
Kualifikasi: DisplayName ("Ukuran"), Unit ("byte")
Ukuran objek sistem file, dalam byte. Meskipun folder memiliki properti FileSize , nilai 0 selalu dikembalikan. Untuk menentukan ukuran folder, gunakan FileSystemObject atau tambahkan ukuran semua file yang disimpan dalam folder.
Untuk informasi selengkapnya tentang menggunakan nilai uint64 dalam skrip, lihat Pembuatan skrip di WMI.
Properti ini diwarisi dari CIM_LogicalFile.
FileType
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Skema ("Win32"), DisplayName ("Jenis File")
Jenis file (ditunjukkan oleh properti Ekstensi ).
Misalnya, file .mdb kemungkinan memiliki jenis file Aplikasi Microsoft Access. File .asp kemungkinan memiliki tipe file Dokumen HTML. Folder biasanya dilaporkan hanya sebagai Folder.
Properti ini diwarisi 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 diwarisi dari CIM_LogicalFile.
FSName
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Disebarluaskan ("CIM_FileSystem. Nama"), CIM_Key, DisplayName ("Nama Sistem File")
Jenis sistem file (NTFS, FAT, FAT32) diinstal pada drive tempat file atau folder berada.
Properti ini diwarisi dari CIM_LogicalFile.
Tersembunyi
-
Jenis data: boolean
-
Jenis akses: Baca-saja
-
Kualifikasi: Skema ("Win32"), DisplayName ("Tersembunyi")
Menunjukkan apakah objek sistem file disembunyikan. Jika True, file disembunyikan.
Properti ini diwarisi 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 diwarisi 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.
Properti ini diwarisi dari CIM_LogicalFile.
Untuk informasi selengkapnya tentang menggunakan nilai uint64 dalam skrip, lihat Pembuatan skrip di WMI.
LastAccessed
-
Jenis data: tanggalwaktu
-
Jenis akses: Baca-saja
-
Kualifikasi: DisplayName ("Terakhir Diakses")
Tanggal file terakhir diakses. Untuk informasi selengkapnya tentang bekerja dengan format tanggal dan waktu WMI, lihat Tugas WMI: Tanggal dan Waktu.
Properti ini diwarisi dari CIM_LogicalFile.
LastModified
-
Jenis data: tanggalwaktu
-
Jenis akses: Baca-saja
-
Kualifikasi: DisplayName ("Terakhir Diubah")
Tanggal file terakhir diubah. Untuk informasi selengkapnya tentang bekerja dengan format tanggal dan waktu WMI, lihat Tugas WMI: Tanggal dan Waktu.
Properti ini diwarisi dari CIM_LogicalFile.
Nama
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Kunci
Properti Name 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 diwarisi dari CIM_LogicalFile.
Jalur
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: Tetap, Skema ("Win32"), DisplayName ("Jalur")
Jalur untuk file. Jalur ini mencakup garis miring terdepan dan di belakang, tetapi bukan huruf kandar atau nama folder.
Untuk folder c:\windows\system32\wbem, jalurnya adalah \windows\system32\. Untuk folder c:\scripts, jalurnya adalah \.
Properti ini diwarisi dari CIM_LogicalFile.
Mudah dibaca
-
Jenis data: boolean
-
Jenis akses: Baca-saja
-
Kualifikasi: DisplayName ("Dapat Dibaca")
Menunjukkan apakah Anda dapat membaca item dalam folder. Jika True, file dapat dibaca.
Properti ini diwarisi dari CIM_LogicalFile.
Status
-
Jenis data: string
-
Jenis akses: Baca-saja
-
Kualifikasi: MaxLen (10), DisplayName ("Status")
String yang menunjukkan status objek saat ini.
Properti ini diwarisi dari CIM_ManagedSystemElement.
Nilai yang valid mencakup sebagai 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")
Lost Comm ("Lost Comm")
Sistem
-
Jenis data: boolean
-
Jenis akses: Baca-saja
-
Kualifikasi: Skema ("Win32"), DisplayName ("File Sistem")
Menunjukkan apakah objek tersebut adalah file sistem. Jika True, file adalah file sistem
Properti ini diwarisi dari CIM_LogicalFile.
Dapat ditulis
-
Jenis data: boolean
-
Jenis akses: Baca-saja
-
Kualifikasi: DisplayName ("Dapat Ditulis")
Jika True, file dapat ditulis.
Properti ini diwarisi dari CIM_LogicalFile.
Keterangan
Kelas Win32_Directory berasal dari CIM_Directory.
Gambaran Umum
Folder adalah objek sistem file yang dirancang untuk memuat objek sistem file lainnya. Namun, ini tidak berarti bahwa semua folder sama. Sebaliknya, folder dapat sangat bervariasi. Beberapa folder adalah folder sistem operasi, yang umumnya tidak boleh dimodifikasi oleh skrip. Beberapa folder bersifat baca-saja, yang berarti bahwa pengguna dapat mengakses konten folder tersebut tetapi tidak dapat menambah, menghapus dari, atau mengubah konten tersebut. Beberapa folder dikompresi untuk penyimpanan optimal, sementara yang lain disembunyikan dan tidak terlihat oleh pengguna.
WMI menggunakan kelas Win32_Directory untuk mengelola folder. Secara signifikan, properti dan metode yang tersedia di kelas ini identik dengan properti dan metode yang tersedia di kelas CIM_DataFile , kelas yang digunakan untuk mengelola file. Ini berarti bahwa setelah Anda mempelajari cara mengelola folder menggunakan WMI, Anda akan, tanpa pekerjaan tambahan, juga tahu cara mengelola file.
Kelas asosiasi Win32_Subdirectory juga digunakan untuk mengelola file dan folder. Kelas Win32_Subdirectory berkaitan dengan folder dan subfolder langsungnya. Misalnya, dalam struktur folder C:\Scripts\Logs, Log adalah subfolder Skrip, dan Skrip adalah subfolder dari folder akar C:\. Namun, Log tidak dianggap sebagai subfolder C:\.
Anda dapat mengambil properti folder apa pun dalam sistem file menggunakan kelas Win32_Directory . Properti yang tersedia menggunakan kelas ini ditampilkan dalam Tabel 11.1. Untuk mengambil properti untuk satu folder, buat kueri Windows Query Language (WQL) untuk kelas Win32_Directory , pastikan Anda menyertakan nama folder. Misalnya, kueri ini mengikat ke folder D:\Archive:
Copy "SELECT * FROM Win32_Directory WHERE Name = 'D:\\Archive'"
Saat menentukan nama file atau folder dalam kueri WQL, pastikan Anda menggunakan dua garis miring terbalik (\\) untuk memisahkan komponen jalur.
Jika Anda ingin membatasi pengambilan data ke satu drive disk, sertakan klausa Where yang menentukan huruf drive. Misalnya, kueri ini mengembalikan daftar semua folder di drive C:
"SELECT * FROM Win32_Directory WHERE Drive = 'C:'"
Jika Anda perlu menghitung semua folder di komputer, ketahuilah bahwa kueri ini dapat memakan waktu lama untuk diselesaikan.
Contoh
Sampel VBScript berikut mengambil properti untuk folder C:\Scripts.
strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFolders = objWMIService.ExecQuery("SELECT * FROM Win32_Directory WHERE Name = 'c:\\Scripts'")
For Each objFolder in colFolders
Wscript.Echo "Archive: " & objFolder.Archive
Wscript.Echo "Caption: " & objFolder.Caption
Wscript.Echo "Compressed: " & objFolder.Compressed
Wscript.Echo "Compression method: " & objFolder.CompressionMethod
Wscript.Echo "Creation date: " & objFolder.CreationDate
Wscript.Echo "Encrypted: " & objFolder.Encrypted
Wscript.Echo "Encryption method: " & objFolder.EncryptionMethod
Wscript.Echo "Hidden: " & objFolder.Hidden
Wscript.Echo "In use count: " & objFolder.InUseCount
Wscript.Echo "Last accessed: " & objFolder.LastAccessed
Wscript.Echo "Last modified: " & objFolder.LastModified
Wscript.Echo "Name: " & objFolder.Name
Wscript.Echo "Path: " & objFolder.Path
Wscript.Echo "Readable: " & objFolder.Readable
Wscript.Echo "System: " & objFolder.System
Wscript.Echo "Writeable: " & objFolder.Writeable
Next
Sampel VBScript berikut mengembalikan daftar semua folder tersembunyi di komputer.
strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFiles = objWMIService.ExecQuery("SELECT * FROM Win32_Directory WHERE Hidden = True")
For Each objFile in colFiles
Wscript.Echo objFile.Name
Next
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista |
| Server minimum yang didukung |
Windows Server 2008 |
| Ruang nama |
Root\CIMV2 |
| MOF |
|
| DLL |
|
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk