CollectableFileItem, klientens WMI-klass

Artikel
2023-04-04

I Configuration Manager är klassen CollectableFileItem en WMI-klass (Client Windows Management Instrumentation) som definierar attribut för en filsamlingsregel. Regelattributen definierar kriterier, till exempel filnamn, katalogsökvägar och filstorleksgränser. Ett exempel är collect *.mif in %windir% up to 10 KB.

Följande syntax förenklas från MOF-kod (Managed Object Format) och innehåller alla ärvda egenskaper.

Syntax

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

Metoder

Klassen CollectableFileItem definierar inga metoder.

Egenskaper

ExcludeCompressedEncrypted
Datatyp: Boolean

Åtkomsttyp: Läsa/skriva

Kvalificerare: Ingen

Flagga som anger om komprimerade eller krypterade filer och kataloger eller båda ska undantas från genomsökningen. Det här egenskapsvärdet översätts vanligtvis till frågevärdet FileSystemFile, IsCompressed och IsEncrypted .

FileCollectionActionID
Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Ingen

ID som matchar egenskapen FileCollectionActionID för ett associerat FileCollectionAction-klientens WMI-klassobjekt . Inventeringsagenten använder det här värdet för att hitta klassen CollectableFileItem, klientens WMI-klass för en viss filsamlingsåtgärd.

FileItemID
Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: [realkey]

Unikt ID för ett CollectableFileItem-objekt .

FileSpec
Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Ingen

Filmask, inklusive jokertecken, som används för att ange filnamn som ska samlas in, till exempel Virussig.dat, Boot*.ini och *.mif.

MaxItemFileSize
Datatyp: UInt32

Åtkomsttyp: Läsa/skriva

Kvalificerare: Ingen

Total storlek i byte tillåts för filer som samlas in enligt den här regeln. Samla till exempel in filer upp till totalt 128 KB för den här regeln.

PolicyID
Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: [nyckel]

Unikt ID för principen.

PolicyInstanceID
Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: [nyckel]

Unikt ID för principinstansen.

PolicyPrecedence
Datatyp: UInt32

Åtkomsttyp: Läsa/skriva

Kvalificerare: Ingen

Prioritet för principen.

PolicyRuleID
Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: [nyckel]

Unikt ID för regeln som används för att skapa principen.

PolicySource
Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: [nyckel]

Principens källa.

PolicyVersion
Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: [nyckel]

Version av principen.

ScanSubdirectories
Datatyp: Boolean

Åtkomsttyp: Läsa/skriva

Kvalificerare: Ingen

Flagga som anger om filgenomsökningen ska genomsöka underkataloger eller endast genomsöka rotkatalogen som anges av SearchPath. Det här egenskapsvärdet används för att formatera frågevärdet filesystemfilePath , till exempel c:\\* jämfört med c:\\.

SearchPath
Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Ingen

Rotkatalogen för genomsökningen, till exempel c:\, %windir%, och d:\myapplication\. Den här egenskapen översätts till egenskapsvärdet FileSystemFilePath .

Timeout
Datatyp: UInt32

Åtkomsttyp: Läsa/skriva

Kvalificerare: Ingen

Timeout-värde i millisekunder. Om en FileSystemFile-fråga som initierades av inventeringsagenten under en genomsökning av filsamlingen körs längre än det angivna tidsgränsvärdet avbryts frågan. Standardvärdet är 7 200 000 millisekunder.

Anmärkningar

Inventeringsagenten använder varje instans av den här klassen för att skapa en FileSystemFile-fråga och samlar in filer som matchar regelattributen. Den här klassen liknar InventoryDataItem, även om egenskaperna är mindre direkt översatta till en WQL-instruktion. Objektegenskaperna används dock för att formatera den specifika FileSystemFile-frågan för regeln och används sedan för att identifiera filer som matchar attributkriterierna. Dessa matchande filer kopplas sedan till den genererade insamlade filrapporten.

Varje CollectableFileItem-instans innehåller en referens till en FileCollectionAction-instans . flera CollectableFileItem-regler används för att skapa den kombinerade insamlade filrapporten för en enda FileCollectionAction-instans .