Clase WMI de cliente CollectableFileItem

En Configuration Manager, la clase CollectableFileItem es una clase wmi (Instrumental de administración de Windows) cliente que define los atributos de una regla de colección de archivos. Los atributos de regla definen criterios, como el nombre de archivo, las rutas de acceso de directorio y los límites de tamaño de archivo. Por ejemplo, collect *.mif in %windir% up to 10 KB.

La sintaxis siguiente se simplifica a partir del código de formato de objeto administrado (MOF) e incluye todas las propiedades heredadas.

Sintaxis

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étodos

La CollectableFileItem clase no define ningún método.

Propiedades

ExcludeCompressedEncrypted
Tipo de datos: Boolean

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Marca que indica si los archivos y directorios comprimidos o cifrados o ambos deben excluirse del examen. Este valor de propiedad se traduce normalmente en el valor de consulta de propiedades FileSystemFile, IsCompressed e IsEncrypted .

FileCollectionActionID
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Identificador que coincide con la propiedad FileCollectionActionID para un objeto de clase WMI de cliente FileCollectionAction asociado. El Agente de inventario usa este valor para buscar la clase WMI de cliente CollectableFileItem para una acción de recopilación de archivos determinada.

FileItemID
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: [realkey]

Identificador único de un objeto CollectableFileItem .

FileSpec
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

La máscara de archivo, incluidos los caracteres comodín, se usa para especificar los nombres de archivo que se deben recopilar, por ejemplo, Virussig.dat, Boot*.ini y *.mif.

MaxItemFileSize
Tipo de datos: UInt32

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Tamaño total, en bytes, permitido para los archivos recopilados bajo esta regla. Por ejemplo, recopile archivos hasta un total de 128 KB para esta regla.

PolicyID
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: [key]

Identificador único de la directiva.

PolicyInstanceID
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: [key]

Identificador único de la instancia de directiva.

PolicyPrecedence
Tipo de datos: UInt32

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Precedencia de la directiva.

PolicyRuleID
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: [key]

Identificador único de la regla usada para crear la directiva.

PolicySource
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: [key]

Origen de la directiva.

PolicyVersion
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: [key]

Versión de la directiva.

ScanSubdirectories
Tipo de datos: Boolean

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Marca que indica si el examen de archivos debe examinar los subdirectorios o solo examinar el directorio raíz especificado por SearchPath. Este valor de propiedad se usa para dar formato al valor de consulta de la propiedad FileSystemFilePath , como c:\\* frente a c:\\.

SearchPath
Tipo de datos: String

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Directorio raíz del examen, por ejemplo, c:\, %windir%, y d:\myapplication\. Esta propiedad se traduce en el valor de la propiedad FileSystemFilePath .

Timeout
Tipo de datos: UInt32

Tipo de acceso: lectura y escritura

Calificadores: Ninguno

Valor de tiempo de espera, en milisegundos. Si una consulta FileSystemFile iniciada por el Agente de inventario durante un examen de recopilación de archivos se ejecuta más tiempo que el valor de tiempo de espera especificado, la consulta se cancela. El valor predeterminado es 7200 000 milisegundos.

Comentarios

El Agente de inventario usa cada instancia de esta clase para compilar una consulta FileSystemFile y recopila los archivos que coinciden con los atributos de regla. Esta clase es similar a InventoryDataItem, aunque las propiedades se traducen menos directamente en una instrucción WQL. Sin embargo, las propiedades del elemento se usan para dar formato a la consulta FileSystemFile específica para la regla y, a continuación, se usan para identificar los archivos que coinciden con los criterios de atributo. Estos archivos coincidentes se adjuntan al informe de archivos recopilados generado.

Cada instancia de CollectableFileItem contiene una referencia a una instancia de FileCollectionAction ; se usan varias reglas CollectableFileItem para compilar el informe de archivo recopilado combinado para una única instancia de FileCollectionAction .

Requisitos

Requisitos del entorno de ejecución

Para obtener más información, consulte Configuration Manager Client Runtime Requirements(Requisitos de tiempo de ejecución de cliente).

Requisitos de desarrollo

Para obtener más información, consulte Configuration Manager Requisitos de desarrollo de cliente.

Consulta también

Clases WMI de cliente del Agente de inventario
Clase WMI de cliente FileCollectionAction
Clase WMI de cliente FileSystemFile
Clase WMI de cliente InventoryDataItem