CIM_DataFile类

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 (“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 (8)

FILE_WRITE_EA (16)

FILE_EXECUTE (文件) 或FILE_TRAVERSE (目录) (32)

FILE_DELETE_CHILD (目录) (64)

FILE_READ_ATTRIBUTES (128)

FILE_WRITE_ATTRIBUTES 256 (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 方法”)

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

此属性继承自 CIM_LogicalFile

CreationClassName

数据类型: 字符串

访问类型:只读

限定符: CIM_KeyDisplayName (“类名”)

类的名称。

此属性继承自 CIM_LogicalFile

CreationDate

数据类型: datetime

访问类型:只读

限定符: DisplayName (“创建日期”)

文件的创建日期和时间。

此属性继承自 CIM_LogicalFile

CSCreationClassName

数据类型: 字符串

访问类型:只读

限定符: 传播 (“CIM_FileSystemCSCreationClassName“) 、 CIM_KeyDisplayName (”计算机系统类名称“)

计算机系统的类。

此属性继承自 CIM_LogicalFile

CSName

数据类型: 字符串

访问类型:只读

限定符: 传播 (“CIM_FileSystemCSName“) 、 CIM_KeyDisplayName (”计算机系统名称“)

计算机系统的名称。

此属性继承自 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 (“加密方法”)

用于标识用于加密逻辑文件的算法或工具的自由格式字符串。 如果出于安全原因,加密方案未放纵 (,例如) ,请使用“未知”。 如果文件已加密,但其加密方案未知或未披露,请使用“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

数据类型: 字符串

访问类型:只读

限定符: 传播 (“CIM_FileSystemCreationClassName“) , CIM_KeyDisplayName (”文件系统类名称“)

文件系统的类。

此属性继承自 CIM_LogicalFile

FSName

数据类型: 字符串

访问类型:只读

限定符: 传播 (“CIM_FileSystem名称“) 、 CIM_KeyDisplayName (”文件系统名称“)

文件系统的名称。

此属性继承自 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 访问”)

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

此属性继承自 CIM_LogicalFile

LastModified

数据类型: datetime

访问类型:只读

限定符: DisplayName (“Last Modified”)

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

此属性继承自 CIM_LogicalFile

Manufacturer

数据类型: 字符串

访问类型:只读

限定符: 架构 (“Win32”) , DisplayName (“Manufacturer”)

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

名称

数据类型: 字符串

访问类型:只读

限定符: 密钥

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

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

此属性继承自 CIM_LogicalFile

路径

数据类型: 字符串

访问类型:只读

限定符:固定架构 (“Win32”) ,DisplayName (“Path”)

文件的路径,包括前导反斜杠和尾随反斜杠。 示例:“\windows\system\”

此属性继承自 CIM_LogicalFile

数据类型: 布尔值

访问类型:只读

限定符: DisplayName (“可读”)

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

此属性继承自 CIM_LogicalFile

Status

数据类型: 字符串

访问类型:只读

限定符: MaxLen (10) 、 DisplayName (“Status”)

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

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

此属性继承自 CIM_ManagedSystemElement

包括以下值:

确定 (“确定”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

启动 (“启动”)

停止 (“停止”)

服务 (“服务”)

压力 (“压力”)

NonRecover (“NonRecover ”)

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

Lost Comm (“Lost Comm”)

系统

数据类型: 布尔值

访问类型:只读

限定符: 架构 (“Win32”) , DisplayName (“系统文件”)

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

此属性继承自 CIM_LogicalFile

版本

数据类型: 字符串

访问类型:只读

限定符: 架构 (“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”。WHERE 子句中的 FileName“,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 任务:文件和文件夹

文件和目录访问权限常量