CIM_DataFile 类

项目
06/13/2023

CIM_DataFile 类表示数据或可执行代码的命名集合。仅返回本地固定磁盘上的文件实例。

重要

DMTF (分布式管理任务组) CIM (Common Information Model) 类是生成 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
访问类型：只读
限定符：架构 (“Win32”) 、 DisplayName (“访问权限”)

表示访问文件或对文件执行特定操作所需的访问权限的位掩码。有关位值，请参阅 文件和目录访问权限常量。

注意

在 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)

同步 (1048576)

存档

数据类型： 布尔值
访问类型：只读
限定符：架构 (“Win32”) 、 DisplayName (“应存档”)

如果 为 True，则应存档该文件。

此属性继承自 CIM_LogicalFile。

Caption

数据类型： 字符串
访问类型：只读
限定符： MaxLen (64) 、 DisplayName (“Caption”)

对象的简短文本说明。

此属性继承自 CIM_ManagedSystemElement。

Compressed

数据类型： 布尔值
访问类型：只读
限定符：架构 (“Win32”) 、 DisplayName (“Compressed”)

如果 为 True，则压缩该文件。

此属性继承自 CIM_LogicalFile。

CompressionMethod

数据类型： 字符串
访问类型：只读
限定符： DisplayName (“Compression Method”)

自由格式字符串，指示用于压缩逻辑文件的算法或工具。如果压缩方案未知或未描述，请使用“未知”。如果逻辑文件已压缩，但压缩方案未知或未描述，请使用“Compressed”。如果逻辑文件未压缩，请使用“未压缩”。

此属性继承自 CIM_LogicalFile。

CreationClassName

数据类型： 字符串
访问类型：只读
限定符： CIM_Key、 DisplayName (“类名称”)

类的名称。

此属性继承自 CIM_LogicalFile。

CreationDate

数据类型： datetime
访问类型：只读
限定符： DisplayName (“创建日期”)

文件的创建日期和时间。

此属性继承自 CIM_LogicalFile。

CSCreationClassName

数据类型： 字符串
访问类型：只读
限定符：传播 (“CIM_FileSystem。CSCreationClassName“) ， CIM_Key， DisplayName (”计算机系统类名称“)

计算机系统的类。

此属性继承自 CIM_LogicalFile。

CSName

数据类型： 字符串
访问类型：只读
限定符：传播 (“CIM_FileSystem。CSName“) 、 CIM_Key、 DisplayName (”计算机系统名称“)

计算机系统的名称。

此属性继承自 CIM_LogicalFile。

描述

数据类型： 字符串
访问类型：只读
限定符： DisplayName (“Description”)

对象的文本说明。

此属性继承自 CIM_ManagedSystemElement。

驱动

数据类型： 字符串
访问类型：只读
限定符：固定、架构 (“Win32”) 、 DisplayName (“Drive”)

驱动器号 (包括文件驱动器号) 后面的冒号。

示例：“c：”

此属性继承自 CIM_LogicalFile。

EightDotThreeFileName

数据类型： 字符串
访问类型：只读
限定符：架构 (“Win32”) 、 DisplayName (“八点三文件名”)

与 DOS 兼容的文件名。

示例：“c：\progra~1”

此属性继承自 CIM_LogicalFile。

已加密

数据类型： 布尔值
访问类型：只读
限定符：架构 (“Win32”) 、 DisplayName (“Encrypted”)

如果 为 True，则文件已加密。

此属性继承自 CIM_LogicalFile。

EncryptionMethod

数据类型： 字符串
访问类型：只读
限定符： DisplayName (“Encryption Method”)

