SMS_Collection kiszolgálói WMI-osztály

A SMS_Collection WMI-osztály egy SMS Provider kiszolgálóosztály a Configuration Manager. A szabályok és a gyűjteményadatok logikailag kapcsolódó erőforrások gyűjteményét jelöli.

Az alábbi szintaxis egyszerűbb a Felügyelt objektumformátum (MOF) kódból, és az összes örökölt tulajdonságot tartalmazza.

Szintaxis

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

Módszerek

A osztályban a SMS_Collection következő metódusok érhetők el:

• AddMembershipRule metódus: Hozzáad egy új szabályt a CollectionRules tulajdonságához SMS_Collection.
• AddMembershipRules metódus: Több új szabályt ad hozzá a CollectionRules tulajdonságához SMS_Collection.
• ApproveClients metódus: Jóváhagyja a megadott ügyfélszámítógépeket a helyhez való csatlakozáshoz.
• BlockClients metódus: Letiltja a megadott ügyfélszámítógépek és a hely közötti kommunikációt.
• ChangeOwnership metódus: A gépek tulajdonjogát eszköztulajdonosra módosítja.
• ClearDeploymentLocksForCollection metódus: Törli a kiválasztott gyűjtemény üzembehelyezési zárolásait.
• ClearDeviceCategory metódus: Egy kategóriát töröl egy eszközkészletből.
• ClearLastNBSAdvForCollection metódus: Törli a kijelölt gyűjtemény utolsó PXE üzemelő példányát.
• ClearLastNBSAdvForMachines metódus: Törli a kijelölt ügyfélszámítógépek utolsó PXE üzemelő példányát.
• ClientEditions metódus: Lekéri az ügyfélkiadások listáját.
• CreateCCR metódus: Létrehoz egy ügyfélkonfigurációs kérést (CCR) egy adott erőforráshoz.
• CreateCCRs metódus: Ügyfélkonfigurációs kéréseket (CCR-eket) hoz létre a gyűjteményben lévő számítógépekhez.
• DeleteAllMembers metódus: Törli a gyűjtemény összes tagját, azaz az erőforrásokat és a felderítési adatokat.
• DeleteMembershipRule metódus: Töröl egy tagsági szabályt a gyűjteményből.
• DeleteMembershipRules metódus: Több tagsági szabályt töröl a gyűjteményből.
• FindResourceSite metódus: Lekéri egy számítógép helykódadatait a helyadatbázisból.
• FindMachineSite metódus: Lekéri a helyadatbázisból származó erőforrások helykódadatait.
• GetDependency metódus: A 2010-es verziótól kezdve lekérheti a gyűjtemény kapcsolati adatait, amelyektől a bemeneti gyűjtemény függ.
• GetDependent metódus: A 2010-es verziótól kezdve lekérheti a bemeneti gyűjteménytől függő gyűjteménykapcsolati adatokat.
• GetNumResults metódus: Lekéri egy gyűjtemény összes tagjának számát, kivéve az algyűjteményeket.
• GenerateCCRByName metódus: Számítógépnév alapján hoz létre ügyfélkonfigurációs kérést.
• GetTotalNumResults metódus: Lekéri egy gyűjtemény összes tagjának számát, beleértve az algyűjteményeket is.
• ReassignClientsToSite metódus: A listában szereplő ügyfelek helyének újbóli hozzárendelése.
• RequestRefresh metódus: Aktiválja a gyűjteménytagság újraértékelését a Configuration Manager gyűjtemény kiértékelő összetevője alapján.
• SetDeviceCategory metódus: Egy kategóriát rendel egy eszközkészlethez.
• SetMemberOrder metódus: Beállítja egy gyűjtemény tagjainak sorrendjét.
• UpdateVisibilityInEPDashBoard metódus: A gyűjtemény megjelenítése az Endpoint Protection irányítópultján.
• VerifyNoCircularDependencies metódus: Ellenőrzi, hogy nincsenek-e körkörös függőségek, ha az egyik gyűjtemény a másik szülője.

Tulajdonságok

CollectionID

Adattípus: String

Hozzáférés típusa: Írásvédett

Minősítők: [kulcs, olvasás]

A gyűjtemény nyolc karakterből tevődő egyedi automatikusan létrehozott azonosítója.

A gyűjteményazonosító formátuma a gyűjteményt létrehozó helykód, amelyet egy ötjegyű hexadecimális sorozatszám követ, például JAX0002C: . Az alapértelmezett Configuration Manager gyűjtemények az SMS előtagot használják, példáulSMS00001: .

CollectionRules

Adattípus: SMS_CollectionRule tömb

Hozzáférés típusa: Olvasás/írás

