CollectableFileItem 클라이언트 WMI 클래스

  • 아티클

Configuration Manager CollectableFileItem 클래스는 파일 컬렉션 규칙의 특성을 정의하는 클라이언트 WMI(Windows Management Instrumentation) 클래스입니다. 규칙 특성은 파일 이름, 디렉터리 경로 및 파일 크기 제한과 같은 조건을 정의합니다. 예를 들면 입니다 collect *.mif in %windir% up to 10 KB.

다음 구문은 MOF(Managed Object Format) 코드에서 간소화되며 상속된 모든 속성을 포함합니다.

구문

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

액세스 유형: 읽기/쓰기

한정자: 없음

이 규칙에 따라 수집된 파일에 허용되는 총 크기(바이트)입니다. 예를 들어 이 규칙에 대해 최대 128KB의 파일을 수집합니다.

PolicyID
데이터 형식: String

액세스 유형: 읽기/쓰기

한정자: [키]

정책의 고유 ID입니다.

PolicyInstanceID
데이터 형식: String

액세스 유형: 읽기/쓰기

한정자: [키]

정책 인스턴스의 고유 ID입니다.

PolicyPrecedence
데이터 형식: UInt32

액세스 유형: 읽기/쓰기

한정자: 없음

정책의 우선 순위입니다.

PolicyRuleID
데이터 형식: String

액세스 유형: 읽기/쓰기

한정자: [키]

정책을 만드는 데 사용되는 규칙의 고유 ID입니다.

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 클래스