WMI-klasse SMS_Collection-server

De SMS_Collection WMI-klasse is een sms-providerserverklasse in Configuration Manager. Het vertegenwoordigt een verzameling resources die logisch zijn gerelateerd door regels, samen met verzamelingsgegevens.

De volgende syntaxis is vereenvoudigd van 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 klasse:

• Methode AddMembershipRule: hiermee voegt u één nieuwe regel toe aan de CollectionRules eigenschap van SMS_Collection.
• Methode AddMembershipRules: hiermee voegt u meerdere nieuwe regels toe aan de CollectionRules eigenschap van SMS_Collection.
• Methode ApproveClients: keurt opgegeven clientcomputers goed om lid te worden van de site.
• Methode BlockClients: blokkeert opgegeven clientcomputers voor communicatie met de site.
• Methode ChangeOwnership: wijzigt het eigendom van machines in een apparaateigenaar.
• Methode ClearDeploymentLocksForCollection: hiermee worden implementatievergrendelingen voor een geselecteerde verzameling gewist.
• Methode ClearDeviceCategory: hiermee wist u een categorie van een set apparaten.
• Methode ClearLastNBSAdvForCollection: hiermee wist u de laatste PXE-implementatie voor een geselecteerde verzameling.
• Methode ClearLastNBSAdvForMachines: hiermee wist u de laatste PXE-implementatie voor geselecteerde clientcomputers.
• Methode ClientEditions: haalt een lijst met clientedities op.
• Methode CreateCCR: hiermee maakt u een clientconfiguratieaanvraag (CCR) voor een bepaalde resource.
• Methode CreateCCRs: genereert clientconfiguratieaanvragen (CCR's) voor de computers in de verzameling.
• Methode DeleteAllMembers: hiermee verwijdert u alle leden, dat wil gezegd 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.
• Methode FindResourceSite: haalt sitecodegegevens voor een computer op uit de sitedatabase.
• Methode FindMachineSite: haalt sitecodegegevens op voor resources uit de sitedatabase.
• Methode GetDependency: vanaf versie 2010 haalt u de gegevens van de verzamelingsrelatie op waarvan de invoerverzameling afhankelijk is.
• Methode GetDependent: vanaf versie 2010 haalt u de gegevens van de verzamelingsrelatie op die afhankelijk is van de invoerverzameling.
• Methode GetNumResults: hiermee wordt een telling opgehaald van alle leden in een verzameling, met uitzondering van subverzamelingen.
• Methode GenerateCCRByName: genereert een clientconfiguratieaanvraag op computernaam.
• Methode GetTotalNumResults: hiermee wordt een telling opgehaald van alle leden in een verzameling, inclusief subverzamelingen.
• Methode ReassignClientsToSite: hiermee wordt de site opnieuw toegewezen voor de clients in de lijst.
• Methode RequestRefresh: activeert een herevaluatie van het verzamelingslidmaatschap door het onderdeel Configuration Manager verzamelingsbeoordeling.
• Methode SetDeviceCategory: wijst een categorie toe aan een set apparaten.
• Methode SetMemberOrder: hiermee stelt u de volgorde van de leden van een verzameling in.
• Methode UpdateVisibilityInEPDashBoard: deze verzameling weergeven in het dashboard voor eindpuntbeveiliging.
• Methode VerifyNoCircularDependencies: controleert of er geen kringafhankelijkheden worden gevormd als een verzameling de bovenliggende van een andere is.

Eigenschappen

CollectionID

Gegevenstype: String

Toegangstype: Alleen-lezen

Kwalificatie: [sleutel, lezen]

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

De indeling van de verzamelings-id is de sitecode die de verzameling heeft gemaakt, gevolgd door een hexadecimaal serienummer van vijf cijfers, JAX0002Cbijvoorbeeld . De standaardverzamelingen Configuration Manager gebruiken het voorvoegsel SMS, SMS00001bijvoorbeeld .

CollectionRules

Gegevenstype: SMS_CollectionRule matrix

Toegangstype: Lezen/schrijven

Kwalificatie: [lui]

SMS_CollectionRule WMI-klasseobjecten van de server die de lidmaatschapscriteria voor de verzameling definiëren.

CollectionType

Gegevenstype: UInt32

Toegangstype: Alleen-lezen

Kwalificatie: [lezen, opsomming]

Het type 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.

Waarde	Verzamelingstype
0	Overige
1	Gebruiker
2	Apparaat

CollectionVariablesCount

Gegevenstype: SInt32

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

Aantal verzamelingsvariabelen.

Comment

Gegevenstype: String

Toegangstype: Lezen/schrijven

Kwalificatie: Geen

Algemene opmerking of opmerking dat de verzameling wordt documenteren.

CurrentStatus

Gegevenstype: UInt32

Toegangstype: Alleen-lezen

Kwalificatie: [lezen, opsomming]

Huidige status van de verzameling. Mogelijke waarden zijn:

Waarde	Huidige status
0	Geen
1	Klaar
2	Verfrissend
3	Opslaan
4	Evaluatie
5	In afwachting van vernieuwing
6	Verwijderen
7	Lid toevoegen
8	Opvragen

FullEvaluationRunTime

Gegevenstype: Uint32

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

Vanaf versie 2010 wordt de volledige uitvoeringstijd van de evaluatie in seconden uitgevoerd.

FullEvaluationMemberChanges

Gegevenstype: Uint32

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

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

FullEvaluationMemberChangeTime

Gegevenstype: Datetime

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

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

FullEvaluationLastRefreshTime

Gegevenstype: Datetime

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

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

FullEvaluationNextRefreshTime

Gegevenstype: Datetime

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

Vanaf versie 2010 wordt de volgende keer dat de volledige evaluatie wordt vernieuwd.

HasProvisionedMember

Gegevenstype: Boolean

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

true als deze verzameling leden heeft ingericht.

IncludeExcludeCollectionsCount

Gegevenstype: SInt32

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

Het aantal verzamelingen dat is opgenomen en uitgesloten met deze verzameling.

IncrementalEvaluationRunTime

Gegevenstype: Uint32

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

Vanaf versie 2010 wordt de uitvoeringstijd van de incrementele evaluatie in seconden uitgevoerd.

IncrementalEvaluationMemberChanges

Gegevenstype: Uint32

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

Vanaf versie 2010 verandert het aantal leden van incrementele evaluatie.

IncrementalEvaluationMemberChangeTime

Gegevenstype: Datetime

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

Vanaf versie 2010, de laatste keer dat het lidmaatschap is gewijzigd ten opzichte van incrementele evaluatie.

IncrementalEvaluationLastRefreshTime

Gegevenstype: Datetime

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

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

IsBuiltIn

Gegevenstype: Boolean

Toegangstype: Read-Only

Kwalificatie: [lezen]

Wanneer deze waarde is, wordt truede verzameling ingebouwd. Bijvoorbeeld Alle systemen.

IsReferenceCollection

Gegevenstype: Boolean

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

Als deze waarde is, wordt truede verzameling niet beperkt door een andere verzameling.

ISVData

Gegevenstype: UInt8[]

Toegangstype: Lezen/schrijven

Kwalificatie: [groot, lui]

Een gegevensruimte voor uitbreidbaarheid van partners.

ISVDataSize

Gegevenstype: UInt32

Toegangstype: Lezen/schrijven

Kwalificatie: [lui]

De GROOTTE VAN ISVData.

ISVString

Gegevenstype: String

Toegangstype: Lezen/schrijven

Kwalificatie: geen

Een tekenreeks voor uitbreidbaarheid van partners.

LastChangeTime

Gegevenstype: DateTime

Toegangstype: Lezen/schrijven

Kwalificatie: Geen

De datum en tijd waarop de verzameling voor het laatst is gewijzigd.

LastMemberChangeTime

Gegevenstype: DateTime

Toegangstype: Lezen/schrijven

Kwalificatie: Geen

De datum en tijd waarop het verzamelingslidmaatschap voor het laatst is gewijzigd.

LastRefreshTime

Gegevenstype: DateTime

Toegangstype: Lezen/schrijven

Kwalificatie: Geen

De datum en tijd waarop het verzamelingslidmaatschap voor het laatst is vernieuwd.

LimitToCollectionID

Gegevenstype: String

Toegangstype: Lezen/schrijven

Kwalificatie: Geen

De id van de beperkende verzameling.

LimitToCollectionName

Gegevenstype: DateTime

Toegangstype: Lezen/schrijven

Kwalificatie: Geen

De naam van de beperkende verzameling.

LocalMemberCount

Gegevenstype: SInt32

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

Aantal leden dat zichtbaar is op de lokale site.

MemberClassName

Gegevenstype: String

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

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

MemberCount

Gegevenstype: SInt32

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

Het aantal leden van de verzameling.

MonitoringFlags

Gegevenstype: UInt32

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

Hiermee schakelt u de verzameling in voor bepaalde soorten bewaking.

Name

Gegevenstype: String

Toegangstype: Lezen/schrijven

Kwalificatie: [Not_null]

De naam van de verzameling. Deze waarde vertegenwoordigt de verzameling in de Configuration Manager-console en moet uniek 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

Kwalificatie: [max(15), lui]

SMS_ScheduleToken server WMI-klasseobjecten die een update- of vernieuwingsschema voor de verzameling aangeven. De site werkt alleen het verzamelingslidmaatschap bij als uw toepassing een planning opgeeft of de methode RequestRefresh aanroept in de klasse SMS_Collection . Stel de eigenschap in op periodiek (2) om de verzamelings evaluator te laten gebruiken om de RefreshType planning te gebruiken.

RefreshType

Gegevenstype: UInt32

Toegangstype: Lezen/schrijven

Kwalificatie: [luie, opsomming]

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

Waarde	Type vernieuwen
1	Handmatig
2	Periodieke
4	Constante update

Als u het vernieuwen wilt baseren op de planning die 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

Kwalificatie: [lezen]

Aantal onderhoudsvensters voor deze verzameling.

UseCluster

Gegevenstype: Boolean

Toegangstype: Alleen-lezen

Kwalificatie: [lezen]

Hiermee geeft u op dat deze verzameling een servergroep is.

Opmerkingen

Klaskwalificaties voor deze klasse zijn onder andere:

• Beveiligd

Zie Configuration Manager klasse- en eigenschapskwalificaties voor meer informatie over zowel de klassekwalificaties als de eigenschapskwalificaties die zijn opgenomen in de sectie eigenschappen.

Verzamelingsgegevens die door deze klasse worden vertegenwoordigd, omvatten het vernieuwingsschema en de leden, vertegenwoordigd door WMI-klasseobjecten van SMS_CM_RES_COLL_CollectionID server . Uw toepassing kan een verzameling gebruiken om resources te richten voor softwaredistributie.

Wanneer u een query uitvoert op een dynamische verzameling die wordt vertegenwoordigd door SMS_Collection, controleert u of de SMS-provider is geladen of dat een andere methode of query al is uitgevoerd.

De toepassing moet de SMS_Collection methoden gebruiken om lidmaatschapsregels toe te voegen, bij te werken of te verwijderen die zijn gedefinieerd door de CollectionRules eigenschap. Deze eigenschap wordt niet opgehaald wanneer uw toepassing opsomt SMS_Collection. Als u de verzamelingsregels voor een verzameling wilt verkrijgen, moet uw toepassing of SWbemServices::GetgebruikenIWbemServices::GetObject. Zie Configuration Manager contextkwalificaties voor meer informatie.

Vereisten

Runtimevereisten

Zie runtimevereisten voor Configuration Manager server voor meer informatie.

Ontwikkelingsvereisten

Zie vereisten voor Configuration Manager serverontwikkeling voor meer informatie.

Zie ook

WMI-klasse SMS_CollectionRule-server