CIM _ 資料檔案類別

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

重要

DMTF (分散式管理工作強制) CIM (通用訊息模型) 類別是用來建立 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 _ 資料檔案 類別具有下列類型的成員:

方法

CIM _ 資料檔案 類別有這些方法。

方法 描述
ChangeSecurityPermissions 變更物件路徑中指定之邏輯檔案的安全性許可權。 由 WMI 所執行。
ChangeSecurityPermissionsEx 變更物件路徑中指定之邏輯檔案的安全性許可權。 由 WMI 所執行。
壓縮 使用 NTFS 壓縮來壓縮物件路徑中指定的邏輯檔案 (或目錄) 。 由 WMI 所執行。
CompressEx 壓縮物件路徑中指定的邏輯檔案 (或目錄) 。 由 WMI 所執行。
複製 將物件路徑中指定的邏輯檔案 (或目錄) 複製到輸入參數所指定的位置。 由 WMI 所執行。
CopyEx 將物件路徑中指定的邏輯檔案 (或目錄) 複製到輸入參數所指定的位置。 由 WMI 所執行。
刪除 刪除在物件路徑中指定的邏輯檔案 (或目錄) 。 由 WMI 所執行。
DeleteEx 刪除在物件路徑中指定的邏輯檔案 (或目錄) 。 由 WMI 所執行。
GetEffectivePermission 判斷呼叫端是否具有 許可權 引數所指定的匯總許可權。 由 WMI 所執行。
重 命名 重新命名在物件路徑中指定的邏輯檔案 (或目錄) 。 由 WMI 所執行。
TakeOwnerShip 取得物件路徑中指定之邏輯檔案的擁有權。 由 WMI 所執行。
TakeOwnerShipEx 取得物件路徑中指定之邏輯檔案的擁有權。 由 WMI 所執行。
解壓 Uncompresses 邏輯檔案 (或在物件路徑中指定的目錄) 。 由 WMI 所執行。
UncompressEx Uncompresses 邏輯檔案 (或在物件路徑中指定的目錄) 。 由 WMI 所執行。

屬性

CIM _ 資料檔案 類別具有這些屬性。

AccessMask

資料類型: uint32

存取類型:唯讀

限定詞: 架構 ( "Win32" ) , DisplayName ( "存取權限" )

位元遮罩,表示存取或執行檔案上特定作業所需的存取權限。 如需位值,請參閱檔案 和目錄存取權限常數

注意

在 FAT 磁片區上,會改為傳回 完整 _ 存取 值,表示物件上未設定任何安全性。

這個屬性繼承自 CIM _ LogicalFile

檔案 _讀取 _ 資料 (檔) 或檔案 _ 清單 _ 目錄 (目錄) (1)

檔案 _寫入 _ 資料 (檔案) 或檔案 _ 新增檔案 _ (目錄) (2)

