SMS_Collection serverns WMI-klass

SMS_Collection WMI-klassen är en SMS-providerserverklass i Configuration Manager. Den representerar en samling resurser som är logiskt relaterade efter regler tillsammans med samlingsinformation.

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

Syntax

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

Metoder

Följande metoder är tillgängliga i SMS_Collection klassen :

• AddMembershipRule-metod: Lägger till en ny regel i CollectionRules egenskapen SMS_Collection.
• AddMembershipRules-metod: Lägger till flera nya regler i CollectionRules egenskapen SMS_Collectionför .
• ApproveClients-metod: Godkänner angivna klientdatorer för att ansluta till platsen.
• BlockClients-metod: Blockerar angivna klientdatorer från att kommunicera med platsen.
• ChangeOwnership-metod: Ändrar ägarskapet för datorer till en enhetsägare.
• ClearDeploymentLocksForCollection-metod: Rensar distributionslås för en vald samling.
• ClearDeviceCategory-metod: Rensar en kategori från en uppsättning enheter.
• ClearLastNBSAdvForCollection-metod: Rensar den senaste PXE-distributionen för en vald samling.
• ClearLastNBSAdvForMachines-metod: Rensar den senaste PXE-distributionen för valda klientdatorer.
• ClientEditions-metod: Hämtar en lista över klientversioner.
• CreateCCR-metod: Skapar en klientkonfigurationsbegäran (CCR) för en viss resurs.
• CreateCCRs-metod: Genererar klientkonfigurationsbegäranden (CCR) för datorerna i samlingen.
• DeleteAllMembers-metod: Tar bort alla medlemmar, dvs. resurser och identifieringsdata, för samlingen.
• DeleteMembershipRule-metod: Tar bort en medlemskapsregel från samlingen.
• DeleteMembershipRules-metod: Tar bort flera medlemskapsregler från samlingen.
• FindResourceSite-metod: Hämtar platskodsinformation för en dator från platsdatabasen.
• FindMachineSite-metod: Hämtar platskodsinformation för resurser från platsdatabasen.
• GetDependency-metoden: Från och med version 2010 hämtar du den information om samlingsrelationen som indatasamlingen är beroende av.
• GetDependent-metod: Från och med version 2010 hämtar du information om samlingsrelationen som är beroende av indatasamlingen.
• GetNumResults-metod: Hämtar antalet medlemmar i en samling, exklusive undersamlingar.
• GenerateCCRByName-metod: Genererar en klientkonfigurationsbegäran efter datornamn.
• GetTotalNumResults-metod: Hämtar antalet medlemmar i en samling, inklusive undersamlingar.
• ReassignClientsToSite-metod: Omtilldelar platsen för klienterna i listan.
• RequestRefresh-metod: Utlöser en ny utvärdering av samlingsmedlemskap av komponenten Configuration Manager samlingsutvärdering.
• SetDeviceCategory-metod: Tilldelar en kategori till en uppsättning enheter.
• SetMemberOrder-metod: Anger ordningen för medlemmarna i en samling.
• UpdateVisibilityInEPDashBoard-metod: Visa den här samlingen på instrumentpanelen för slutpunktsskydd.
• VerifyNoCircularDependencies-metod: Verifierar att inga cirkulära beroenden skapas om en samling är överordnad till en annan.

Egenskaper

CollectionID

Datatyp: String

Åtkomsttyp: Skrivskyddad

Kvalificerare: [key, read]

Det unika autogenererade ID:t för den här samlingen som innehåller åtta tecken.

Formatet för samlings-ID:t är platskoden som skapade samlingen följt av ett femsiffrigt hexadecimalt serienummer, JAX0002Ctill exempel . Standard-Configuration Manager-samlingar använder prefixet SMS, till exempel SMS00001.

CollectionRules

Datatyp: SMS_CollectionRule matris

Åtkomsttyp: Läsa/skriva

Kvalificerare: [lazy]

SMS_CollectionRule WMI-klassobjekt som definierar medlemskapskriterierna för samlingen.

