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
egenskapenSMS_Collection
. -
AddMembershipRules-metod: Lägger till flera nya regler i
CollectionRules
egenskapenSMS_Collection
fö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, JAX0002C
till 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 true
begrä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
true
om 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 RefreshSchedule
anger 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_Collection
kontrollerar 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_Collection
upp . 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.