CollectableFileItem 用戶端 WMI 類別

在Configuration Manager中，CollectableFileItem類別是定義檔案集合規則屬性的用戶端 Windows Management Instrumentation (WMI) 類別。 規則屬性會定義準則，例如檔案名、目錄路徑和檔案大小限制。 範例為 collect *.mif in %windir% up to 10 KB 。

下列語法已從受控物件格式 (MOF) 程式碼簡化，並包含所有繼承的屬性。

語法

Class CollectableFileItem : SMS_FileCollectionAgent_Policy  
{  
      Boolean ExcludeCompressedEncrypted;  
      String FileCollectionActionID;  
      String FileItemID;  
      String FileSpec;  
      UInt32 MaxItemFileSize;  
      String PolicyID;  
      String PolicyInstanceID;  
      UInt32 PolicyPrecedence;  
      String PolicyRuleID;  
      String PolicySource;  
      String PolicyVersion;  
      Boolean ScanSubdirectories;  
      String SearchPath;  
      UInt32 Timeout;  
};  

方法

類別 CollectableFileItem 不會定義任何方法。

屬性

ExcludeCompressedEncrypted
資料類型：Boolean

存取類型：讀取/寫入

限定詞：無

旗標，指出是否應從掃描中排除壓縮或加密的檔案和目錄或兩者。 這個屬性值通常會轉譯成 FileSystemFile、 IsCompressed和 IsEncrypted 屬性查詢值。

FileCollectionActionID
資料類型：String

存取類型：讀取/寫入

限定詞：無

符合相關聯FileCollectionActionAction 用戶端 WMI 類別物件之FileCollectionActionID屬性的識別碼。 清查代理程式會使用此值來尋找特定檔案收集動作 的 CollectableFileItem 用戶端 WMI 類別 類別。

FileItemID
資料類型：String

存取類型：讀取/寫入

限定詞：[realkey]

CollectableFileItem物件的唯一識別碼。

FileSpec
資料類型：String

存取類型：讀取/寫入

限定詞：無

檔案遮罩，包括萬用字元，用來指定應收集的檔案名，例如，Virussig.dat、Boot*.ini 和 *.mif。

MaxItemFileSize
資料類型：UInt32

存取類型：讀取/寫入

限定詞：無

此規則所收集檔案的大小總計，以位元組為單位。 例如，針對此規則收集總計 128 KB 的檔案。

PolicyID
資料類型：String

存取類型：讀取/寫入

限定詞：[金鑰]

原則的唯一識別碼。

PolicyInstanceID
資料類型：String

存取類型：讀取/寫入

限定詞：[金鑰]

原則實例的唯一識別碼。

PolicyPrecedence
資料類型：UInt32

存取類型：讀取/寫入

限定詞：無

原則的優先順序。

PolicyRuleID
資料類型：String

存取類型：讀取/寫入

限定詞：[金鑰]

用來建立原則之規則的唯一識別碼。

PolicySource
資料類型：String

存取類型：讀取/寫入

限定詞：[金鑰]

原則的來源。

PolicyVersion
資料類型：String

存取類型：讀取/寫入

限定詞：[金鑰]

原則的版本。

ScanSubdirectories
資料類型：Boolean

存取類型：讀取/寫入

限定詞：無

旗標，指出檔案掃描應該掃描子目錄，還是只掃描 SearchPath所指定的根目錄。 這個屬性值是用來格式化 FileSystemFilePath 屬性查詢值，例如 c：\\* 與 c：\\。

SearchPath
資料類型：String

存取類型：讀取/寫入

限定詞：無

掃描的根目錄，例如 c：\、%windir% 和 d：\myapplication\。 這個屬性會轉譯成 FileSystemFilePath 屬性值。

Timeout
資料類型：UInt32

存取類型：讀取/寫入

限定詞：無

逾時值，以毫秒為單位。 如果清查代理程式在檔案收集掃描期間起始的 FileSystemFile 查詢執行時間超過指定的逾時值，則會取消查詢。 預設值為 7，200，000 毫秒。

註解

清查代理程式會使用這個類別的每個實例來建置 FileSystemFile 查詢，並收集符合規則屬性的檔案。 這個類別類似于 InventoryDataItem，雖然屬性不會直接轉譯成 WQL 語句。 不過，專案屬性是用來格式化規則的特定 FileSystemFile 查詢，然後用來識別符合屬性準則的檔案。 這些相符的檔案接著會附加至所產生的收集檔案報表。

每個 CollectableFileItem 實 例都包含 FileCollectionAction 實例的參考;多個 CollectableFileItem 規則可用來為單一 FileCollectionAction 實例建置合併收集的檔案報表。

需求

執行時間需求

如需詳細資訊，請參閱Configuration Manager用戶端執行時間需求。

開發需求

如需詳細資訊，請參閱Configuration Manager用戶端開發需求。

另請參閱

清查代理程式用戶端 WMI 類別
FileCollectionAction 用戶端 WMI 類別
FileSystemFile 用戶端 WMI 類別
InventoryDataItem 用戶端 WMI 類別