CollectableFileItem 클라이언트 WMI 클래스CollectableFileItem Client WMI Class

Configuration Manager에서 CollectableFileItem 클래스는 파일 수집 규칙의 특성을 정의 하는 WMI (client WMI(Windows Management Instrumentation)) 클래스입니다.In Configuration Manager, the CollectableFileItem class is a client Windows Management Instrumentation (WMI) class that defines attributes of a file collection rule. 규칙 특성은 파일 이름, 디렉터리 경로 및 파일 크기 제한과 같은 조건을 정의 합니다.The rule attributes define criteria, such as file name, directory paths, and file size limits. 예제는 collect *.mif in %windir% up to 10 KB입니다.An example is collect *.mif in %windir% up to 10 KB.

MOF(Managed Object Format) 코드에서 간결하게 표기된 다음 구문은 상속된 속성을 모두 포함합니다.The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties.

구문Syntax

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;  
};  

메서드Methods

CollectableFileItem 클래스는 메서드를 정의하지 않습니다.The CollectableFileItem class does not define any methods.

속성Properties

ExcludeCompressedEncrypted
데이터 형식: BooleanData type: Boolean

액세스 형식: 읽기/쓰기Access type: Read/Write

한정자: 없음Qualifiers: None

압축 된 파일 및 디렉터리를 검색할지 아니면 둘 다 검색에서 제외할지를 나타내는 플래그입니다.Flag indicating whether compressed or encrypted files and directories or both should be excluded from the scan. 일반적으로이 속성 값은 FileSystemFile , IscompressedIsEncrypted 속성 쿼리 값으로 변환 됩니다.This property value is typically translated into the FileSystemFile , IsCompressed , and IsEncrypted property query value.

FileCollectionActionID
데이터 형식: StringData type: String

액세스 형식: 읽기/쓰기Access type: Read/Write

한정자: 없음Qualifiers: None

연결 된 FileCollectionAction 클라이언트 WMI 클래스 개체에 대 한 FileCollectionActionID 속성과 일치 하는 ID입니다.ID that matches the FileCollectionActionID property for an associated FileCollectionAction Client WMI Class object. 인벤토리 에이전트는이 값을 사용 하 여 특정 파일 수집 작업에 대 한 CollectableFileItem CLIENT WMI 클래스 클래스를 찾습니다.The Inventory Agent uses this value to find the CollectableFileItem Client WMI Class class for a particular file collection action.

FileItemID
데이터 형식: StringData type: String

액세스 형식: 읽기/쓰기Access type: Read/Write

한정자: [realkey]Qualifiers: [realkey]

CollectableFileItem 개체에 대 한 고유 ID입니다.Unique ID for a CollectableFileItem object.

FileSpec
데이터 형식: StringData type: String

액세스 형식: 읽기/쓰기Access type: Read/Write

한정자: 없음Qualifiers: None