Minősítők: [lusta]

SMS_CollectionRule a gyűjtemény tagsági feltételeit meghatározó kiszolgálói WMI-osztályobjektumokat.

CollectionType

Adattípus: UInt32

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás, számbavétel]

A gyűjtemény típusa. Gyűjtemények létrehozásakor vagy módosításakor a gyűjteménytípusnak meg kell egyeznie az összes belefoglalt, kizárt és korlátozott gyűjtemény esetében. A nem egyező gyűjteménytípusok nem engedélyezettek.

Érték	Gyűjtemény típusa
0	Egyéb
1	Felhasználó
2	Eszköz

CollectionVariablesCount

Adattípus: SInt32

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

Gyűjteményváltozók száma.

Comment

Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

A gyűjteményt dokumentáló általános megjegyzés vagy megjegyzés.

CurrentStatus

Adattípus: UInt32

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás, számbavétel]

A gyűjtemény aktuális állapota. A lehetséges értékek a következők:

Érték	Aktuális állapot
0	Egyikre sem.
1	Kész
2	Frissítő
3	Mentése
4	Értékelése
5	Frissítésre vár
6	Törlés
7	Hozzáfűző tag
8	Lekérdezése

FullEvaluationRunTime

Adattípus: Uint32

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

A 2010-es verziótól kezdve a teljes kiértékelési futási idő másodpercben.

FullEvaluationMemberChanges

Adattípus: Uint32

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

A 2010-es verziótól kezdődően a tagok száma a teljes kiértékeléstől kezdve változik.

FullEvaluationMemberChangeTime

Adattípus: Datetime

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

A 2010-es verziótól kezdődően a tagság legutóbbi módosítása a teljes kiértékelésről.

FullEvaluationLastRefreshTime

Adattípus: Datetime

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

A 2010-es verziótól kezdve a legutóbbi frissítés teljes kiértékelési ideje.

FullEvaluationNextRefreshTime

Adattípus: Datetime

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

A 2010-es verziótól kezdve a következő frissítés teljes kiértékelése következik.

HasProvisionedMember

Adattípus: Boolean

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

true ha ez a gyűjtemény kiosztott tagokat.

IncludeExcludeCollectionsCount

Adattípus: SInt32

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

Az ebben a gyűjteményben található és kizárt gyűjtemények száma.

IncrementalEvaluationRunTime

Adattípus: Uint32

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

A 2010-es verziótól kezdve a növekményes kiértékelés futási ideje másodpercben.

IncrementalEvaluationMemberChanges

Adattípus: Uint32

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

A 2010-es verziótól kezdődően a növekményes kiértékelés tagváltozásainak száma.

IncrementalEvaluationMemberChangeTime

Adattípus: Datetime

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

A 2010-es verziótól kezdődően a tagság legutóbbi módosítása a növekményes kiértékelésről.

IncrementalEvaluationLastRefreshTime

Adattípus: Datetime

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

A 2010-es verziótól kezdődően a növekményes kiértékelés utolsó frissítési ideje.

IsBuiltIn

Adattípus: Boolean

Hozzáférés típusa: Read-Only

Minősítők: [olvasás]

Ha ez az trueérték , a gyűjtemény be van építve. Például: Minden rendszer.

IsReferenceCollection

Adattípus: Boolean

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

Ha ez az trueérték , a gyűjteményt nem korlátozza egy másik gyűjtemény.

ISVData

Adattípus: UInt8[]

Hozzáférés típusa: Olvasás/írás

Minősítők: [nagy, lusta]

Adatterület a partner bővíthetőségéhez.

ISVDataSize

Adattípus: UInt32

Hozzáférés típusa: Olvasás/írás

Minősítők: [lusta]

Az ISVData mérete.

ISVString

Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: nincs

A partner bővíthetőségének sztringje.

LastChangeTime

Adattípus: DateTime

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

A gyűjtemény legutóbbi módosításának dátuma és időpontja.

LastMemberChangeTime

Adattípus: DateTime

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

A gyűjteménytagság utolsó módosításának dátuma és időpontja.

LastRefreshTime

Adattípus: DateTime

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

A gyűjteménytagság legutóbbi frissítésének dátuma és időpontja.

LimitToCollectionID

Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

A korlátozó gyűjtemény azonosítója.

LimitToCollectionName

Adattípus: DateTime

Hozzáférés típusa: Olvasás/írás

Minősítők: Nincs

A korlátozó gyűjtemény neve.

LocalMemberCount

Adattípus: SInt32

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

A helyi webhelyen látható tagok száma.

MemberClassName

Adattípus: String

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

