Win32_Directory 類別
Win32_DirectoryWMI 類別代表執行 Windows 的電腦系統上的目錄專案。 目錄是一種檔案類型，會以邏輯方式將資料檔案分組，並提供群組檔案的路徑資訊。 範例：C：\TEMP。 Win32_Directory 不包含網路磁碟機機目錄。
下列語法已經過受管理物件格式 (MOF) 程式碼簡化，並包含所有已繼承的屬性。 屬性會依字母順序列出，而非 MOF 順序。
語法
[Dynamic, Provider("CIMWin32"), UUID("{8502C4C7-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_Directory : CIM_Directory
{
string Caption;
string Description;
datetime InstallDate;
string Name;
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 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;
};
成員
Win32_Directory類別具有下列類型的成員：
方法
Win32_Directory類別具有這些方法。
| 方法 | Description |
|---|---|
| ChangeSecurityPermissions | 變更物件路徑中所指定之邏輯檔案之安全性許可權的類別方法。 |
| ChangeSecurityPermissionsEx | 變更物件路徑中所指定之邏輯檔案之安全性許可權的類別方法。 |
| 壓縮 | 類別方法，可壓縮物件路徑中指定的邏輯檔案 (或目錄) 。 |
| CompressEx | 類別方法，可壓縮物件路徑中指定的邏輯檔案 (或目錄) 。 |
| 複製 | 類別方法，會將物件路徑中指定的邏輯檔案或目錄複寫到輸入參數所指定的位置。 |
| CopyEx | 類別方法，會將物件路徑中指定的邏輯檔案或目錄複寫到 FileName 參數所指定的位置。 |
| 刪除 | 類別方法，刪除物件路徑中指定的邏輯檔案 (或目錄) 。 |
| DeleteEx | 類別方法，刪除物件路徑中指定的邏輯檔案 (或目錄) 。 |
| GetEffectivePermission | 類別方法，可判斷呼叫端是否具有 Permissions 引數所指定的匯總許可權，而不只是在檔案物件上，而是位於檔案或目錄的共用上，如果檔案位於共用) ，則位於 (。 |
| 重 命名 | 類別方法，將邏輯檔案重新命名為物件路徑中指定的 (或目錄) 。 |
| TakeOwnerShip | 類別方法，可取得物件路徑中指定的邏輯檔案擁有權。 |
| TakeOwnerShipEx | 類別方法，可取得物件路徑中指定的邏輯檔案擁有權。 |
| 取消壓縮 | 將邏輯檔案取消壓縮 (或目錄的類別方法，) 指定于物件路徑中。 |
| UncompressEx | 將邏輯檔案取消壓縮 (或目錄的類別方法，) 指定于物件路徑中。 |
屬性
Win32_Directory類別具有這些屬性。
-
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)
-
授與讀取擴充屬性的許可權。
-
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)
-
授與任意 ACL 的寫入權限。
-
WRITE_OWNER (524288)
-
指派寫入擁有者。
-
同步 處理 (1048576)
-
同步存取，並允許進程等候物件進入訊號狀態。
-
ACCESS_SYSTEM_SECURITY (18809343)
-
控制在物件的安全性描述元中取得或設定 SACL 的能力。
封存
-
資料類型： 布林值
-
存取類型：唯讀
-
限定詞： 架構 (「Win32」) ， DisplayName (「應該封存」)
指出是否已設定資料夾上的封存位。 備份程式會使用封存位來識別應該備份的檔案。 如果 為 True，則應該封存檔案。
此屬性繼承自 CIM_LogicalFile。
標題
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： MaxLen (64) 、 DisplayName (「Caption」)
物件的簡短文字描述。
此屬性繼承自 CIM_ManagedSystemElement。
Compressed
-
資料類型： 布林值
-
存取類型：唯讀
-
限定詞： 架構 (「Win32」) 、 DisplayName (「Compressed」)
指出資料夾是否已壓縮。 WMI 會辨識使用 WMI 本身或圖形化使用者介面壓縮的資料夾;不過，它不會將.ZIP檔案辨識為正在壓縮。 如果 為 True，則會壓縮檔案。
此屬性繼承自 CIM_LogicalFile。
CompressionMethod
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： DisplayName (「Compression 方法」)
演算法或工具 (通常是用來壓縮邏輯檔案的方法) 。 如果不可能 (或不需要) 描述壓縮配置 (，可能是因為不知道) ，請使用下列字組：「未知」來表示邏輯檔案是否已壓縮;「Compressed」 表示檔案已壓縮，但其壓縮配置未知或未揭露;和 「Not Compressed」 表示邏輯檔案未壓縮。
此屬性繼承自 CIM_LogicalFile。
CreationClassName
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： CIM_Key、 DisplayName (「類別名稱」)
要出現在建立實例時所使用繼承鏈結中之第一個具體類別的名稱。 與 類別的其他索引鍵屬性搭配使用時，這個屬性可讓這個類別及其子類別的所有實例唯一識別。
此屬性繼承自 CIM_LogicalFile。
CreationDate
-
資料類型： datetime
-
存取類型：唯讀
-
限定詞： DisplayName (「建立日期」)
建立檔案系統物件的日期。 如需使用 WMI 日期和時間格式的詳細資訊，請參閱 WMI 工作：日期和時間。
此屬性繼承自 CIM_LogicalFile。
CSCreationClassName
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： 傳播 (「CIM_FileSystem。CSCreationClassName「) ， CIM_Key， DisplayName (」Computer System Class Name「)
建立範圍電腦系統的類別名稱。
此屬性繼承自 CIM_LogicalFile。
CSName
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： 傳播 (「CIM_FileSystem。CSName「) ， CIM_Key， DisplayName (」電腦系統名稱「)
儲存檔案系統物件的電腦名稱稱。
此屬性繼承自 CIM_LogicalFile。
說明
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： DisplayName (「Description」)
物件的文字描述。
此屬性繼承自 CIM_ManagedSystemElement。
磁碟機
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： 固定、 架構 (「Win32」) 、 DisplayName (「Drive」)
磁片磁碟機的磁碟機號 (包括儲存檔案系統物件的冒號) 。
範例：「c：」
此屬性繼承自 CIM_LogicalFile。
EightDotThreeFileName
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： 架構 (「Win32」) 、 DisplayName (「八點三個檔案名」)
資料夾的 MS-DOS 相容名稱。
範例：「c：\progra~1」
此屬性繼承自 CIM_LogicalFile。
已加密
-
資料類型： 布林值
-
存取類型：唯讀
-
限定詞： 架構 (「Win32」) 、 DisplayName (「Encrypted」)
指出資料夾是否已加密。 如果 為 True，則會加密資料夾。
此屬性繼承自 CIM_LogicalFile。
EncryptionMethod
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： DisplayName (「加密方法」)
用來加密邏輯檔案的演算法或工具。 如果無法 (或不需要) 描述加密配置 (，可能基於) 的安全性理由，請使用下列字組：「Unknown」 來表示邏輯檔案是否已加密;「Encrypted」 表示檔案已加密，但其加密配置未知或未揭露;和 「Not Encrypted」 表示邏輯檔案未加密。
此屬性繼承自 CIM_LogicalFile。
副檔名
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： 固定的 架構 (「Win32」) 、 DisplayName (「副檔名」)
檔案系統物件的副檔名，不包括分隔副檔名與檔案名的點 (.) 。
範例：「txt」、「mof」、「mdb」
此屬性繼承自 CIM_LogicalFile。
FileName
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： 固定、 架構 (「Win32」) 、 DisplayName (「檔案名」)
檔案名 (沒有檔案的點或副檔名) 。
範例：「autoexec」
此屬性繼承自 CIM_LogicalFile。
FileSize
-
資料類型： uint64
-
存取類型：唯讀
-
限定詞： DisplayName (「Size」) 、 Units (「bytes」)
檔案系統物件的大小，以位元組為單位。 雖然資料夾擁有 FileSize 屬性，但一律會傳回值 0。 若要判斷資料夾的大小，請使用 FileSystemObject 或加總儲存在資料夾中的所有檔案大小。
如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。
此屬性繼承自 CIM_LogicalFile。
FileType
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： 架構 (「Win32」) ， DisplayName (「檔案類型」)
副檔名屬性) 所指出的檔案類型 (。
例如，.mdb 檔案可能具有 Microsoft Access 應用程式的檔案類型。 .asp 檔案可能具有檔案類型 HTML 檔案。 資料夾通常只會回報為 Folder。
此屬性繼承自 CIM_LogicalFile。
FSCreationClassName
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： 傳播 (「CIM_FileSystem。CreationClassName「) ， CIM_Key， DisplayName (」檔案系統類別名稱「)
檔案系統的類別。
此屬性繼承自 CIM_LogicalFile。
FSName
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： 傳播 (「CIM_FileSystem。Name「) ， CIM_Key， DisplayName (」File System Name「)
檔案系統類型 (NTFS、FAT、FAT32) 安裝在檔案或資料夾所在的磁片磁碟機上。
此屬性繼承自 CIM_LogicalFile。
Hidden
-
資料類型： 布林值
-
存取類型：唯讀
-
限定詞： 架構 (「Win32」) ， DisplayName (「Hidden」)
指出檔案系統物件是否隱藏。 如果 為 True，則會隱藏檔案。
此屬性繼承自 CIM_LogicalFile。
InstallDate
-
資料類型： datetime
-
存取類型：唯讀
-
限定詞： MappingStrings (「MIF。DMTF|ComponentID|001.5「) ， DisplayName (」Install Date「)
指出何時安裝 物件。 缺少值並不表示未安裝物件。
此屬性繼承自 CIM_ManagedSystemElement。
InUseCount
-
資料類型： uint64
-
存取類型：唯讀
-
限定詞： DisplayName (「目前的檔案開啟計數」)
目前對檔案使用中的「檔案開啟」數目。
此屬性繼承自 CIM_LogicalFile。
如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。
LastAccessed
-
資料類型： datetime
-
存取類型：唯讀
-
限定詞： DisplayName (「Last Accessed」)
上次存取檔案的日期。 如需使用 WMI 日期和時間格式的詳細資訊，請參閱 WMI 工作：日期和時間。
此屬性繼承自 CIM_LogicalFile。
LastModified
-
資料類型： datetime
-
存取類型：唯讀
-
限定詞： DisplayName (「Last Modified」)
上次修改檔案的日期。 如需使用 WMI 日期和時間格式的詳細資訊，請參閱 WMI 工作：日期和時間。
此屬性繼承自 CIM_LogicalFile。
名稱
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： 金鑰
Name 屬性是字串，代表繼承的名稱，做為檔案系統內邏輯檔實例的索引鍵。 應該提供完整路徑名稱。 範例：C:\Windows\system\win.ini
此屬性繼承自 CIM_LogicalFile。
路徑
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞：固定的架構 (「Win32」) ，DisplayName (「Path」)
檔案的路徑。 路徑包含前置和尾端反斜線，但不包含磁碟機號或資料夾名稱。
針對 c：\windows\system32\wbem 資料夾，路徑為 \windows\system32\。 針對 c：\scripts 資料夾，路徑為 \。
此屬性繼承自 CIM_LogicalFile。
讀
-
資料類型： 布林值
-
存取類型：唯讀
-
限定詞： DisplayName (「Readable」)
指出您是否可以讀取資料夾中的專案。 如果 為 True，則可以讀取檔案。
此屬性繼承自 CIM_LogicalFile。
狀態
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： MaxLen (10) 、 DisplayName (「Status」)
字串，表示物件的目前狀態。
此屬性繼承自 CIM_ManagedSystemElement。
包括下列值：
OK (「OK」)
錯誤 (「錯誤」)
降級 (「已降級」)
未知 (「未知」)
預先失敗 (「預先失敗」)
開始 (「開始」)
停止 (「停止」)
服務 (「服務」)
壓力 (「壓力」)
NonRecover (「NonRecover」)
沒有連絡人 (「沒有連絡人」)
Lost Comm (「Lost Comm」)
系統
-
資料類型： 布林值
-
存取類型：唯讀
-
限定詞： 架構 (「Win32」) 、 DisplayName (「System File」)
指出物件是否為系統檔案。 如果 為 True，則表示檔案是系統檔案
此屬性繼承自 CIM_LogicalFile。
可寫入
-
資料類型： 布林值
-
存取類型：唯讀
-
限定詞： DisplayName (「Writeable」)
如果 為 True，則可以寫入檔案。
此屬性繼承自 CIM_LogicalFile。
備註
Win32_Directory類別衍生自CIM_Directory。
概觀
資料夾是設計來包含其他檔案系統物件的檔案系統物件。 不過，這並不表示所有資料夾都相同。 相反地，資料夾可能會有很大的差異。 有些資料夾是操作系統資料夾，通常不應該由腳本修改。 有些資料夾是唯讀的，這表示使用者可以存取該資料夾的內容，但無法新增、刪除或修改這些內容。 有些資料夾會壓縮以獲得最佳儲存空間，而其他資料夾則會隱藏，使用者看不到。
WMI 會使用 Win32_Directory 類別來管理資料夾。 明顯地，這個類別中可用的屬性和方法與 CIM_DataFile 類別中可用的屬性和方法相同，也就是用來管理檔案的類別。 這表示，在您瞭解如何使用 WMI 管理資料夾之後，您將不需要任何額外的工作，也知道如何管理檔案。
Win32_Subdirectory關聯類別也可用來管理檔案和資料夾。 Win32_Subdirectory類別會關聯資料夾及其即時子資料夾。 例如，在資料夾結構 C：\Scripts\Logs 中，Logs 是 Scripts 的子資料夾，而 Scripts 是根資料夾 C：\的子資料夾。 不過，記錄不會被視為 C：\的子資料夾。
您可以使用 Win32_Directory 類別，擷取檔案系統中任何資料夾的屬性。 資料表 11.1 會顯示使用此類別可用的屬性。 若要擷取單一資料夾的屬性，請建構 Win32_Directory 類別的 Windows 查詢語言 (WQL) 查詢，並確定您包含資料夾的名稱。 例如，此查詢會系結至資料夾 D：\Archive：
Copy "SELECT * FROM Win32_Directory WHERE Name = 'D:\\Archive'"
在 WQL 查詢中指定檔案或資料夾名稱時，請務必使用兩個反斜線 (\\) 來分隔路徑元件。
如果您想要將資料擷取限制為單一磁片磁碟機，請包含指定磁碟機號的 Where 子句。 例如，此查詢會傳回磁片磁碟機 C 上所有資料夾的清單：
"SELECT * FROM Win32_Directory WHERE Drive = 'C:'"
如果您需要列舉電腦上的所有資料夾，請注意，此查詢可能需要較長的時間才能完成。
範例
下列 VBScript 範例會擷取 C：\Scripts 資料夾的屬性。
strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFolders = objWMIService.ExecQuery("SELECT * FROM Win32_Directory WHERE Name = 'c:\\Scripts'")
For Each objFolder in colFolders
Wscript.Echo "Archive: " & objFolder.Archive
Wscript.Echo "Caption: " & objFolder.Caption
Wscript.Echo "Compressed: " & objFolder.Compressed
Wscript.Echo "Compression method: " & objFolder.CompressionMethod
Wscript.Echo "Creation date: " & objFolder.CreationDate
Wscript.Echo "Encrypted: " & objFolder.Encrypted
Wscript.Echo "Encryption method: " & objFolder.EncryptionMethod
Wscript.Echo "Hidden: " & objFolder.Hidden
Wscript.Echo "In use count: " & objFolder.InUseCount
Wscript.Echo "Last accessed: " & objFolder.LastAccessed
Wscript.Echo "Last modified: " & objFolder.LastModified
Wscript.Echo "Name: " & objFolder.Name
Wscript.Echo "Path: " & objFolder.Path
Wscript.Echo "Readable: " & objFolder.Readable
Wscript.Echo "System: " & objFolder.System
Wscript.Echo "Writeable: " & objFolder.Writeable
Next
下列 VBScript 範例會傳回電腦上所有隱藏資料夾的清單。
strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFiles = objWMIService.ExecQuery("SELECT * FROM Win32_Directory WHERE Hidden = True")
For Each objFile in colFiles
Wscript.Echo objFile.Name
Next
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 命名空間 |
Root\CIMV2 |
| MOF |
|
| DLL |
|
另請參閱
意見反應
即將推出：在 2024 年，我們將隨著內容的意見反應機制逐步淘汰 GitHub 問題，並以新的意見反應系統來取代。 如需詳細資訊，請參閱 https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應