檔案 __將資料附加) (檔案或檔案 _ 新增 _ 子目錄 (目錄) (4)

檔案 _讀取 _ EA (8)

檔案 _將 _ EA 寫入 (16)

檔案 _執行 (檔案) 或檔案往返 _ (目錄) (32)

檔案 _刪除 _ 子 (目錄) (64)

檔案 _讀取 _ 屬性 (128)

檔案 _將 _ 屬性寫入 (256)

刪除 (65536)

讀取 _控制 (131072)

寫入 _DAC (262144)

寫入 _擁有 者 (524288)

同步處理 (1048576)

封存

資料類型: 布林值

存取類型:唯讀

限定詞: 架構 ( "Win32" ) , DisplayName ( "應該封存" )

為 True,則表示應該封存檔案。

這個屬性繼承自 CIM _ LogicalFile

標題

資料類型: 字串

存取類型:唯讀

限定詞: MaxLen (64) , DisplayName ( "Caption" )

物件的簡短文字描述。

這個屬性繼承自 CIM _ ManagedSystemElement

Compressed

資料類型: 布林值

存取類型:唯讀

限定詞: 架構 ( 「Win32」 ) , DisplayName ( 「壓縮」 )

為 True,則會壓縮檔案。

這個屬性繼承自 CIM _ LogicalFile

CompressionMethod

資料類型: 字串

存取類型:唯讀

限定詞: DisplayName ( "Compression Method" )

自由格式字串,表示用來壓縮邏輯檔案的演算法或工具。 如果壓縮配置未知或未描述,請使用「未知」。 如果已壓縮邏輯檔案,但壓縮配置未知或未描述,請使用「壓縮」。 如果邏輯檔案未壓縮,請使用「未壓縮」。

這個屬性繼承自 CIM _ LogicalFile

CreationClassName

資料類型: 字串

存取類型:唯讀

限定詞: CIM _ KeyDisplayName ( "Class Name" )

類別的名稱。

這個屬性繼承自 CIM _ LogicalFile

CreationDate

資料類型: datetime

存取類型:唯讀

限定詞: DisplayName ( "建立日期" )

建立檔案的日期和時間。

這個屬性繼承自 CIM _ LogicalFile

CSCreationClassName

資料類型: 字串

存取類型:唯讀

限定詞: 傳播 ( 的 CIM _ 檔案系統CSCreationClassName") , CIM _ KeyDisplayName ( 「電腦系統類別名稱」 )

電腦系統的類別。

這個屬性繼承自 CIM _ LogicalFile

CSName

資料類型: 字串

存取類型:唯讀

限定詞: 傳播 ( 的 CIM _ 檔案系統CSName") , CIM _ KeyDisplayName ( 「電腦系統名稱」 )

電腦系統的名稱。

這個屬性繼承自 CIM _ LogicalFile

描述

資料類型: 字串

存取類型:唯讀

限定詞: DisplayName ( "Description" )

物件的文字描述。

這個屬性繼承自 CIM _ ManagedSystemElement

驅動

資料類型: 字串

存取類型:唯讀

限定詞: FixedSchema ( "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" )

識別用來加密邏輯檔案之演算法或工具的自由格式字串。 如果未 indulged 加密配置 (基於安全性理由(例如) ),請使用「未知」。 如果檔案已加密,但其加密配置不明或未洩漏,請使用「加密」。 如果邏輯檔案未加密,請使用「未加密」。

這個屬性繼承自 CIM _ LogicalFile

延伸模組

資料類型: 字串

存取類型:唯讀

限定詞: FixedSchema ( "Win32" ) 、 DisplayName ( "File Extension" )

沒有前一個期間的副檔名 (點) 。

範例: "txt"、"mof"、"mdb"

這個屬性繼承自 CIM _ LogicalFile

FileName

資料類型: 字串

存取類型:唯讀

限定詞: FixedSchema ( "Win32" ) 、 DisplayName ( "File Name" )

不含副檔名的檔案名。 範例: "MyDataFile"

這個屬性繼承自 CIM _ LogicalFile

FileSize

資料類型: uint64

存取類型:唯讀

限定詞: DisplayName ( "Size" ) , 單位 ( "bytes" )

檔案的大小(以位元組為單位)。

如需在腳本中使用 uint64 值的詳細資訊,請參閱 WMI 中的腳本

這個屬性繼承自 CIM _ LogicalFile

FileType

資料類型: 字串

存取類型:唯讀

限定詞: 架構 ( "Win32" ) , DisplayName ( "檔案類型" )

表示 擴充 屬性所表示之檔案類型的描述元。

這個屬性繼承自 CIM _ LogicalFile

FSCreationClassName

資料類型: 字串

存取類型:唯讀

限定詞: 傳播 ( 的 CIM _ 檔案系統CreationClassName") , CIM _ KeyDisplayName (" 檔案系統類別名稱 ")

檔案系統的類別。

這個屬性繼承自 CIM _ LogicalFile

FSName

資料類型: 字串

存取類型:唯讀

限定詞: 傳播 ( 的 CIM _ 檔案系統Name") 、 CIM _ KeyDisplayName (" File System Name ")

檔案系統的名稱。

這個屬性繼承自 CIM _ LogicalFile

Hidden

資料類型: 布林值

存取類型:唯讀

限定詞: 架構 ( 「Win32」 ) , DisplayName ( 「隱藏」 )

為 True,則表示檔案已隱藏。

這個屬性繼承自 CIM _ LogicalFile

InstallDate

資料類型: datetime

存取類型:唯讀

限定詞: MappingStrings ( "MIF。DMTF | 元件 | 001.5 ") , DisplayName (" 安裝日期 ")

指出物件的安裝時間。 缺少值並不表示物件未安裝。

這個屬性繼承自 CIM _ ManagedSystemElement

InUseCount

資料類型: uint64

存取類型:唯讀

限定詞: DisplayName ( 「目前的檔案開啟計數」 )

檔案目前作用中的「檔案開啟」數目。

如需在腳本中使用 uint64 值的詳細資訊,請參閱 WMI 中的腳本

這個屬性繼承自 CIM _ LogicalFile

LastAccessed

資料類型: datetime

存取類型:唯讀

限定詞: DisplayName ( 「上次存取」 )

上次存取檔案的日期和時間。

這個屬性繼承自 CIM _ LogicalFile

LastModified

資料類型: datetime

存取類型:唯讀

限定詞: DisplayName ( 「上次修改」 )

上次修改檔案的日期和時間。

這個屬性繼承自 CIM _ LogicalFile

製造商

資料類型: 字串

存取類型:唯讀

限定詞: 架構 ( "Win32" ) , DisplayName ( "製造商" )

版本資源 (的製造商字串(如果有的話) )。

名稱

資料類型: 字串

存取類型:唯讀

限定詞:索引

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

範例: C: \ Windows \ 系統 \win.ini

這個屬性繼承自 CIM _ LogicalFile

路徑

資料類型: 字串

存取類型:唯讀

限定詞: FixedSchema ( "Win32" ) 、 DisplayName ( "Path" )

檔案的路徑,包括開頭和尾端的反斜線。 範例: " \ windows \ system \ "

這個屬性繼承自 CIM _ LogicalFile

資料類型: 布林值

存取類型:唯讀

限定詞: DisplayName ( "可讀取" )

為 True,則表示可以讀取檔案。

這個屬性繼承自 CIM _ LogicalFile

狀態

資料類型: 字串

存取類型:唯讀

限定詞: MaxLen (10) , DisplayName ( "Status" )

表示物件目前狀態的字串。 您可以定義操作和非運作狀態。 操作狀態可以包含「確定」、「降級」和「Pred 失敗」。 「Pred 失敗」表示專案正常運作,但正在預測失敗 (例如,啟用智慧型硬碟) 。

非操作狀態可能包括「錯誤」、「開始」、「正在停止」和「服務」。 「服務」可以在磁片鏡像重新同步處理、重載使用者權限清單或其他系統管理工作時套用。 並非所有這類工作都在線上,但是受控元素不是「確定」,也不是其中一個其他狀態。

這個屬性繼承自 CIM _ ManagedSystemElement

包括下列值:

確定 ( [確定] )

錯誤 ( 「錯誤」 )

降級 ( 「降級」 )

未知 的 ( 「未知」 )

Pred 失敗 ( 「Pred 失敗」 )

開始 ( 「開始」 )

停止 ( 「正在停止」 )

服務 ( 「服務」 )

壓力 ( 「壓力」 )

NonRecover ( "NonRecover" )

沒有連絡人 ( 「沒有連絡人」 )

遺失的 comm ( 「遺失的通訊」 )

系統

資料類型: 布林值

存取類型:唯讀

限定詞: 架構 ( "Win32" ) , DisplayName ( "System File" )

為 True,表示檔案為系統檔案。

這個屬性繼承自 CIM _ LogicalFile

版本

資料類型: 字串

存取類型:唯讀

限定詞: 架構 ( "Win32" ) , DisplayName ( "Version" )

版本資源 (的版本字串(如果有的話)) 。

可寫入

資料類型: 布林值

存取類型:唯讀

限定詞: DisplayName ( "可寫入" )

為 True,則表示可以寫入檔案。

這個屬性繼承自 CIM _ LogicalFile

備註

Cim _ 資料檔案 類別衍生自 cim _ LogicalFile

WMI 會實行 CIM _ 資料檔案 類別及其所有方法。 CIM _ 資料檔案 類別是動態類別。

此檔衍生自 DMTF 所發佈的 CIM 類別描述。 Microsoft 可能已進行變更,以更正次要錯誤、符合 Microsoft SDK 檔標準,或提供詳細資訊。

基於安全性考慮,WMI 不直接支援呼叫遠端電腦,並指示它將檔案複製到本身。 不過,您可以使用相關的程式設計語言來呼叫 FTP 或 RoboCopy。

範例

下列腳本中心程式 代碼範例 會使用 CIM _ 資料檔案 類別作為較大應用程式的一部分,以使用 Powershell 來產生 exchange 環境報告。

TechNet 元件庫中的 Find files WITH WMI PowerShell 程式碼範例會使用 CIM _ 資料檔案 來搜尋多部電腦上的一個或多個檔案。

下列 VBS 程式碼範例說明如何在資料檔案上執行標準萬用字元搜尋。 請注意,反斜線分隔符號必須以另一個反斜線 () 來進行轉義 \ \ 。 此外,使用「CIM _ 資料檔案」時。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
命名空間
根 \ CIMV2
MOF
CIMWin32 mof
DLL
CIMWin32.dll

另請參閱

CIM _ LogicalFile

WMI 工作:檔案和資料夾

檔案和目錄存取權限常數