标识用于加密逻辑文件的算法或工具的自由格式字符串。如果出于安全原因（例如) ）未放纵加密方案 (，请使用“未知”。如果文件已加密，但其加密方案未知或未披露，请使用“Encrypted”。如果逻辑文件未加密，请使用“未加密”。

此属性继承自 CIM_LogicalFile。

扩展名

数据类型： 字符串
访问类型：只读
限定符：固定、架构 (“Win32”) 、 DisplayName (“文件扩展名”)

没有上一句点的文件扩展名 (点) 。

示例：“txt”、“mof”、“mdb”

此属性继承自 CIM_LogicalFile。

FileName

数据类型： 字符串
访问类型：只读
限定符：固定、架构 (“Win32”) 、 DisplayName (“文件名”)

不带文件扩展名的文件名。示例：“MyDataFile”

此属性继承自 CIM_LogicalFile。

FileSize

数据类型： uint64
访问类型：只读
限定符： DisplayName (“Size”) 、 Units (“bytes”)

文件大小，以字节为单位。

有关在脚本中使用 uint64 值的详细信息，请参阅在 WMI 中编写脚本。

此属性继承自 CIM_LogicalFile。

FileType

数据类型： 字符串
访问类型：只读
限定符：架构 (“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。

Hidden

数据类型： 布尔值
访问类型：只读
限定符：架构 (“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 (“Last Accessed”)

上次访问文件的日期和时间。

此属性继承自 CIM_LogicalFile。

LastModified

数据类型： datetime
访问类型：只读
限定符： DisplayName (“Last Modified”)

上次修改文件的日期和时间。

此属性继承自 CIM_LogicalFile。

Manufacturer

数据类型： string
访问类型：只读
限定符：架构 (“Win32”) 、 DisplayName (“Manufacturer”)

如果存在) ，则版本资源中的制造商字符串 (。

名称

数据类型： string
访问类型：只读
限定符：键

Name 属性是一个字符串，表示继承的名称，用作文件系统中逻辑文件实例的键。应提供完整路径名称。

示例：C:\Windows\system\win.ini

此属性继承自 CIM_LogicalFile。

路径

数据类型： string
访问类型：只读
限定符：固定、架构 (“Win32”) 、 DisplayName (“Path”)

文件的路径，包括前导反斜杠和尾部反斜杠。示例：“\windows\system\”

此属性继承自 CIM_LogicalFile。

可读性

数据类型： 布尔值
访问类型：只读
限定符： DisplayName (“Readable”)

如果 为 True，则可以读取该文件。

此属性继承自 CIM_LogicalFile。

Status

数据类型： string
访问类型：只读
限定符： MaxLen (10) 、 DisplayName (“Status”)

指示对象的当前状态的字符串。可以定义操作状态和非操作状态。操作状态可能包括“正常”、“已降级”和“预失败”。 “Pred Fail”表示元素正常运行，但预测故障 (例如启用 SMART 的硬盘驱动器) 。

非操作状态可能包括“错误”、“正在启动”、“正在停止”和“服务”。 “服务”可以在磁盘镜像重新同步、重新加载用户权限列表或其他管理工作期间应用。并非所有此类工作都处于联机状态，但托管元素既不是“正常”，也不是处于其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

包括以下值：

OK (“OK”)

错误 (“错误”)

已降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

正在启动 (“正在启动”)

正在停止 (“停止”)

服务 (“Service”)

压力 (“有压力”)

NonRecover (“NonRecover”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

系统

数据类型： 布尔值
访问类型：只读
限定符：架构 (“Win32”) 、 DisplayName (“System File”)

如果 为 True，则该文件是系统文件。

此属性继承自 CIM_LogicalFile。

Version

数据类型： 字符串
访问类型：只读
限定符：架构 (“Win32”) 、 DisplayName (“Version”)

版本资源中的版本字符串 (是否存在) 。

可写

数据类型： 布尔值
访问类型：只读
限定符： DisplayName (“Writeable”)

如果 为 True，则可以写入文件。

此属性继承自 CIM_LogicalFile。

备注

CIM_DataFile 类派生自 CIM_LogicalFile。

WMI 实现 CIM_DataFile 类及其所有方法。 CIM_DataFile 类是动态类。

本文档派生自 DMTF 发布的 CIM 类说明。 Microsoft 可能已对更正小错误、符合 Microsoft SDK 文档标准或提供详细信息进行了更改。

出于安全考虑，WMI 不支持直接调用远程计算机并指示其将文件复制到自身。但是，例如，可以使用相关编程语言来调用 FTP 或 RoboCopy。

示例

以下脚本中心代码示例使用 CIM_DataFile 类作为较大应用程序的一部分，以使用 Powershell 生成交换环境报告。

在 TechNet 库中使用 WMI PowerShell 查找文件代码示例使用 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 类

语法

成员

方法

属性

备注

示例

要求

另请参阅

反馈

反馈

其他资源