閱讀英文

共用方式為


CIM_DataFile 類別

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_DataFileWHERE 子句中的 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 工作:檔案和資料夾

檔案和目錄訪問許可權常數