CollectionType

Datatyp: UInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read, enumeration]

Typen av samling. När du skapar eller ändrar samlingar måste samlingstypen vara samma för alla inkluderade, exkluderade och begränsade samlingar. Samlingstyper som inte matchar tillåts inte.

Värde	Samlingstyp
0	Övrigt
1	Användare
2	Enhet

CollectionVariablesCount

Datatyp: SInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Antal samlingsvariabler.

Comment

Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Ingen

Allmän kommentar eller observera att dokument samlingen.

CurrentStatus

Datatyp: UInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read, enumeration]

Aktuell status för samlingen. Möjliga värden är:

Värde	Aktuell status
0	Inga
1	Redo
2	Uppfriskande
3	Spara
4	Utvärdera
5	Väntar på uppdatering
6	Ta bort
7	Lägger till medlem
8	Frågor

FullEvaluationRunTime

Datatyp: Uint32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Från och med version 2010 körs den fullständiga utvärderingen i sekunder.

FullEvaluationMemberChanges

Datatyp: Uint32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Från och med version 2010 ändras antalet medlemmar från den fullständiga utvärderingen.

FullEvaluationMemberChangeTime

Datatyp: Datetime

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Från och med version 2010 ändrades det senaste medlemskapet från fullständig utvärdering.

FullEvaluationLastRefreshTime

Datatyp: Datetime

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Från och med version 2010 är den fullständiga utvärderingen den senaste uppdateringstiden.

FullEvaluationNextRefreshTime

Datatyp: Datetime

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Från och med version 2010, den fullständiga utvärderingen nästa uppdateringstid.

HasProvisionedMember

Datatyp: Boolean

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

true om den här samlingen har etablerade medlemmar.

IncludeExcludeCollectionsCount

Datatyp: SInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Antal samlingar som ingår och exkluderas med den här.

IncrementalEvaluationRunTime

Datatyp: Uint32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Från och med version 2010 körs den inkrementella utvärderingen i sekunder.

IncrementalEvaluationMemberChanges

Datatyp: Uint32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Från och med version 2010 ändras antalet medlemmar från inkrementell utvärdering.

IncrementalEvaluationMemberChangeTime

Datatyp: Datetime

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Från och med version 2010 ändrades det senaste medlemskapet från inkrementell utvärdering.

IncrementalEvaluationLastRefreshTime

Datatyp: Datetime

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Från och med version 2010, den inkrementella utvärderingen senaste uppdateringstiden.

IsBuiltIn

Datatyp: Boolean

Åtkomsttyp: Read-Only

Kvalificerare: [read]

När det här värdet är trueär samlingen inbyggd. Till exempel Alla system.

IsReferenceCollection

Datatyp: Boolean

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

När det här värdet är truebegränsas inte samlingen av en annan samling.

ISVData

Datatyp: UInt8[]

Åtkomsttyp: Läsa/skriva

Kvalificerare: [stor, lat]

Ett datautrymme för partnerutökningsbarhet.

ISVDataSize

Datatyp: UInt32

Åtkomsttyp: Läsa/skriva

Kvalificerare: [lazy]

ISVData-storleken.

ISVString

Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: ingen

En sträng för utökningsbarhet för partner.

LastChangeTime

Datatyp: DateTime

Åtkomsttyp: Läsa/skriva

Kvalificerare: Ingen

Datum och tid för när samlingen senast ändrades på något sätt.

LastMemberChangeTime

Datatyp: DateTime

Åtkomsttyp: Läsa/skriva

Kvalificerare: Ingen

Datum och tid för när samlingsmedlemskapet senast ändrades.

LastRefreshTime

Datatyp: DateTime

Åtkomsttyp: Läsa/skriva

Kvalificerare: Ingen

Datum och tid för när samlingsmedlemskapet senast uppdaterades.

LimitToCollectionID

Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Ingen

ID för den begränsande samlingen.

LimitToCollectionName

Datatyp: DateTime

Åtkomsttyp: Läsa/skriva

Kvalificerare: Ingen

