CIM_DataFile 類別

發行項
11/10/2023

CIM_DataFile 類別代表資料或可執行程式碼的具名集合。只會傳回本機固定磁片上的檔案實例。

重要

DMTF （分散式管理工作組） CIM （Common Information Model）類別是建置 WMI 類別的父類別。 WMI 目前僅支援 CIM 2.x 版本架構。

下列語法是從 Managed 物件格式（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）

SYNCHRONIZE （1048576）

封存

資料類型： 布林值
存取類型：唯讀
限定詞：架構（「Win32」）， DisplayName （「應封存」）

如果 為 True ，則應該封存檔案。

此屬性繼承自 CIM_LogicalFile 。

標題

資料類型：字串
存取類型：唯讀
限定詞： 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”）

自由格式字串，可識別用來加密邏輯檔案的演算法或工具。如果加密配置未放縱（例如，基於安全考慮），請使用 “Unknown”。如果檔案已加密，但其加密配置未知或未披露，請使用「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_FileSystem.CreationClassName），CIM_Key DisplayName （“文件系統類別名稱”）

檔案系統的類別。

此屬性繼承自 CIM_LogicalFile。

FSName

數據類型：字串
存取類型：唯讀
限定符：傳播（“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。

製造商

數據類型：字串
存取類型：唯讀
限定符：架構（“Win32”）， DisplayName （“Manufacturer”）

來自版本資源的製造商字串（如果有的話）。

名稱

數據類型：字串
存取類型：唯讀
限定符： 索引鍵

Name 屬性是字串，代表繼承的名稱，做為文件系統內邏輯檔案實例的索引鍵。應該提供完整路徑名稱。

範例：C：\Windows\system\win.ini

此屬性繼承自 CIM_LogicalFile。

路徑

數據類型：字串
存取類型：唯讀
限定符：固定的架構（“Win32”）， DisplayName （“Path”）

檔案的路徑，包括前置和尾端反斜杠。範例：“\windows\system\”

此屬性繼承自 CIM_LogicalFile。

讀

數據類型： 布爾值
存取類型：唯讀
限定符： DisplayName （“Readable”）

如果 為 True，則可以讀取檔案。

此屬性繼承自 CIM_LogicalFile。

狀態

數據類型：字串
存取類型：唯讀
限定符： MaxLen （10）， DisplayName （“Status”）

表示物件目前狀態的字串。您可以定義操作和非操作狀態。作業狀態可以包含「確定」、「已降級」和「預先失敗」。「預先失敗」表示元素正常運作，但正在預測失敗（例如，已啟用SMART的硬碟驅動器）。

非作業狀態可能包括「錯誤」、「啟動」、「停止」和「服務」。「服務」可以在磁碟鏡像重新Silvering、重載用戶權力清單或其他系統管理工作期間套用。並非所有這類工作都在在線，但 Managed 元素既不是「確定」，也不是在其他其中一個狀態中。

此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

確定（“OK”）

錯誤（「錯誤」

已降級 （「已降級」

未知（“未知”）

Pred Fail （“Pred Fail”）

啟動（“開始”）

停止（“停止”）

服務（“Service”）

壓力（“壓力”）

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，例如。

範例

下列 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
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另請參閱

CIM_LogicalFile
WMI 工作：檔案和資料夾
檔案和目錄訪問許可權常數

共用方式為

CIM_DataFile 類別

語法

成員

方法

屬性

備註

範例

需求

另請參閱

意見反應

其他資源