Serverová třída služby WMI SMS_Collection
Třída SMS_Collection
služby WMI je serverová třída poskytovatele serveru SMS v Configuration Manager. Představuje kolekci prostředků, které logicky souvisejí pomocí pravidel spolu s informacemi o kolekci.
Následující syntaxe je zjednodušená z kódu MOF (Managed Object Format) a zahrnuje všechny zděděné vlastnosti.
Syntaxe
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;
};
Metody
Ve třídě jsou k dispozici SMS_Collection
následující metody:
-
Metoda AddMembershipRule: Přidá jedno nové pravidlo do
CollectionRules
vlastnostiSMS_Collection
. -
Metoda AddMembershipRules: Přidá do
CollectionRules
vlastnostiSMS_Collection
více nových pravidel . - Metoda ApproveClients: Schválí zadané klientské počítače pro připojení k lokalitě.
- Metoda BlockClients: Blokuje komunikaci zadaných klientských počítačů s lokalitou.
- Metoda ChangeOwnership: Změní vlastnictví počítačů na vlastníka zařízení.
- Metoda ClearDeploymentLocksForCollection: Vymaže zámky nasazení pro vybranou kolekci.
- Metoda ClearDeviceCategory: Vymaže kategorii ze sady zařízení.
- Metoda ClearLastNBSAdvForCollection: Vymaže poslední nasazení PXE pro vybranou kolekci.
- Metoda ClearLastNBSAdvForMachines: Vymaže poslední nasazení PXE pro vybrané klientské počítače.
- Metoda ClientEditions: Načte seznam edicí klienta.
- Metoda CreateCCR: Vytvoří požadavek na konfiguraci klienta (CCR) pro konkrétní prostředek.
- Metoda CreateCCRs: Generuje požadavky na konfiguraci klienta (CCR) pro počítače v kolekci.
- Metoda DeleteAllMembers: Odstraní všechny členy, tj. prostředky a data zjišťování, pro kolekci.
- Metoda DeleteMembershipRule: Odstraní pravidlo členství z kolekce.
- Metoda DeleteMembershipRules: Odstraní z kolekce více pravidel členství.
- Metoda FindResourceSite: Získá informace o kódu lokality pro počítač z databáze lokality.
- Metoda FindMachineSite: Získá informace o kódu lokality pro prostředky z databáze lokality.
- Metoda GetDependency: Od verze 2010 získejte informace o relaci kolekce, na které závisí vstupní kolekce.
- Metoda GetDependent: Od verze 2010 získejte informace o relaci kolekce, která závisí na vstupní kolekci.
- Metoda GetNumResults: Získá počet všech členů v kolekci s výjimkou dílčích kolekcí.
- Metoda GenerateCCRByName: Vygeneruje požadavek na konfiguraci klienta podle názvu počítače.
- Metoda GetTotalNumResults: Získá počet všech členů v kolekci, včetně dílčích kolekcí.
- Metoda ReassignClientsToSite: Znovu přiřadí lokalitu pro klienty v seznamu.
- Metoda RequestRefresh: Aktivuje opětovné vyhodnocení členství v kolekci komponentou Configuration Manager vyhodnocovače kolekcí.
- Metoda SetDeviceCategory: Přiřadí kategorii sadě zařízení.
- Metoda SetMemberOrder: Nastaví pořadí členů kolekce.
- Metoda UpdateVisibilityInEPDashBoard: Zobrazte tuto kolekci na řídicím panelu ochrany koncového bodu.
- Metoda VerifyNoCircularDependencies: Ověřuje, že nejsou vytvořeny žádné cyklické závislosti, pokud je jedna kolekce nadřazená jiné.
Vlastnosti
CollectionID
Datový typ: String
Typ přístupu: Jen pro čtení
Kvalifikátory: [key, read]
Jedinečné automaticky vygenerované ID pro tuto kolekci, které obsahuje osm znaků.
Formát ID kolekce je kód lokality, který vytvořil kolekci následovaný pětimístným šestnáctkovým sériovým číslem, například JAX0002C
. Výchozí Configuration Manager kolekce používají předponu SMS, SMS00001
například .
CollectionRules
Datový typ: SMS_CollectionRule
pole
Typ přístupu: Čtení/zápis
Kvalifikátory: [lazy]
SMS_CollectionRule objekty serverové třídy služby WMI definující kritéria členství pro kolekci.
CollectionType
Datový typ: UInt32
Typ přístupu: Jen pro čtení
Kvalifikátory: [čtení, výčet]
Typ kolekce. Při vytváření nebo úpravě kolekcí musí být typ kolekce stejný pro všechny zahrnuté, vyloučené a omezené kolekce. Neshodné typy kolekcí nejsou povolené.
Hodnota | Typ kolekce |
---|---|
0 |
Další |
1 |
User |
2 |
Device |
CollectionVariablesCount
Datový typ: SInt32
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Počet proměnných kolekce
Comment
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Obecný komentář nebo poznámka, že dokumentuje kolekci.
CurrentStatus
Datový typ: UInt32
Typ přístupu: Jen pro čtení
Kvalifikátory: [čtení, výčet]
Aktuální stav kolekce. Možné hodnoty jsou:
Hodnota | Aktuální stav |
---|---|
0 |
Žádné |
1 |
Připraven |
2 |
Osvěžující |
3 |
Ukládání |
4 |
Hodnocení |
5 |
Čeká se na aktualizaci |
6 |
Odstranění |
7 |
Připojující se člen |
8 |
Dotazování |
FullEvaluationRunTime
Datový typ: Uint32
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Od verze 2010 je doba úplného spuštění vyhodnocení v sekundách.
FullEvaluationMemberChanges
Datový typ: Uint32
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Od verze 2010 se počet členů změní oproti úplnému vyhodnocení.
FullEvaluationMemberChangeTime
Datový typ: Datetime
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Od verze 2010 se toto členství naposledy změnilo z úplného vyhodnocení.
FullEvaluationLastRefreshTime
Datový typ: Datetime
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Od verze 2010 je čas úplné zkušební poslední aktualizace.
FullEvaluationNextRefreshTime
Datový typ: Datetime
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Počínaje verzí 2010 je doba příští aktualizace úplná zkušební verze.
HasProvisionedMember
Datový typ: Boolean
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
true
pokud tato kolekce zřídila členy.
IncludeExcludeCollectionsCount
Datový typ: SInt32
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Počet kolekcí, které jsou zahrnuté a vyloučené s touto kolekcí.
IncrementalEvaluationRunTime
Datový typ: Uint32
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Od verze 2010 je doba běhu přírůstkového vyhodnocení v sekundách.
IncrementalEvaluationMemberChanges
Datový typ: Uint32
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Od verze 2010 se počet členů změní od přírůstkového vyhodnocení.
IncrementalEvaluationMemberChangeTime
Datový typ: Datetime
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Od verze 2010 je čas, kdy se členství naposledy změnilo z přírůstkového vyhodnocování.
IncrementalEvaluationLastRefreshTime
Datový typ: Datetime
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Od verze 2010 je čas poslední aktualizace přírůstkového vyhodnocení.
IsBuiltIn
Datový typ: Boolean
Typ přístupu: Read-Only
Kvalifikátory: [read]
Pokud je true
tato hodnota , kolekce je předdefinovaná. Například Všechny systémy.
IsReferenceCollection
Datový typ: Boolean
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Pokud je true
tato hodnota , není kolekce omezena jinou kolekcí.
ISVData
Datový typ: UInt8[]
Typ přístupu: Čtení/zápis
Kvalifikátory: [velký, líný]
Datový prostor pro rozšiřitelnost partnerů.
ISVDataSize
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: [lazy]
Velikost ISVData.
ISVString
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: žádné
Řetězec pro rozšiřitelnost partnera.
LastChangeTime
Datový typ: DateTime
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Datum a čas, kdy byla kolekce naposledy změněna.
LastMemberChangeTime
Datový typ: DateTime
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Datum a čas poslední změny členství v kolekci
LastRefreshTime
Datový typ: DateTime
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Datum a čas poslední aktualizace členství v kolekci
LimitToCollectionID
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
ID omezující kolekce.
LimitToCollectionName
Datový typ: DateTime
Typ přístupu: Čtení/zápis
Kvalifikátory: Žádné
Název omezující kolekce.
LocalMemberCount
Datový typ: SInt32
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Počet členů viditelných na místním webu
MemberClassName
Datový typ: String
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Název třídy, která obsahuje členy této kolekce. Configuration Manager neukládá členy kolekce do SMS_Collection. Lokalita dynamicky generuje název členské třídy a je odvozena z SMS_CM_RES_COLL_CollectionID serverové třídy služby WMI.
MemberCount
Datový typ: SInt32
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Počet členů kolekce.
MonitoringFlags
Datový typ: UInt32
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Povolí kolekci pro určité druhy monitorování.
Name
Datový typ: String
Typ přístupu: Čtení/zápis
Kvalifikátory: [Not_null]
Název kolekce. Tato hodnota představuje kolekci v konzole Configuration Manager a měla by být jedinečná.
OwnedByThisSite
Datový typ: Boolean
Typ přístupu: Čtení/zápis
Kvalifikátor: Žádný
true
pokud kolekce pochází z místního webu Configuration Manager. Výchozí hodnota je false
.
PowerConfigsCount
Datový typ: SInt32
Typ přístupu: Jen pro čtení
Kvalifikátor: [read]
Počet konfigurací napájení.
RefreshSchedule
Datový typ: SMS_ScheduleToken
pole
Typ přístupu: Čtení/zápis
Kvalifikace: [max(15), líný]
SMS_ScheduleToken objekty serverové třídy služby WMI označující plán aktualizace nebo aktualizace kolekce. Web aktualizuje členství v kolekci pouze v případě, že vaše aplikace určuje plán nebo volá metodu RequestRefresh ve třídě SMS_Collection . Aby vyhodnocovač kolekce používal plán, nastavte RefreshType
vlastnost na periodický (2
).
RefreshType
Datový typ: UInt32
Typ přístupu: Čtení/zápis
Kvalifikátory: [líný, výčet]
Tato hodnota označuje, jak Configuration Manager kolekci aktualizuje. Výchozí hodnota je ručně (1
). Možné hodnoty:
Hodnota | Typ aktualizace |
---|---|
1 |
Ruční |
2 |
Pravidelné |
4 |
Konstantní aktualizace |
Pokud chcete aktualizaci založit na plánu zadaném v RefreshSchedule
, nastavte tuto vlastnost na periodický (2
). Pokud tuto vlastnost nastavíte na ruční (1
), aktualizujte kolekci ručně metodou RequestRefresh.
ReplicateToSubSites
Tato vlastnost není implementována.
ServiceWindowsCount
Datový typ: SInt32
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Počet časových období údržby pro tuto kolekci
UseCluster
Datový typ: Boolean
Typ přístupu: Jen pro čtení
Kvalifikátory: [read]
Určuje, že tato kolekce je skupina serverů.
Poznámky
Mezi kvalifikátory tříd pro tuto třídu patří:
- Zabezpečené
Další informace o kvalifikátorech tříd a kvalifikátorech vlastností zahrnutých v části vlastnosti najdete v tématu Configuration Manager kvalifikátory tříd a vlastností.
Informace o kolekci reprezentované touto třídou zahrnují plán aktualizace a členy reprezentované SMS_CM_RES_COLL_CollectionID serverové třídy WMI . Vaše aplikace může použít kolekci k cílení prostředků pro distribuci softwaru.
Když spustíte dotaz na dynamickou kolekci reprezentovanou nástrojem SMS_Collection
, ujistěte se, že je poskytovatel serveru SMS načtený nebo že už je spuštěná jiná metoda nebo dotaz.
Aplikace by měla používat SMS_Collection
metody pro přidání, aktualizaci nebo odstranění pravidel členství definovaných CollectionRules
vlastností. Tato vlastnost se nenačte, když vaše aplikace vytvoří SMS_Collection
výčet . Pokud chcete získat pravidla kolekce pro kolekci, musí aplikace používat nebo IWbemServices::GetObject
SWbemServices::Get
. Další informace najdete v tématu kvalifikátory kontextu Configuration Manager.
Požadavky
Požadavky na modul runtime
Další informace najdete v tématu Configuration Manager požadavky na modul runtime serveru.
Požadavky na vývoj
Další informace najdete v tématu požadavky na vývoj Configuration Manager serveru.