Namnet på den begränsande samlingen.

LocalMemberCount

Datatyp: SInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Antal medlemmar som visas på den lokala webbplatsen.

MemberClassName

Datatyp: String

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Namnet på klassen som innehåller medlemmarna i den här samlingen. Configuration Manager lagrar inte samlingsmedlemmar i SMS_Collection. Webbplatsen genererar medlemsklassnamnet dynamiskt och härleds från SMS_CM_RES_COLL_CollectionID serverns WMI-klass.

MemberCount

Datatyp: SInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Antalet medlemmar i samlingen.

MonitoringFlags

Datatyp: UInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Aktiverar samlingen för vissa typer av övervakning.

Name

Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: [Not_null]

Namnet på samlingen. Det här värdet representerar samlingen i Configuration Manager-konsolen och bör vara unikt.

OwnedByThisSite

Datatyp: Boolean

Åtkomsttyp: Läsa/skriva

Kvalificerare: Ingen

trueom samlingen har sitt ursprung på den lokala Configuration Manager platsen. Standardvärdet är false.

PowerConfigsCount

Datatyp: SInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [läs]

Antal energikonfigurationer.

RefreshSchedule

Datatyp: SMS_ScheduleToken matris

Åtkomsttyp: Läsa/skriva

Kvalificerare: [max(15), lazy]

SMS_ScheduleToken WMI-klassobjekt som anger ett uppdaterings- eller uppdateringsschema för samlingen. Webbplatsen uppdaterar endast samlingsmedlemskap om ditt program anger ett schema eller anropar metoden RequestRefresh i klassen SMS_Collection . För att samlingsutvärderingen ska använda schemat anger du RefreshType egenskapen till periodisk (2).

RefreshType

Datatyp: UInt32

Åtkomsttyp: Läsa/skriva

Kvalificerare: [lazy, uppräkning]

Det här värdet anger hur Configuration Manager uppdaterar samlingen. Standardvärdet är manuellt (1). Möjliga värden:

Värde	Uppdateringstyp
1	Manuell
2	Periodiska
4	Konstant uppdatering

Om du vill basera uppdateringen på det schema som anges i RefreshScheduleanger du den här egenskapen till periodisk (2). Om du anger den här egenskapen till manuell (1) uppdaterar du samlingen manuellt med metoden RequestRefresh.

ReplicateToSubSites

Den här egenskapen har inte implementerats.

ServiceWindowsCount

Datatyp: SInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Antal underhållsperioder för den här samlingen.

UseCluster

Datatyp: Boolean

Åtkomsttyp: Skrivskyddad

Kvalificerare: [read]

Anger att den här samlingen är en servergrupp.

Anmärkningar

Klasskvalificerare för den här klassen omfattar:

• Säkrade

Mer information om både klasskvalificerare och egenskapskvalificerare som ingår i avsnittet egenskaper finns i Configuration Manager klass- och egenskapskvalificerare.

Samlingsinformation som representeras av den här klassen innehåller uppdateringsschemat och medlemmarna, som representeras av SMS_CM_RES_COLL_CollectionID WMI-klassobjekt för servern . Ditt program kan använda en samling för att rikta resurser för programvarudistribution.

När du kör en fråga mot en dynamisk samling som representeras av SMS_Collectionkontrollerar du att SMS-providern har lästs in eller att en annan metod eller fråga redan har körts.

Programmet bör använda SMS_Collection metoderna för att lägga till, uppdatera eller ta bort medlemskapsregler som definierats av CollectionRules egenskapen . Den här egenskapen hämtas inte när programmet räknar SMS_Collectionupp . Om du vill hämta insamlingsreglerna för en samling måste ditt program använda IWbemServices::GetObject eller SWbemServices::Get. Mer information finns i Configuration Manager kontextkvalificerare.

Krav

Körningskrav

Mer information finns i Configuration Manager serverkörningskrav.

Utvecklingskrav

Mer information finns i Configuration Manager serverutvecklingskrav.

Se även

SMS_CollectionRule serverns WMI-klass