Класс Win32_Directory

Класс WMIWin32_Directory представляет запись каталога в системе компьютера под управлением Windows. Каталог — это тип файла, который логически группировал файлы данных и предоставлял сведения о пути к сгруппированным файлам. Пример: C:\TEMP. Win32_Directory не включает каталоги сетевых дисков.

Следующий пример синтаксиса — упрощенный MOF-код, который включает все наследуемые свойства. Свойства перечислены в алфавитном порядке, а не в порядке MOF.

Синтаксис

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

Члены

Класс Win32_Directory имеет следующие типы членов:

• Методы
• Свойства

Методы

Класс Win32_Directory содержит следующие методы.

Свойства

Класс Win32_Directory имеет следующие свойства.

AccessMask

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: Schema ("Win32"), DisplayName ("Access Rights")

Битовая маска, представляющая права доступа, необходимые для доступа к каталогу или выполнения определенных операций. Битовые значения см. в разделе Константы прав доступа к файлам и каталогам.

Примечание

На томах FAT вместо этого возвращается значение FULL_ACCESS , указывающее, что для объекта не задана безопасность.

Это свойство наследуется от CIM_LogicalFile.

FILE_READ_DATA (файл) или FILE_LIST_DIRECTORY (каталог) (1)

Предоставляет право на чтение данных из файла. Для каталога это значение дает право на перечисление содержимого каталога.

FILE_WRITE_DATA (файл) или FILE_ADD_FILE (каталог) (2)

Предоставляет право на запись данных в файл. Для каталога это значение предоставляет право на создание файла в каталоге.

FILE_APPEND_DATA (файл) или FILE_ADD_SUBDIRECTORY (4)

Предоставляет право на добавление данных в файл. Для каталога это значение предоставляет право на создание подкаталога.

FILE_READ_EA (8)

Предоставляет право на чтение расширенных атрибутов.

FILE_WRITE_EA (16)

Предоставляет право на запись расширенных атрибутов.

FILE_EXECUTE (файл) или FILE_TRAVERSE (каталог) (32)

Предоставляет право на выполнение файла. Каталог можно просмотреть для каталога.

FILE_DELETE_CHILD (каталог) (64)

Предоставляет право удалять каталог и все содержащиеся в нем файлы (его дочерние элементы), даже если файлы доступны только для чтения.

FILE_READ_ATTRIBUTES (128)

Предоставляет право на чтение атрибутов файла.

FILE_WRITE_ATTRIBUTES (256)

Предоставляет право изменять атрибуты файла.

DELETE (65536)

Предоставляет доступ к удалению.

READ_CONTROL (131072)

Предоставляет доступ на чтение дескриптору безопасности и владельцу.

WRITE_DAC (262144)

Предоставляет доступ на запись к дискреционному ACL.

WRITE_OWNER (524288)

Назначает владельца записи.

SYNCHRONIZE (1048576)

Синхронизирует доступ и позволяет процессу ждать, пока объект перейдет в состояние сигнала.

ACCESS_SYSTEM_SECURITY (18809343)

Управляет возможностью получения или задания saCL в дескрипторове безопасности объекта.

Комментарии

Класс Win32_Directory является производным от CIM_Directory.

Обзор

Папки — это объекты файловой системы, предназначенные для хранения других объектов файловой системы. Однако это не означает, что все папки одинаковы. Вместо этого папки могут значительно отличаться. Некоторые папки являются папками операционной системы, которые обычно не должны изменяться скриптом. Некоторые папки доступны только для чтения. Это означает, что пользователи могут получать доступ к содержимому этой папки, но не могут добавлять, удалять их или изменять. Некоторые папки сжимаются для оптимального хранения, а другие скрыты и не видны пользователям.

WMI использует класс Win32_Directory для управления папками. Примечательно, что свойства и методы, доступные в этом классе, идентичны свойствам и методам, доступным в классе CIM_DataFile , который используется для управления файлами. Это означает, что после того, как вы научились управлять папками с помощью WMI, вы без каких-либо дополнительных трудов будете знать, как управлять файлами.

Класс ассоциации Win32_Subdirectory также используется для управления файлами и папками. Класс Win32_Subdirectory связывает папку и ее непосредственные вложенные папки. Например, в структуре папок C:\Scripts\Logs журналы являются вложенной папкой Scripts, а Scripts — вложенной папкой корневой папки C:\. Однако журналы не считаются вложенной папкой C:\.

Свойства любой папки в файловой системе можно получить с помощью класса Win32_Directory . Свойства, доступные с помощью этого класса, показаны в таблице 11.1. Чтобы получить свойства для одной папки, создайте запрос языка запросов Windows (WQL) для класса Win32_Directory , включив имя папки. Например, этот запрос привязывается к папке D:\Archive:

Copy "SELECT * FROM Win32_Directory WHERE Name = 'D:\\Archive'"

При указании имени файла или папки в WQL-запросе обязательно используйте две обратные косые черти (\\) для разделения компонентов пути.

Если вы хотите ограничить извлечение данных одним диском, добавьте предложение Where, указывающее букву диска. Например, этот запрос возвращает список всех папок на диске C:

"SELECT * FROM Win32_Directory WHERE Drive = 'C:'"

Если необходимо перечислить все папки на компьютере, имейте в виду, что выполнение этого запроса может занять длительное время.

Примеры

В следующем примере VBScript извлекаются свойства папки 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

Следующий пример VBScript возвращает список всех скрытых папок на компьютере.

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

Требования

См. также раздел

CIM_Directory

Классы операционной системы