Classe WMI du client CollectableFileItem

Dans Configuration Manager, la classe CollectableFileItem est une classe WMI (Windows Management Instrumentation) cliente qui définit les attributs d’une règle de collection de fichiers. Les attributs de règle définissent des critères, tels que le nom de fichier, les chemins d’accès au répertoire et les limites de taille de fichier. Par exemple, collect *.mif in %windir% up to 10 KB.

La syntaxe suivante est simplifiée à partir du code MOF (Managed Object Format) et inclut toutes les propriétés héritées.

Syntaxe

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

Méthodes

La CollectableFileItem classe ne définit aucune méthode.

Propriétés

ExcludeCompressedEncrypted
Type de donnéesBoolean

Type d’accès : Lecture/écriture

Qualificateurs : Aucun

Indicateur indiquant si les fichiers et répertoires compressés ou chiffrés ou les deux doivent être exclus de l’analyse. Cette valeur de propriété est généralement traduite en valeur de requête de propriété FileSystemFile, IsCompressed et IsEncrypted .

FileCollectionActionID
Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : Aucun

ID qui correspond à la propriété FileCollectionActionID pour un objet classe WMI du client FileCollectionAction associé. L’Agent d’inventaire utilise cette valeur pour rechercher la classe WMI du client CollectableFileItem pour une action de collection de fichiers particulière.

FileItemID
Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : [realkey]

ID unique d’un objet CollectableFileItem .

FileSpec
Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : Aucun

Masque de fichier, y compris les caractères génériques, utilisé pour spécifier les noms de fichiers qui doivent être collectés, par exemple Virussig.dat, Boot*.ini et *.mif.

MaxItemFileSize
Type de donnéesUInt32

Type d’accès : Lecture/écriture

Qualificateurs : Aucun

Taille totale, en octets, autorisée pour les fichiers collectés dans le cadre de cette règle. Par exemple, collectez des fichiers jusqu’à un total de 128 Ko pour cette règle.

PolicyID
Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : [key]

ID unique de la stratégie.

PolicyInstanceID
Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : [key]

ID unique de l’instance de stratégie.

PolicyPrecedence
Type de donnéesUInt32

Type d’accès : Lecture/écriture

Qualificateurs : Aucun

Priorité de la stratégie.

PolicyRuleID
Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : [key]

ID unique de la règle utilisée pour créer la stratégie.

PolicySource
Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : [key]

Source de la stratégie.

PolicyVersion
Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : [key]

Version de la stratégie.

ScanSubdirectories
Type de donnéesBoolean

Type d’accès : Lecture/écriture

Qualificateurs : Aucun

Indicateur indiquant si l’analyse de fichier doit analyser les sous-répertoires ou uniquement le répertoire racine spécifié par SearchPath. Cette valeur de propriété est utilisée pour mettre en forme la valeur de requête de propriété FileSystemFilePath , par exemple, c:\\* vs. c:\\\.

SearchPath
Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : Aucun

Répertoire racine de l’analyse, par exemple, c:\, %windir% et d:\myapplication\. Cette propriété est traduite en valeur de propriété FileSystemFilePath .

Timeout
Type de donnéesUInt32

Type d’accès : Lecture/écriture

Qualificateurs : Aucun

Valeur de délai d’expiration, en millisecondes. Si une requête FileSystemFile lancée par l’agent d’inventaire pendant une analyse de collection de fichiers s’exécute plus longtemps que la valeur de délai d’expiration spécifiée, la requête est annulée. La valeur par défaut est 7 200 000 millisecondes.

Remarques

L’Agent d’inventaire utilise chaque instance de cette classe pour générer une requête FileSystemFile et collecte les fichiers correspondant aux attributs de règle. Cette classe est similaire à InventoryDataItem, bien que les propriétés soient moins directement traduites en instruction WQL. Toutefois, les propriétés d’élément sont utilisées pour mettre en forme la requête FileSystemFile spécifique pour la règle et sont ensuite utilisées pour identifier les fichiers correspondant aux critères d’attribut. Ces fichiers correspondants sont ensuite joints au rapport de fichiers collectés généré.

Chaque instance CollectableFileItem contient une référence à une instance FileCollectionAction ; plusieurs règles CollectableFileItem sont utilisées pour générer le rapport de fichiers collectés combiné pour une seule instance FileCollectionAction .

Configuration requise

Configuration requise pour l’exécution

Pour plus d’informations, consultez Configuration Manager Configuration requise pour l’exécution du client.

Conditions requises pour le développement

Pour plus d’informations, consultez Configuration Manager Exigences de développement du client.

Voir aussi

Classes WMI du client de l’agent d’inventaire
Classe WMI du client FileCollectionAction
Classe WMI du client FileSystemFile
Classe WMI du client InventoryDataItem