Класс CIM_DataFile
Класс CIM_DataFile представляет именованную коллекцию данных или исполняемый код. Будут возвращены только экземпляры файлов на локальных фиксированных дисках.
Важно!
Классы CIM (Common Information Model) DMTF (Distributed Management Task Force) являются родительскими классами, на основе которых создаются классы WMI. В настоящее время WMI поддерживает только схемы версии CIM 2.x.
Приведенный ниже синтаксис является упрощенной версией кода MOF и включает все унаследованные свойства. Свойства перечислены в алфавитном порядке, а не в порядке MOF.
Синтаксис
[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;
};
Члены
Класс CIM_DataFile имеет следующие типы членов:
Методы
Класс CIM_DataFile содержит следующие методы.
| Метод | Описание |
|---|---|
| ChangeSecurityPermissions | Изменяет разрешения безопасности для логического файла, указанного в пути к объекту. Реализуется инструментарием WMI. |
| ChangeSecurityPermissionsEx | Изменяет разрешения безопасности для логического файла, указанного в пути к объекту. Реализуется инструментарием WMI. |
| Сжать | Использует сжатие NTFS для сжатия логического файла (или каталога), указанного в пути к объекту. Реализуется инструментарием WMI. |
| CompressEx | Сжимает логический файл (или каталог), указанный в пути к объекту. Реализуется инструментарием WMI. |
| Копировать | Копирует логический файл (или каталог), указанный в пути к объекту, в расположение, указанное входным параметром. Реализуется инструментарием WMI. |
| CopyEx | Копирует логический файл (или каталог), указанный в пути к объекту, в расположение, указанное входным параметром. Реализуется инструментарием WMI. |
| Удалить | Удаляет логический файл (или каталог), указанный в пути к объекту. Реализуется инструментарием WMI. |
| DeleteEx | Удаляет логический файл (или каталог), указанный в пути к объекту. Реализуется инструментарием WMI. |
| GetEffectivePermission | Определяет, имеет ли вызывающий объект агрегированные разрешения, заданные аргументом Permission . Реализуется инструментарием WMI. |
| Переименовать | Переименовывает логический файл (или каталог), указанный в пути к объекту. Реализуется инструментарием WMI. |
| TakeOwnerShip | Получает право владения логическим файлом, указанным в пути к объекту. Реализуется инструментарием WMI. |
| TakeOwnerShipEx | Получает право владения логическим файлом, указанным в пути к объекту. Реализуется инструментарием WMI. |
| Распаковать | Распаковывает логический файл (или каталог), указанный в пути к объекту. Реализуется инструментарием WMI. |
| UncompressEx | Распаковывает логический файл (или каталог), указанный в пути к объекту. Реализуется инструментарием WMI. |
Свойства
Класс CIM_DataFile имеет следующие свойства.
-
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)
-
WRITE_OWNER (524288)
-
SYNCHRONIZE (1048576)
Архив
-
Тип данных: boolean
-
Тип доступа: только для чтения
-
Квалификаторы: Schema ("Win32"), DisplayName ("Следует архивировать")
Если задано значение True, файл должен быть архивирован.
Это свойство наследуется от CIM_LogicalFile.
Caption
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: MaxLen (64), DisplayName ("Caption")
Краткое текстовое описание объекта.
Это свойство наследуется от CIM_ManagedSystemElement.
Compressed
-
Тип данных: boolean
-
Тип доступа: только для чтения
-
Квалификаторы: Schema ("Win32"), DisplayName ("Сжатый")
Если задано значение True, файл сжимается.
Это свойство наследуется от CIM_LogicalFile.
CompressionMethod
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: DisplayName ("Метод сжатия")
Строка свободной формы, указывающая алгоритм или средство, используемое для сжатия логического файла. Если схема сжатия неизвестна или не описана, используйте "Unknown". Если логический файл сжат, но схема сжатия неизвестна или не описана, используйте "Сжатый". Если логический файл не сжат, используйте команду "Не сжимается".
Это свойство наследуется от CIM_LogicalFile.
CreationClassName
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: CIM_Key, DisplayName ("Имя класса")
Имя класса.
Это свойство наследуется от CIM_LogicalFile.
CreationDate
-
Тип данных: datetime
-
Тип доступа: только для чтения
-
Квалификаторы: DisplayName ("Дата создания")
Дата и время создания файла.
Это свойство наследуется от CIM_LogicalFile.
CSCreationClassName
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: Распространяется ("CIM_FileSystem. CSCreationClassNameCIM_Key,DisplayName ("Computer System Class Name")
Класс компьютерной системы.
Это свойство наследуется от CIM_LogicalFile.
CSName
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: Распространяется ("CIM_FileSystem. CSName"), CIM_Key, DisplayName ("Имя системы компьютера")
Имя компьютерной системы.
Это свойство наследуется от CIM_LogicalFile.
Описание
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: DisplayName ("Описание")
Текстовое описание объекта.
Это свойство наследуется от CIM_ManagedSystemElement.
Диске
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: Исправлено, схема ("Win32"), DisplayName ("Диск")
Буква диска (включая двоеточие, следующее за буквой диска) файла.
Пример: "c:"
Это свойство наследуется от CIM_LogicalFile.
EightDotThreeFileName
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: Schema ("Win32"), DisplayName ("Восемь точек три имени файла")
Имя файла, совместимое с DOS.
Пример: "c:\progra~1"
Это свойство наследуется от CIM_LogicalFile.
Зашифрована
-
Тип данных: boolean
-
Тип доступа: только для чтения
-
Квалификаторы: Schema ("Win32"), DisplayName ("Encrypted")
Если задано значение True, файл зашифрован.
Это свойство наследуется от CIM_LogicalFile.
EncryptionMethod
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: DisplayName ("Метод шифрования")
Строка свободной формы, идентифицирующая алгоритм или средство, используемое для шифрования логического файла. Если схема шифрования не используется (например, по соображениям безопасности), используйте "Неизвестно". Если файл зашифрован, но его схема шифрования неизвестна или не разглашается, используйте "Зашифровано". Если логический файл не зашифрован, используйте "Не зашифровано".
Это свойство наследуется от CIM_LogicalFile.
Расширение
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: Исправлено, схема ("Win32"), DisplayName ("Расширение файла")
Расширение имени файла без предыдущей точки (точка).
Пример: "txt", "mof", "mdb"
Это свойство наследуется от CIM_LogicalFile.
FileName
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: Исправлено, схема ("Win32"), DisplayName ("Имя файла")
Имя файла без расширения имени файла. Пример: "MyDataFile"
Это свойство наследуется от CIM_LogicalFile.
FileSize
-
Тип данных: uint64
-
Тип доступа: только для чтения
-
Квалификаторы: DisplayName ("Size"), Units ("байты")
Размер файла в байтах.
Дополнительные сведения об использовании значений uint64 в скриптах см. в разделе Скрипты в WMI.
Это свойство наследуется от CIM_LogicalFile.
FileType
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: Schema ("Win32"), DisplayName ("Тип файла")
Дескриптор, представляющий тип файла, указанный свойством Extension .
Это свойство наследуется от CIM_LogicalFile.
FSCreationClassName
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: распространяется ("CIM_FileSystem. CreationClassName"), CIM_Key, DisplayName ("Имя класса файловой системы")
Класс файловой системы.
Это свойство наследуется от CIM_LogicalFile.
FSName
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: распространяется ("CIM_FileSystem. Name"), CIM_Key, DisplayName ("Имя файловой системы")
Имя файловой системы.
Это свойство наследуется от CIM_LogicalFile.
Скрыта
-
Тип данных: boolean
-
Тип доступа: только для чтения
-
Квалификаторы: Schema ("Win32"), DisplayName ("Hidden")
Если задано значение True, файл скрыт.
Это свойство наследуется от CIM_LogicalFile.
InstallDate
-
Тип данных: datetime
-
Тип доступа: только для чтения
-
Квалификаторы: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Дата установки")
Указывает, когда был установлен объект . Отсутствие значения не означает, что объект не установлен.
Это свойство наследуется от CIM_ManagedSystemElement.
InUseCount
-
Тип данных: uint64
-
Тип доступа: только для чтения
-
Квалификаторы: DisplayName ("Текущее число открытых файлов")
Число открытых файлов, которые в настоящее время активны для файла.
Дополнительные сведения об использовании значений uint64 в скриптах см. в разделе Создание скриптов в WMI.
Это свойство наследуется от CIM_LogicalFile.
LastAccessed
-
Тип данных: datetime
-
Тип доступа: только для чтения
-
Квалификаторы: DisplayName ("Последний доступ")
Дата и время последнего доступа к файлу.
Это свойство наследуется от CIM_LogicalFile.
LastModified
-
Тип данных: datetime
-
Тип доступа: только для чтения
-
Квалификаторы: DisplayName ("Последнее изменение")
Дата и время последнего изменения файла.
Это свойство наследуется от CIM_LogicalFile.
Производителя
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: Schema ("Win32"), DisplayName ("Manufacturer")
Строка производителя из ресурса версии (если она присутствует).
имя;
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: Ключ
Свойство Name — это строка, представляющая наследуемое имя, которое служит ключом экземпляра логического файла в файловой системе. Необходимо указать полные имена путей.
Пример: C:\Windows\system\win.ini
Это свойство наследуется от CIM_LogicalFile.
Путь
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: Fixed, Schema ("Win32"), DisplayName ("Path")
Путь к файлу, включая начальные и конечные обратные косые знаки. Пример: "\windows\system\"
Это свойство наследуется от CIM_LogicalFile.
Читаемым
-
Тип данных: boolean
-
Тип доступа: только для чтения
-
Квалификаторы: DisplayName ("Readable")
Если задано значение True, файл может быть прочитан.
Это свойство наследуется от CIM_LogicalFile.
Состояние
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: MaxLen (10), DisplayName ("Status")
Строка, указывающая текущее состояние объекта. Можно определить рабочее и нерабочее состояние. Состояние работы может включать "ОК", "Понижено" и "Сбой pred". "Pred Fail" указывает, что элемент работает правильно, но прогнозирует сбой (например, жесткий диск с поддержкой SMART).
Состояние "Нерабочее" может включать "Ошибка", "Запуск", "Остановка" и "Служба". "Служба" может применяться во время повторного зеркало диска, перезагрузки списка разрешений пользователя или выполнения других административных действий. Не вся такая работа находится в сети, но управляемый элемент не является ни "ОК", ни в одном из других состояний.
Это свойство наследуется от CIM_ManagedSystemElement.
В эти значения входят:
ОК ("ОК")
Error ("Error")
Пониженный ("Пониженный")
Unknown ("Unknown")
Pred Fail ("Pred Fail")
Запуск ("Запуск")
Остановка ("Остановка")
Служба ("Служба")
Подчеркнуто ("подчеркнуто")
NonRecover ("NonRecover")
Нет контакта ("Нет контакта")
Lost Comm ("Lost Comm")
Системные функции
-
Тип данных: boolean
-
Тип доступа: только для чтения
-
Квалификаторы: Schema ("Win32"), DisplayName ("Системный файл")
Если задано значение True, файл является системным.
Это свойство наследуется от CIM_LogicalFile.
Версия
-
Тип данных: string
-
Тип доступа: только для чтения
-
Квалификаторы: Schema ("Win32"), DisplayName ("Версия")
Строка версии из ресурса версии (если она присутствует).
Writeable (Доступно для записи)
-
Тип данных: boolean
-
Тип доступа: только для чтения
-
Квалификаторы: DisplayName ("Writeable")
Если задано значение True, файл можно записать.
Это свойство наследуется от CIM_LogicalFile.
Комментарии
Класс CIM_DataFile является производным от CIM_LogicalFile.
WMI реализует класс CIM_DataFile и все его методы. Класс CIM_DataFile является динамическим.
Эта документация взята из описаний классов CIM, опубликованных DMTF. Возможно, корпорация Майкрософт внесла изменения для исправления незначительных ошибок, соответствия стандартам документации по Пакету SDK Майкрософт или предоставления дополнительных сведений.
В целях безопасности инструментарий WMI не поддерживает напрямую вызов удаленного компьютера и указание ему копировать файлы в себя. Однако, например, можно использовать соответствующий язык программирования для вызова FTP или RoboCopy.
Примеры
В следующем примере кода Центра сценариев используется класс CIM_DataFile как часть более крупного приложения для создания отчетов среды обмена с помощью PowerShell.
Пример кода PowerShell для поиска файлов с помощью WMI в коллекции TechNet использует CIM_DataFile для поиска одного или нескольких файлов на нескольких компьютерах.
В следующем примере кода VBS описывается выполнение стандартного поиска с подстановочными знаками в файле данных. Обратите внимание, что разделители обратной косой черты должны быть экранированы с другой обратной косой чертой (\\). Кроме того, при использовании "CIM_DataFile. FileName" в предложении WHERE процесс WMIPRVSE сканирует все каталоги на любом доступном запоминаемом устройстве. Это может занять некоторое время, особенно если вы сопоставили удаленные общие папки и можете активировать предупреждения антивирусной программы.
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
Следующий фрагмент кода ограничивает диапазон поиска определенным диском, путем и расширением файла.
Set colFiles = objWMIService.ExecQuery("Select * from CIM_DataFile where Drive='"C:"' And Path='"\\"' and Name Like '%~%' and Extension='doc' ")
В следующем примере кода PowerShell извлекается значение одного атрибута.
$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 }
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Пространство имен |
Root\CIMV2 |
| MOF |
|
| DLL |
|
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по