Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
SMS_Collection WMI-klassen är en SMS-providerserverklass i Configuration Manager. Den representerar en samling resurser som är logiskt relaterade via regler tillsammans med samlingsinformation.
Följande syntax är förenklad 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-metoden: Lägger till en ny regel i
CollectionRulesegenskapen förSMS_Collection. -
AddMembershipRules-metoden: Lägger till flera nya regler i
CollectionRulesegenskapen förSMS_Collection. - ApproveClients-metod: Godkänner angivna klientdatorer för att ansluta till webbplatsen.
- 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-metoden: Rensar den senaste PXE-distributionen för valda klientdatorer.
- ClientEditions-metod: Hämtar en lista över klientutgåvor.
- CreateCCR-metod: Skapar en begäran om klientkonfiguration (CCR) för en viss resurs.
- CreateCCRs-metod: Genererar klientkonfigurationsbegäranden (CCR) för datorerna i samlingen.
- DeleteAllMembers metod: Tar bort alla medlemmar, d.v.s. resurser och identifieringsdata, för samlingen.
- DeleteMembershipRule metod: Tar bort en medlemskapsregel från samlingen.
- DeleteMembershipRules metod: Tar bort regler för flera medlemskap från samlingen.
- FindResourceSite-metod: Hämtar platskodinformation för en dator från platsdatabasen.
- FindMachineSite-metod: Hämtar platskodinformation för resurser från platsdatabasen.
- GetDependency-metoden: Från och med version 2010 hämtar du samlingsrelationsinformation 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 alla medlemmar i en samling, exklusive undersamlingar.
- GenerateCCRByName-metod: Genererar en begäran om klientkonfiguration efter datornamn.
- GetTotalNumResults-metod: Hämtar antalet alla medlemmar i en samling, inklusive undersamlingar.
- Metoden ReassignClientsToSite: Omtilldelar platsen för klienterna i listan.
- RequestRefresh-metod: Utlöser en omvärdering av samlingsmedlemskap av komponenten Configuration Manager samlingsutvärderare.
- SetDeviceCategory-metod: Tilldelar en kategori till en uppsättning enheter.
- SetMemberOrder metod: Anger ordningen för medlemmarna i en samling.
- UpdateVisibilityInEPDashBoard-metoden: Visa den här samlingen på instrumentpanelen för slutpunktsskydd.
- Metoden VerifyNoCircularDependencies: Verifierar att inga cirkulära beroenden bildas om en samling är överordnad en annan.
Egenskaper
CollectionID
Datatyp: String
Åtkomsttyp: Skrivskyddad
Kvalificerare: [tangent, läs]
Det unika automatiskt genererade ID:t för den här samlingen som innehåller åtta tecken.
Formatet för samlings-ID är webbplatskoden som skapade samlingen följt av ett femsiffrigt hexadecimalt serienummer, JAX0002Ctill exempel . Standardsamlingarna i Configuration Manager använder prefixet SMS, till exempel SMS00001.
CollectionRules
Datatyp: SMS_CollectionRule matris
Åtkomsttyp: Läsa/skriva
Kvalificerare: [lat]
SMS_CollectionRule WMI-klassobjekt för server som definierar medlemskapskriterierna för samlingen.
CollectionType
Datatyp: UInt32
Åtkomsttyp: Skrivskyddad
Kvalificerare: [läs, uppräkning]
Typen av samling. När du skapar eller ändrar samlingar måste samlingstypen vara samma för alla inkluderade, exkluderade och begränsade samlingar. Felmatchade samlingstyper tillåts inte.
| Värde | Samlingstyp |
|---|---|
0 |
Övrigt |
1 |
Användare |
2 |
Enhet |
CollectionVariablesCount
Datatyp: SInt32
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Antal insamlingsvariabler.
Comment
Datatyp: String
Åtkomsttyp: Läsa/skriva
Kvalificerare: Inga
Allmän kommentar eller anmärkning som dokumenterar samlingen.
CurrentStatus
Datatyp: UInt32
Åtkomsttyp: Skrivskyddad
Kvalificerare: [läs, uppräkning]
Samlingens aktuella status. Möjliga värden är:
| Värde | Aktuell status |
|---|---|
0 |
Inga |
1 |
Redo |
2 |
Uppfriskande |
3 |
Sparande |
4 |
Utvärdering |
5 |
Väntar på uppdatering |
6 |
Tar bort |
7 |
Lägger till medlem |
8 |
Fråga |
FullEvaluationRunTime
Datatyp: Uint32
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Från och med version 2010 körs den fullständiga utvärderingstiden i sekunder.
FullEvaluationMemberChanges
Datatyp: Uint32
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Från och med version 2010 ändras antalet medlemmar från den fullständiga utvärderingen.
FullEvaluationMemberChangeTime
Datatyp: Datetime
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Från och med version 2010, den senaste gången medlemskapet ändrades från fullständig utvärdering.
FullEvaluationLastRefreshTime
Datatyp: Datetime
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Från och med version 2010 är den fullständiga utvärderingens senaste uppdateringstid.
FullEvaluationNextRefreshTime
Datatyp: Datetime
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Från och med version 2010, den fullständiga utvärderingen nästa uppdateringstid.
HasProvisionedMember
Datatyp: Boolean
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
true om den här samlingen har etablerade medlemmar.
IncludeExcludeCollectionsCount
Datatyp: SInt32
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Antalet samlingar som ingår och exkluderas i den här.
IncrementalEvaluationRunTime
Datatyp: Uint32
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Från och med version 2010 körs den inkrementella utvärderingen i sekunder.
IncrementalEvaluationMemberChanges
Datatyp: Uint32
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Från och med version 2010 ändras antalet medlemmar från inkrementell utvärdering.
IncrementalEvaluationMemberChangeTime
Datatyp: Datetime
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Från och med version 2010, den senaste gången medlemskapet ändrades från inkrementell utvärdering.
IncrementalEvaluationLastRefreshTime
Datatyp: Datetime
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Från och med version 2010 är den inkrementella utvärderingens senaste uppdateringstid.
IsBuiltIn
Datatyp: Boolean
Åtkomsttyp: Read-Only
Kval: [läsa]
När det här värdet är trueär samlingen inbyggd. Till exempel Alla system.
IsReferenceCollection
Datatyp: Boolean
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
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: [lat]
ISVData-storleken.
ISVString
Datatyp: String
Åtkomsttyp: Läsa/skriva
Kvalificerare: inga
En sträng för partnerutökningsbarhet.
LastChangeTime
Datatyp: DateTime
Åtkomsttyp: Läsa/skriva
Kvalificerare: Inga
Datum och tid för när samlingen senast ändrades på något sätt.
LastMemberChangeTime
Datatyp: DateTime
Åtkomsttyp: Läsa/skriva
Kvalificerare: Inga
Datum och tid för när samlingsmedlemskapet senast ändrades.
LastRefreshTime
Datatyp: DateTime
Åtkomsttyp: Läsa/skriva
Kvalificerare: Inga
Datum och tid för när samlingsmedlemskapet senast uppdaterades.
LimitToCollectionID
Datatyp: String
Åtkomsttyp: Läsa/skriva
Kvalificerare: Inga
ID:t för den begränsande samlingen.
LimitToCollectionName
Datatyp: DateTime
Åtkomsttyp: Läsa/skriva
Kvalificerare: Inga
Namnet på den begränsande samlingen.
LocalMemberCount
Datatyp: SInt32
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Antalet medlemmar som är synliga på den lokala webbplatsen.
MemberClassName
Datatyp: String
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Namnet på klassen som innehåller medlemmarna i den här samlingen. Configuration Manager lagrar inte samlingsmedlemmar i SMS_Collection. Platsen genererar dynamiskt medlemsklassnamnet och härleds från SMS_CM_RES_COLL_CollectionID WMI-klass för servern.
MemberCount
Datatyp: SInt32
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Antalet samlingsmedlemmar.
MonitoringFlags
Datatyp: UInt32
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Aktiverar insamlingen 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 ska 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äsa]
Antal energikonfigurationer.
RefreshSchedule
Datatyp: SMS_ScheduleToken matris
Åtkomsttyp: Läsa/skriva
Kvalificerare: [max(15), lat]
SMS_ScheduleToken WMI-klassobjekt för server som anger ett uppdaterings- eller uppdateringsschema för samlingen. Webbplatsen uppdaterar endast samlingsmedlemskap om ditt program anger ett schema eller anropar RequestRefresh metoden i SMS_Collection klassen. För att samlingsutvärderaren ska använda schemat anger RefreshType du 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 |
Med jämna mellanrum |
4 |
Ständig uppdatering |
Om du vill basera uppdateringen på schemat som anges i RefreshScheduleanger du periodisk (2) för den här egenskapen. Om du ställer in den här egenskapen på manuell (1) uppdaterar du samlingen manuellt med RequestRefresh metoden .
ReplicateToSubSites
Den här egenskapen är inte implementerad.
ServiceWindowsCount
Datatyp: SInt32
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Antal underhållsperioder för den här samlingen.
UseCluster
Datatyp: Boolean
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Anger att den här samlingen är en servergrupp.
Anmärkningar
Klasskvalificerare för den här klassen är:
- Säkrad
Mer information om både klasskvalificerarna och egenskapskvalificerarna som ingår i egenskapsavsnittet finns i Configuration Manager klass- och egenskapskvalificerare.
Samlingsinformation som representeras av den här klassen omfattar 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 metoderna SMS_Collection för att lägga till, uppdatera eller ta bort medlemskapsregler som definieras av egenskapen CollectionRules . Den här egenskapen hämtas inte när programmet räknar upp SMS_Collection. För att hämta samlingsreglerna för en samling måste programmet använda IWbemServices::GetObject eller SWbemServices::Get. Mer information finns i Kontextkvalificerare för Configuration Manager.
Krav
Körningskrav
Mer information finns i Krav för serverkörning i Configuration Manager.
Utvecklingskrav
Mer information finns i Krav för serverutveckling för Configuration Manager.