SMS_G_System_CollectedFile

The SMS_G_System_CollectedFile WMI class contains information about files collected from clients. Collected files are copied from the client computer to the site server.

The following syntax is simplified from MOF code and includes all inherited properties.

Class SMS_G_System_CollectedFile : SMS_G_System
{
  datetime CollectionDate;
  uint8 FileData[];
  string FileName;
  string FilePath;
  uint32 FileSize;
  string LocalFilePath;
  datetime ModifiedDate;
  uint32 ResourceID;
  uint32 RevisionID;
};

Properties

• CollectionDate
  Data type: datetime
  Access type: Read-only

  Date and time the file was collected from the client computer.

• FileData
  Data type: uint8[]
  Access type: Read-only
  Qualifiers: Lazy

  Contents of the file.

• FileName
  Data type: string
  Access type: Read-only

  Name and extension of the file.

• FilePath
  Data type: string
  Access type: Read-only
  Qualifiers: Key

  Path to the file on the client computer.

• FileSize
  Data type: uint32
  Access type: Read-only

  Size of the file in bytes.

• LocalFilePath
  Data type: string
  Access type: Read-only

  Path to the file on the site server.

• ModifiedDate
  Data type: datetime
  Access type: Read-only

  Date and time the file was last modified.

• ResourceID
  Data type: uint32
  Access type: Read-only
  Qualifiers: Key

  SMS-supplied identifier that uniquely identifies the client.

• RevisionID
  Data type: uint32
  Access type: Read-only
  Qualifiers: Key

  Value increments each time an inventory is taken, to identify the number of times this object has been inventoried. The file is only inventoried when it has changed.

Remarks

The Software Inventory Agent collects those files identified in the site control file. To identify the files to collect:

1. Query the site control item SMS_SCI_ClientComp for the instance whose value for ClientComponentName is Software Inventory Agent.

2. Loop through the embedded property list.

   When the value for PropertyName is Collectable Files, update the comma-delimited list of file names (include extension) in the Value2 property.

   When the value for PropertyName is Max Collected File Size, set a maximum size for the total file size of all the collected files combined, in megabytes, that SMS collects from the client during each software inventory cycle. You can specify between 1 and 20 megabytes, inclusive. The inventory agent collects the files from the client based on the order in which it finds them on the client. The agent stops collecting files from the client for that cycle if the sum total of the collected files exceeds the maximum size. On each successive inventory cycle, the agent collects those files that have yet to be collected until all files specified have been collected.

   After each inventory cycle, the inventory agent generates a status message (MessageID=10605) that identifies the number of files collected and the sum file size of the collected files.

3. Update the site control file with your changes.

For information on updating the site control file, see the example in Managing Site Control Configuration.

Note  Collecting files from clients can generate a large volume of network traffic and requires extensive storage space. For this reason, test any changes you make in a test environment before implementing in a production environment.

Collected files are deleted on a schedule if the Delete Aged Collected Files database maintenance task is set to TRUE in the console. You can also enable this task and set the schedule by updating the site control file. The site control item is an instance of SMS_SCI_SQLTask and the TaskName value is Delete Aged Collected Files.

See Also

Managing Site Control Configuration, Resource Management Classes, SMS_G_System_LastSoftwareScan, SMS_G_System_SoftwareFile, SMS_G_System_SoftwareProduct, SMS_G_System_UnknownFile