A gyűjtemény tagjait tartalmazó osztály neve. Configuration Manager nem tárolja a gyűjtemény tagjait SMS_Collection. A hely dinamikusan generálja a tagosztály nevét, és SMS_CM_RES_COLL_CollectionID kiszolgálói WMI-osztályból származik.

MemberCount

Adattípus: SInt32

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

A gyűjteménytagok száma.

MonitoringFlags

Adattípus: UInt32

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

Engedélyezi a gyűjteményt bizonyos típusú figyeléshez.

Name

Adattípus: String

Hozzáférés típusa: Olvasás/írás

Minősítők: [Not_null]

A gyűjtemény neve. Ez az érték a Configuration Manager konzol gyűjteményét jelöli, és egyedinek kell lennie.

OwnedByThisSite

Adattípus: Boolean

Hozzáférés típusa: Olvasás/írás

Minősítő: Nincs

trueha a gyűjtemény a helyi Configuration Manager helyről származik. Az alapértelmezett érték : false.

PowerConfigsCount

Adattípus: SInt32

Hozzáférés típusa: Írásvédett

Minősítő: [olvasás]

Az energiakonfigurációk száma.

RefreshSchedule

Adattípus: SMS_ScheduleToken tömb

Hozzáférés típusa: Olvasás/írás

Minősítők: [max(15), lusta]

SMS_ScheduleToken kiszolgálói WMI-osztályobjektumokat , amelyek a gyűjtemény frissítési vagy frissítési ütemezését jelzik. A webhely csak akkor frissíti a gyűjteménytagságokat, ha az alkalmazás ütemezést határoz meg, vagy meghívja a RequestRefresh metódust a SMS_Collection osztályban. Ahhoz, hogy a gyűjtemény kiértékelője használja az ütemezést, állítsa a RefreshType tulajdonságot periodikusra (2).

RefreshType

Adattípus: UInt32

Hozzáférés típusa: Olvasás/írás

Minősítők: [lusta, enumerálás]

Ez az érték azt jelzi, hogy Configuration Manager hogyan frissíti a gyűjteményt. Az alapértelmezett érték a manuális (1). Lehetséges értékek:

Érték	Frissítés típusa
1	Kézi
2	Időszakos
4	Állandó frissítés

Ha a frissítést a megadott RefreshScheduleütemezés alapján szeretné alapozni, állítsa ezt a tulajdonságot periodikus (2) értékre. Ha ezt a tulajdonságot manuális (1) értékre állítja, manuálisan frissítse a gyűjteményt a RequestRefresh metódussal.

ReplicateToSubSites

Ez a tulajdonság nincs implementálva.

ServiceWindowsCount

Adattípus: SInt32

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

A gyűjtemény karbantartási időszakainak száma.

UseCluster

Adattípus: Boolean

Hozzáférés típusa: Írásvédett

Minősítők: [olvasás]

Meghatározza, hogy ez a gyűjtemény egy kiszolgálócsoport.

Megjegyzések

Az osztály osztályminősítői a következők:

• Biztosított

A tulajdonságok szakaszban szereplő osztály- és tulajdonságminősítőkkel kapcsolatos további információkért lásd: Configuration Manager osztály- és tulajdonságminősítők.

Az osztály által képviselt gyűjteményadatok tartalmazzák a frissítési ütemezést és a SMS_CM_RES_COLL_CollectionID kiszolgálói WMI-osztályobjektumok által képviselt tagokat. Az alkalmazás egy gyűjtemény használatával megcélzhatja az erőforrásokat a szoftverterjesztéshez.

Ha a által SMS_Collectionképviselt dinamikus gyűjteményen futtat lekérdezést, győződjön meg arról, hogy az SMS-szolgáltató be van töltve, vagy hogy egy másik metódus vagy lekérdezés már lefutott.

Az alkalmazásnak a SMS_Collection metódusok használatával kell hozzáadnia, frissítenie vagy törölnie a tulajdonság által meghatározott tagsági CollectionRules szabályokat. Ez a tulajdonság nem lesz lekérve, amikor az alkalmazás számbavételt ad SMS_Collection. Egy gyűjtemény gyűjtési szabályainak beszerzéséhez az alkalmazásnak a vagy SWbemServices::Geta parancsot kell használniaIWbemServices::GetObject. További információ: Configuration Manager környezeti minősítők.

Követelmények

Futtatókörnyezetre vonatkozó követelmények

További információ: Configuration Manager kiszolgálói futtatókörnyezet követelményei.

Fejlesztési követelmények

További információ: Configuration Manager kiszolgálófejlesztési követelmények.

Lásd még

SMS_CollectionRule kiszolgálói WMI-osztály