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

访问类型：读/写

限定符：无

与关联的 FileCollectionAction客户端 WMI 类对象的 FileCollectionActionID 属性匹配的 ID。 清单代理使用此值查找特定文件收集操作 的 CollectableFileItem 客户端 WMI 类 。

FileItemID
数据类型String

访问类型：读/写

限定符：[realkey]

CollectableFileItem 对象的唯一 ID。

FileSpec
数据类型String

访问类型：读/写

限定符：无

文件掩码（包括通配符）用于指定应收集的文件名，例如 Virussig.dat、Boot*.ini 和 *.mif。

MaxItemFileSize
数据类型UInt32

访问类型：读/写

限定符：无

此规则下收集的文件允许的总大小（以字节为单位）。 例如，对于此规则，最多收集 128 KB 的文件。

PolicyID
数据类型String

访问类型：读/写

限定符：[key]

策略的唯一 ID。

PolicyInstanceID
数据类型String

访问类型：读/写

限定符：[key]

策略实例的唯一 ID。

PolicyPrecedence
数据类型UInt32

访问类型：读/写

限定符：无

策略的优先级。

PolicyRuleID
数据类型String

访问类型：读/写

限定符：[key]

用于创建策略的规则的唯一 ID。

PolicySource
数据类型String

访问类型：读/写

限定符：[key]

策略的源。

PolicyVersion
数据类型String

访问类型：读/写

限定符：[key]

策略的版本。

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 类