Classe WMI do cliente CollectableFileItem

No Configuration Manager, a classe CollectableFileItem é uma classe Windows WMI (Instrumentação de Gerenciamento) do cliente que define atributos de uma regra de conjunto de arquivos. Os atributos de regra definem critérios, como nome de arquivo, caminhos de diretório e limites de tamanho de arquivo. Um exemplo é collect *.mif in %windir% up to 10 KB .

A sintaxe a seguir é simplificada do código MOF (Formato de Objeto Gerenciado) e inclui todas as propriedades herdadas.

Sintaxe

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

A CollectableFileItem classe não define nenhum método.

Propriedades

ExcludeCompressedEncrypted
Tipo de dados: Boolean

Tipo de acesso: Leitura/gravação

Qualificadores: Nenhum

Sinalizador indicando se arquivos e diretórios compactados ou criptografados ou ambos devem ser excluídos da verificação. Esse valor de propriedade geralmente é convertido no valor de consulta de propriedade FileSystemFile, IsCompressed e IsEncrypted.

FileCollectionActionID
Tipo de dados: String

Tipo de acesso: Leitura/gravação

Qualificadores: Nenhum

ID que corresponde à propriedade FileCollectionActionID para um objeto de classe WMI client WMI fileCollectionAction associado. O Agente de Inventário usa esse valor para encontrar a classe WMI do Cliente CollectableFileItem para uma ação específica de conjunto de arquivos.

FileItemID
Tipo de dados: String

Tipo de acesso: Leitura/gravação

Qualificadores: [realkey]

ID exclusiva para um objeto CollectableFileItem.

FileSpec
Tipo de dados: String

Tipo de acesso: Leitura/gravação

Qualificadores: Nenhum

Máscara de arquivo, incluindo caracteres curinga, usada para especificar nomes de arquivo que devem ser coletados, por exemplo, Virussig.dat, Boot*.ini e * .mif.

MaxItemFileSize
Tipo de dados: UInt32

Tipo de acesso: Leitura/gravação

Qualificadores: Nenhum

Tamanho total, em bytes, permitido para arquivos coletados nesta regra. Por exemplo, colete arquivos de até um total de 128 KB para essa regra.

PolicyID
Tipo de dados: String

Tipo de acesso: Leitura/gravação

Qualificadores: [chave]

ID exclusiva da política.

PolicyInstanceID
Tipo de dados: String

Tipo de acesso: Leitura/gravação

Qualificadores: [chave]

ID exclusiva da instância da política.

PolicyPrecedence
Tipo de dados: UInt32

Tipo de acesso: Leitura/gravação

Qualificadores: Nenhum

Precedência para a política.

PolicyRuleID
Tipo de dados: String

Tipo de acesso: Leitura/gravação

Qualificadores: [chave]

ID exclusiva da regra usada para criar a política.

PolicySource
Tipo de dados: String

Tipo de acesso: Leitura/gravação

Qualificadores: [chave]

Origem da política.

PolicyVersion
Tipo de dados: String

Tipo de acesso: Leitura/gravação

Qualificadores: [chave]

Versão da política.

ScanSubdirectories
Tipo de dados: Boolean

Tipo de acesso: Leitura/gravação

Qualificadores: Nenhum

Sinalizador indicando se a verificação de arquivo deve examinar subdireções ou apenas examinar o diretório raiz especificado por SearchPath. Esse valor de propriedade é usado para formatar o valor de consulta da propriedade FileSystemFilePath, como, c: \ \ * vs. c: \ \ .

SearchPath
Tipo de dados: String

Tipo de acesso: Leitura/gravação

Qualificadores: Nenhum

Diretório raiz da verificação, por exemplo, c: \ , %windir%e d:\myapplication \ . Essa propriedade é traduzida para o valor da propriedade FileSystemFilePath.

Timeout
Tipo de dados: UInt32

Tipo de acesso: Leitura/gravação

Qualificadores: Nenhum

Valor de tempo de tempo, em milissegundos. Se uma consulta FileSystemFile iniciada pelo Agente de Inventário durante uma verificação de conjunto de arquivos for mais longa do que o valor especificado, a consulta será cancelada. O valor padrão é 7.200.000 milissegundos.

Comentários

O Agente de Inventário usa cada instância dessa classe para criar uma consulta FileSystemFile e coleta os arquivos correspondentes aos atributos de regra. Essa classe é semelhante a InventoryDataItem, embora as propriedades sejam menos traduzidas diretamente em uma instrução WQL. No entanto, as propriedades do item são usadas para formatar a consulta FileSystemFile específica para a regra e, em seguida, são usadas para identificar arquivos que coincidem com os critérios de atributo. Esses arquivos correspondentes são anexados ao relatório de arquivo coletado gerado.

Cada instância CollectableFileItem contém uma referência a uma instância FileCollectionAction; várias regras CollectableFileItem são usadas para criar o relatório de arquivo coletado combinado para uma única instância FileCollectionAction.

Requirements

Requisitos de tempo de execução

Para obter mais informações, consulte Configuration Manager Client Runtime Requirements.

Requisitos de desenvolvimento

Para obter mais informações, consulte Configuration Manager Client Development Requirements.

Confira também

Classes WMI do Cliente do Agente de Inventário
Classe WMI do cliente FileCollectionAction
Classe WMI do cliente FileSystemFile
Classe WMI do cliente InventoryDataItem