SMS_Collection server WMI-klasse

De SMS_Collection WMI-klasse is een SMS-providerserverklasse in Configuration Manager. Het vertegenwoordigt een verzameling bronnen die logisch met elkaar zijn verbonden door regels, samen met verzamelingsinformatie.

De volgende syntaxis is vereenvoudigd ten opzichte van de MOF-code (Managed Object Format) en bevat alle overgenomen eigenschappen.

Syntaxis

Class SMS_Collection : SMS_BaseClass
{
   String CollectionID;
   SMS_CollectionRule CollectionRules[];
   UInt32 CollectionType;
   SInt32 CollectionVariablesCount;
   String Comment;
   UInt32 CurrentStatus;
   Uint32 FullEvaluationRunTime;
   Uint32 FullEvaluationMemberChanges;
   DateTime FullEvaluationMemberChangeTime;
   DateTime FullEvaluationLastRefreshTime;
   DateTime FullEvaluationNextRefreshTime;
   Boolean HasProvisionedMember;
   SInt32 IncludeExcludeCollectionsCount;
   Uint32 IncrementalEvaluationRunTime;
   Uint32 IncrementalEvaluationMemberChanges;
   DateTime IncrementalEvaluationMemberChangeTime;
   DateTime IncrementalEvaluationLastRefreshTime;
   Boolean IsBuiltIn;
   Boolean IsReferenceCollection;
   UInt8 ISVData[];
   UInt32 ISVDataSize;
   String ISVString;
   DateTime LastChangeTime;
   DateTime LastMemberChangeTime;
   DateTime LastRefreshTime;
   String LimitToCollectionID;
   String LimitToCollectionName;
   SInt32 LocalMemberCount;
   String MemberClassName;
   SInt32 MemberCount;
   UInt32 MonitoringFlags;
   String Name;
   Boolean OwnedByThisSite;
   SInt32 PowerConfigsCount;
   SMS_ScheduleToken RefreshSchedule[];
   UInt32 RefreshType;
   Boolean ReplicateToSubSites;
   SInt32 ServiceWindowsCount;
   Boolean UseCluster;
};

Methoden

De volgende methoden zijn beschikbaar in de SMS_Collection les:

• AddMembershipRule methode: voegt een nieuwe regel toe aan de CollectionRules eigenschap van SMS_Collection.
• Methode AddMembershipRules: hiermee worden meerdere nieuwe regels toegevoegd aan de CollectionRules eigenschap van SMS_Collection.
• ApproveClients-methode: geeft goedkeuring voor het lid worden van de site op opgegeven clientcomputers.
• BlockClients-methode: Hiermee wordt voorkomen dat bepaalde clientcomputers communiceren met de site.
• ChangeOwnership-methode: wijzigt het eigendom van machines in de eigenaar van een apparaat.
• ClearDeploymentLocksForCollection-methode: wist implementatievergrendelingen voor een geselecteerde verzameling.
• ClearDeviceCategory-methode: wist een categorie uit een set apparaten.
• ClearLastNBSAdvForCollection-methode: wist de laatste PXE-implementatie voor een geselecteerde verzameling.
• De methode ClearLastNBSAdvForMachines: wist de laatste PXE-implementatie voor geselecteerde clientcomputers.
• ClientEditions-methode: Hiermee wordt een lijst met clientedities opgehaald.
• CreateCCR-methode: maakt een clientconfiguratieaanvraag (CCR) voor een bepaalde resource.
• CreateCCR-methode: genereert clientconfiguratieaanvragen (CCR's) voor de computers in de verzameling.
• DeleteAllMembers-methode: verwijdert alle leden, dat wil zeggen resources en detectiegegevens, voor de verzameling.
• Methode DeleteMembershipRule: hiermee verwijdert u een lidmaatschapsregel uit de verzameling.
• Methode DeleteMembershipRules: hiermee verwijdert u meerdere lidmaatschapsregels uit de verzameling.
• FindResourceSite-methode: haalt sitecodegegevens voor een computer op uit de sitedatabase.
• FindMachineSite-methode: haalt informatie over de sitecode voor resources op uit de sitedatabase.
• GetDependency-methode: vanaf versie 2010 de informatie over de verzamelingsrelatie ophalen waarvan de invoerverzameling afhankelijk is.
• GetDepended-methode: vanaf versie 2010 haalt u de informatie over de verzamelingsrelatie op die afhankelijk is van de invoerverzameling.
• De methode GetNumResults: telt het aantal leden in een verzameling, met uitzondering van subverzamelingen.
• GenerateCCRByName-methode: genereert een clientconfiguratieaanvraag op basis van de computernaam.
• De methode GetTotalNumResults: Hiermee wordt het aantal leden in een verzameling, inclusief subverzamelingen, opgehaald.
• ReassignClientsToSite-methode: hiermee wijst u de site opnieuw toe voor de klanten in de lijst.
• RequestRefresh-methode: activeert een herevaluatie van het lidmaatschap van de verzameling door het Configuration Manager-verzamelingsevaluatieonderdeel.
• SetDeviceCategory-methode: wijst een categorie toe aan een set apparaten.
• SetMemberOrder-methode: stelt de volgorde van de leden van een verzameling in.
• UpdateVisibilityInEPDashBoard-methode: geef deze verzameling weer in het dashboard voor eindpuntbeveiliging.
• De VerifyNoCircularDependencies-methode: er wordt gecontroleerd of er geen circulaire afhankelijkheden worden gevormd als een verzameling de bovenliggende site is van een andere verzameling.

Eigenschappen

CollectionID

Gegevenstype: String

Toegangstype: Alleen-lezen

Kwalificaties: [toets, lezen]

De unieke automatisch gegenereerde id voor deze verzameling die acht tekens bevat.

De notatie van de verzamelings-id is de sitecode waarmee de verzameling is gemaakt, gevolgd door een hexadecimaal serieel getal van vijf cijfers, JAX0002Cbijvoorbeeld . De standaardverzamelingen van Configuration Manager gebruiken het voorvoegsel SMS, bijvoorbeeld: SMS00001.

CollectionRules

Gegevenstype: SMS_CollectionRule matrix

Toegangstype: Lezen/schrijven

Kwalificaties: [lui]

SMS_CollectionRule WMI-klasseobjecten van de server waarmee de lidmaatschapscriteria voor de verzameling worden gedefinieerd.

CollectionType

Gegevenstype: UInt32

Toegangstype: Alleen-lezen

Kwalificaties: [lezen, opsomming]

Het type van de verzameling. Bij het maken of wijzigen van verzamelingen moet het verzamelingstype hetzelfde zijn voor alle opgenomen, uitgesloten en beperkte verzamelingen. Niet-overeenkomende verzamelingstypen zijn niet toegestaan.

CollectionVariablesCount

Gegevenstype: SInt32

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Aantal verzamelingsvariabelen.

Comment

Gegevenstype: String

Toegangstype: Lezen/schrijven

Kwalificaties: Geen

Algemene opmerking of notitie die de collectie documenteert.

CurrentStatus

Gegevenstype: UInt32

Toegangstype: Alleen-lezen

Kwalificaties: [lezen, opsomming]

Huidige status van de verzameling. Mogelijke waarden zijn:

FullEvaluationRunTime

Gegevenstype: Uint32

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Vanaf versie 2010 is de volledige evaluatieduur in seconden.

FullEvaluationMemberChanges

Gegevenstype: Uint32

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Vanaf versie 2010 verandert het aantal leden ten opzichte van de volledige evaluatie.

FullEvaluationMemberChangeTime

Gegevenstype: Datetime

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Vanaf versie 2010, de laatste keer dat het lidmaatschap is gewijzigd van volledige evaluatie.

FullEvaluationLastRefreshTime

Gegevenstype: Datetime

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Vanaf versie 2010 is de laatste vernieuwingstijd van de volledige evaluatie.

FullEvaluationNextRefreshTime

Gegevenstype: Datetime

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Vanaf versie 2010 is de volgende keer dat de volledige evaluatie wordt uitgevoerd.

HasProvisionedMember

Gegevenstype: Boolean

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

true als voor deze verzameling leden zijn ingericht.

IncludeExcludeCollectionsCount

Gegevenstype: SInt32

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Het aantal verzamelingen dat in deze verzameling is opgenomen of uitgesloten.

IncrementalEvaluationRunTime

Gegevenstype: Uint32

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Vanaf versie 2010 is de uitvoeringsduur van de incrementele evaluatie in seconden.

IncrementalEvaluationMemberChanges

Gegevenstype: Uint32

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Vanaf versie 2010 verandert het aantal leden ten opzichte van incrementele evaluatie.

IncrementalEvaluationMemberChangeTime

Gegevenstype: Datetime

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Vanaf versie 2010, de laatste keer dat het lidmaatschap is gewijzigd na incrementele evaluatie.

IncrementalEvaluationLastRefreshTime

Gegevenstype: Datetime

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Vanaf versie 2010 is de incrementele evaluatie het laatst vernieuwd.

IsBuiltIn

Gegevenstype: Boolean

Toegangstype: Read-Only

Kwalificaties: [lees]

Wanneer deze waarde is true, is de verzameling ingebouwd. Bijvoorbeeld: Alle systemen.

IsReferenceCollection

Gegevenstype: Boolean

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Wanneer deze waarde is true, wordt de verzameling niet beperkt door een andere verzameling.

ISVData

Gegevenstype: UInt8[]

Toegangstype: Lezen/schrijven

Kwalificaties: [groot, lui]

Een gegevensruimte voor partneruitbreidingen.

ISVDataSize

Gegevenstype: UInt32

Toegangstype: Lezen/schrijven

Kwalificaties: [lui]

De ISVData-grootte.

ISVString

Gegevenstype: String

Toegangstype: Lezen/schrijven

Kwalificaties: geen

Een tekenreeks voor partneruitbreidbaarheid.

LastChangeTime

Gegevenstype: DateTime

Toegangstype: Lezen/schrijven

Kwalificaties: Geen

Datum en tijd waarop de collectie voor het laatst op enigerlei wijze is gewijzigd.

LastMemberChangeTime

Gegevenstype: DateTime

Toegangstype: Lezen/schrijven

Kwalificaties: Geen

Datum en tijd waarop het lidmaatschap van de collectie voor het laatst is gewijzigd.

LastRefreshTime

Gegevenstype: DateTime

Toegangstype: Lezen/schrijven

Kwalificaties: Geen

De datum en tijd waarop het lidmaatschap van de verzameling voor het laatst is vernieuwd.

LimitToCollectionID

Gegevenstype: String

Toegangstype: Lezen/schrijven

Kwalificaties: Geen

De id van de beperkende verzameling.

LimitToCollectionName

Gegevenstype: DateTime

Toegangstype: Lezen/schrijven

Kwalificaties: Geen

De naam van de beperkende verzameling.

LocalMemberCount

Gegevenstype: SInt32

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Het aantal leden dat zichtbaar is op de lokale site.

MemberClassName

Gegevenstype: String

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

De naam van de klas die de leden van deze verzameling bevat. Configuration Manager slaat verzamelingsleden niet op in SMS_Collection. De site genereert dynamisch de naam van de lidklasse en is afgeleid van SMS_CM_RES_COLL_CollectionID WMI-klasse van de server.

MemberCount

Gegevenstype: SInt32

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Het aantal leden van de verzameling.

MonitoringFlags

Gegevenstype: UInt32

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Hiermee kunt u het verzamelen voor bepaalde soorten monitoring inschakelen.

Name

Gegevenstype: String

Toegangstype: Lezen/schrijven

Kwalificaties: [Not_null]

De naam van de verzameling. Deze waarde vertegenwoordigt de verzameling in de Configuration Manager-console en zou uniek moeten zijn.

OwnedByThisSite

Gegevenstype: Boolean

Toegangstype: Lezen/schrijven

Kwalificatie: Geen

trueals de verzameling afkomstig is van de lokale Configuration Manager-site. De standaardwaarde is false.

PowerConfigsCount

Gegevenstype: SInt32

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

Een telling van de energieconfiguraties.

RefreshSchedule

Gegevenstype: SMS_ScheduleToken matrix

Toegangstype: Lezen/schrijven

Kwalificaties: [max(15), lui]

SMS_ScheduleToken WMI-klasseobjecten van de server die een update- of vernieuwingsschema voor de verzameling aangeven. De site werkt alleen het lidmaatschap van de verzameling bij als in uw toepassing een planning wordt opgegeven of als de methode RequestRefresh in de SMS_Collection-klasse wordt aangeroepen. Als u wilt dat de verzamelbeoordelaar het schema gebruikt, stelt u de RefreshType eigenschap in op periodiek (2).

RefreshType

Gegevenstype: UInt32

Toegangstype: Lezen/schrijven

Kwalificaties: [lui, opsomming]

Deze waarde geeft aan hoe de verzameling door Configuration Manager wordt vernieuwd. De standaardwaarde is handmatig (1). Mogelijke waarden:

Als u het vernieuwen wilt baseren op het schema dat is opgegeven in RefreshSchedule, stelt u deze eigenschap in op periodiek (2). Als u deze eigenschap instelt op handmatig (1), werkt u de verzameling handmatig bij met de methode RequestRefresh.

ReplicateToSubSites

Deze eigenschap is niet geïmplementeerd.

ServiceWindowsCount

Gegevenstype: SInt32

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Aantal onderhoudsvensters voor deze verzameling.

UseCluster

Gegevenstype: Boolean

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Geeft aan dat deze verzameling een servergroep is.

Opmerkingen

Klassekwalificaties voor deze klasse zijn onder meer:

• Beveiligd

Zie Klasse- en eigenschapskwalificaties in Configuration Manager voor meer informatie over klasse- en eigenschapskwalificaties in de sectie Eigenschappen.

Verzamelingsinformatie die door deze klasse wordt vertegenwoordigd, omvat het vernieuwingsschema en de leden, vertegenwoordigd door SMS_CM_RES_COLL_CollectionID WMI-klasseobjecten van de server . Uw toepassing kan een verzameling gebruiken om bronnen voor softwaredistributie te richten.

Wanneer je een query uitvoert op een dynamische verzameling die wordt vertegenwoordigd door SMS_Collection, zorg er dan voor dat de sms-provider is geladen of dat er al een andere methode of query is uitgevoerd.

De toepassing moet de methoden gebruiken voor het SMS_Collection toevoegen, bijwerken of verwijderen van lidmaatschapsregels die door de CollectionRules eigenschap zijn gedefinieerd. Deze eigenschap wordt niet opgehaald wanneer uw toepassing .SMS_Collection Om de verzamelregels voor een verzameling te verkrijgen, moet IWbemServices::GetObject uw toepassing of .SWbemServices::Get Zie Contextkwalificaties in Configuration Manager voor meer informatie.

Vereisten

Runtime vereisten

Zie de runtimevereisten voor de Configuration Manager-server voor meer informatie.

Vereisten voor ontwikkeling

Zie de vereisten voor de ontwikkeling van de Configuration Manager-server voor meer informatie.

Zie ook

SMS_CollectionRule server WMI-klasse