Класс CIM_DataFile

Статья
06/13/2023

Класс 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, опубликованных 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	CIMWin32.mof
DLL	CIMWin32.dll

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

CIM_LogicalFile
Задачи WMI: файлы и папки
Константы прав доступа к файлам и каталогам

Поделиться через

Класс CIM_DataFile

Синтаксис

Члены

Методы

Свойства

Комментарии

Примеры

Требования

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

Обратная связь

Дополнительные ресурсы