와일드 카드를 포함 하는 파일 마스크는 수집할 파일 이름을 지정 하는 데 사용 됩니다 (예: Virussig, Boot* .ini 및. i n a * .File mask, including wildcards, used to specify file names that should be collected, for example, Virussig.dat, Boot*.ini, and *.mif.

MaxItemFileSize
데이터 형식: UInt32Data type: UInt32

액세스 형식: 읽기/쓰기Access type: Read/Write

한정자: 없음Qualifiers: None

이 규칙에 따라 수집 되는 파일에 대해 허용 되는 총 크기 (바이트)입니다.Total size, in bytes, allowed for files collected under this rule. 예를 들어이 규칙에 대해 총 128 KB까지 파일을 수집 합니다.For example, collect files up to a total of 128 KB for this rule.

PolicyID
데이터 형식: StringData type: String

액세스 형식: 읽기/쓰기Access type: Read/Write

한정자: [키]Qualifiers: [key]

정책의 고유 ID입니다.Unique ID of the policy.

PolicyInstanceID
데이터 형식: StringData type: String

액세스 형식: 읽기/쓰기Access type: Read/Write

한정자: [키]Qualifiers: [key]

정책 인스턴스의 고유 ID입니다.Unique ID of the policy instance.

PolicyPrecedence
데이터 형식: UInt32Data type: UInt32

액세스 형식: 읽기/쓰기Access type: Read/Write

한정자: 없음Qualifiers: None

정책의 우선 순위입니다.Precedence for the policy.

PolicyRuleID
데이터 형식: StringData type: String

액세스 형식: 읽기/쓰기Access type: Read/Write

한정자: [키]Qualifiers: [key]

정책을 만드는 데 사용 되는 규칙의 고유 ID입니다.Unique ID of the rule used to create the policy.

PolicySource
데이터 형식: StringData type: String

액세스 형식: 읽기/쓰기Access type: Read/Write

한정자: [키]Qualifiers: [key]

정책의 원본입니다.Source of the policy.

PolicyVersion
데이터 형식: StringData type: String

액세스 형식: 읽기/쓰기Access type: Read/Write

한정자: [키]Qualifiers: [key]

정책의 버전입니다.Version of the policy.

ScanSubdirectories
데이터 형식: BooleanData type: Boolean

액세스 형식: 읽기/쓰기Access type: Read/Write

한정자: 없음Qualifiers: None

파일 검색에서 하위 디렉터리를 검색 하거나 SearchPath 에 지정 된 루트 디렉터리만 검색할지 나타내는 플래그입니다.Flag indicating whether the file scan should scan subdirectories or only scan the root directory specified by SearchPath . 이 속성 값은 FileSystemFilePath 속성 쿼리 값 (예: c: \ \ * vs. c:) \ 의 형식을 지정 하는 데 사용 \ 됩니다.This property value is used to format the FileSystemFilePath property query value, such as, c:\\* vs. c:\\.

SearchPath
데이터 형식: StringData type: String

액세스 형식: 읽기/쓰기Access type: Read/Write

한정자: 없음Qualifiers: None

검색의 루트 디렉터리입니다 (예: c: \ ,% windir % 및 d:\myapplication) \ .Root directory of the scan, for example, c:\, % windir %, and d:\myapplication\. 이 속성은 FileSystemFilePath 속성 값으로 변환 됩니다.This property is translated into the FileSystemFilePath property value.

Timeout
데이터 형식: UInt32Data type: UInt32

액세스 형식: 읽기/쓰기Access type: Read/Write

한정자: 없음Qualifiers: None

시간 제한 값 (밀리초)입니다.Timeout value, in milliseconds. 파일 컬렉션 검색 중에 인벤토리 에이전트에서 시작한 FileSystemFile 쿼리가 지정 된 시간 제한 값 보다 오래 실행 되는 경우 쿼리가 취소 됩니다.If a FileSystemFile query initiated by the Inventory Agent during a file collection scan runs longer than the specified timeout value, the query is canceled. 기본값은 720만 밀리초입니다.The default value is 7,200,000 milliseconds.

설명Remarks

인벤토리 에이전트는이 클래스의 각 인스턴스를 사용 하 여 FileSystemFile 쿼리를 작성 하 고 규칙 특성과 일치 하는 파일을 수집 합니다.The Inventory Agent uses each instance of this class to build a FileSystemFile query and collects the files matching the rule attributes. 이 클래스는 InventoryDataItem 와 유사 하지만 속성은 WQL 문으로 직접 변환 되지 않습니다.This class is similar to InventoryDataItem , although the properties are less directly translated into a WQL statement. 그러나 항목 속성은 규칙에 대 한 특정 FileSystemFile 쿼리 형식을 지정 하는 데 사용 되며, 그 다음에는 특성 조건과 일치 하는 파일을 식별 하는 데 사용 됩니다.However, the item properties are used to format the specific FileSystemFile query for the rule and are then used to identify files matching the attribute criteria. 그러면 이러한 일치 파일이 생성 된 수집 파일 보고서에 연결 됩니다.These matching files are then attached to the generated collected file report.

CollectableFileItem 인스턴스에는 FileCollectionAction 인스턴스에 대 한 참조가 포함 되어 있습니다. 여러 CollectableFileItem 규칙을 사용 하 여 단일 FileCollectionAction 인스턴스에 대해 수집 된 전체 파일 보고서를 작성 합니다.Each CollectableFileItem instance contains a reference to a FileCollectionAction instance; multiple CollectableFileItem rules are used to build the combined collected file report for a single FileCollectionAction instance.

요구 사항Requirements

런타임 요구 사항Runtime Requirements

자세한 내용은 Configuration Manager 클라이언트 런타임 요구 사항을 참조 하세요.For more information, see Configuration Manager Client Runtime Requirements.

개발 요구 사항Development Requirements

자세한 내용은 Configuration Manager 클라이언트 개발 요구 사항을 참조 하세요.For more information, see Configuration Manager Client Development Requirements.

참고 항목See Also

인벤토리 에이전트 클라이언트 WMI 클래스 Inventory Agent Client WMI Classes
FileCollectionAction 클라이언트 WMI 클래스 FileCollectionAction Client WMI Class
FileSystemFile 클라이언트 WMI 클래스 FileSystemFile Client WMI Class
InventoryDataItem 클라이언트 WMI 클래스InventoryDataItem Client WMI Class