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

存取類型:讀取/寫入

限定詞:無

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

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 類別