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_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 |
|
DLL |
|