classe WMI del server SMS_Collection

La SMS_Collection classe WMI è una classe server del provider SMS in Configuration Manager. Rappresenta una raccolta di risorse correlate logicamente da regole insieme alle informazioni sulla raccolta.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate.

Sintassi

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

Metodi

Nella classe sono disponibili SMS_Collection i seguenti metodi:

Proprietà

CollectionID

Tipo di dati:String

Tipo di accesso: sola lettura

Qualificatori: [chiave, lettura]

L'ID univoco generato automaticamente per questa raccolta che contiene otto caratteri.

Il formato dell'ID della raccolta è il codice del sito che ha creato la raccolta seguito da un numero seriale esadecimale di cinque cifre, ad esempio JAX0002C. Le raccolte predefinite di Configuration Manager utilizzano il prefisso SMS, ad esempio, SMS00001.

CollectionRules

Tipo di dati: SMS_CollectionRule matrice

Tipo di accesso: lettura/scrittura

Qualificazioni: [pigro]

SMS_CollectionRule oggetti della classe WMI del server che definiscono i criteri di appartenenza per la raccolta.

CollectionType

Tipo di dati:UInt32

Tipo di accesso: sola lettura

Qualificatori: [lettura, enumerazione]

Tipo di raccolta. Quando si creano o si modificano raccolte, il tipo di raccolta deve essere lo stesso per tutte le raccolte incluse, escluse e limitate. I tipi di raccolte non corrispondenti non sono consentiti.

Valore Tipo di raccolta
0 Altro
1 Utente
2 Dispositivo

CollectionVariablesCount

Tipo di dati:SInt32

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

Numero di variabili di raccolta.

Comment

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificazioni: Nessuna

Commento generale o nota che documenta la raccolta.

CurrentStatus

Tipo di dati:UInt32

Tipo di accesso: sola lettura

Qualificatori: [lettura, enumerazione]

Stato corrente della raccolta. I valori possibili sono:

Valore Stato corrente
0 Nessuno
1 Pronto
2 Aggiornamento
3 Salvataggio
4 Valutazione in corso
5 In attesa di aggiornamento
6 Eliminazione
7 Aggiunta di un membro
8 Esecuzione di query

FullEvaluationRunTime

Tipo di dati:Uint32

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

A partire dalla versione 2010, la valutazione completa verrà eseguita in secondi.

FullEvaluationMemberChanges

Tipo di dati:Uint32

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

A partire dalla versione 2010, il numero di membri cambia dalla valutazione completa.

FullEvaluationMemberChangeTime

Tipo di dati:Datetime

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

A partire dalla versione 2010, l'ultima volta che l'iscrizione è stata modificata dalla valutazione completa.

FullEvaluationLastRefreshTime

Tipo di dati:Datetime

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

A partire dalla versione 2010, la valutazione completa è l'ultima volta dell'aggiornamento.

FullEvaluationNextRefreshTime

Tipo di dati:Datetime

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

A partire dalla versione 2010, la valutazione completa prossimo aggiornamento.

HasProvisionedMember

Tipo di dati:Boolean

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

true se questa raccolta ha membri di cui è stato eseguito il provisioning.

IncludeExcludeCollectionsCount

Tipo di dati:SInt32

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

Numero di raccolte incluse ed escluse in questo caso.

IncrementalEvaluationRunTime

Tipo di dati:Uint32

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

A partire dalla versione 2010, la valutazione incrementale viene eseguita in secondi.

IncrementalEvaluationMemberChanges

Tipo di dati:Uint32

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

A partire dalla versione 2010, il numero di membri cambia in base alla valutazione incrementale.

IncrementalEvaluationMemberChangeTime

Tipo di dati:Datetime

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

A partire dalla versione 2010, data dell'ultima volta in cui l'appartenenza è stata modificata dalla valutazione incrementale.

IncrementalEvaluationLastRefreshTime

Tipo di dati:Datetime

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

A partire dalla versione 2010, l'ora dell'ultimo aggiornamento della valutazione incrementale.

IsBuiltIn

Tipo di dati:Boolean

Tipo di accesso: Read-Only

Qualificazioni: [leggi]

Quando questo valore è true, la raccolta è incorporata. Ad esempio, Tutti i sistemi.

IsReferenceCollection

Tipo di dati:Boolean

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

Quando questo valore è true, la raccolta non è limitata da un'altra raccolta.

ISVData

Tipo di dati:UInt8[]

Tipo di accesso: lettura/scrittura

Qualificatori: [grande, pigro]

Uno spazio dati per l'estensibilità del partner.

ISVDataSize

Tipo di dati:UInt32

Tipo di accesso: lettura/scrittura

Qualificazioni: [pigro]

Dimensioni ISVData.

ISVString

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificazioni: nessuna

Una stringa per l'estensibilità del partner.

LastChangeTime

Tipo di dati:DateTime

Tipo di accesso: lettura/scrittura

Qualificazioni: Nessuna

Data e ora dell'ultima modifica della collezione in qualsiasi modo.

LastMemberChangeTime

Tipo di dati:DateTime

Tipo di accesso: lettura/scrittura

Qualificazioni: Nessuna

Data e ora dell'ultima modifica dell'appartenenza alla raccolta.

LastRefreshTime

Tipo di dati:DateTime

Tipo di accesso: lettura/scrittura

Qualificazioni: Nessuna

Data e ora dell'ultimo aggiornamento dell'appartenenza alla raccolta.

LimitToCollectionID

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificazioni: Nessuna

ID della raccolta di limitazione.

LimitToCollectionName

Tipo di dati:DateTime

Tipo di accesso: lettura/scrittura

Qualificazioni: Nessuna

Nome della raccolta di limitazione.

LocalMemberCount

Tipo di dati:SInt32

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

Numero di membri visibili nel sito locale.

MemberClassName

Tipo di dati:String

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

Nome della classe che contiene i membri di questo insieme. Configuration Manager non archivia i membri della raccolta in SMS_Collection. Il sito genera dinamicamente il nome della classe membro ed è derivato da SMS_CM_RES_COLL_CollectionID classe WMI del server.

MemberCount

Tipo di dati:SInt32

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

Numero dei membri della raccolta.

MonitoringFlags

Tipo di dati:UInt32

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

Consente la raccolta per determinati tipi di monitoraggio.

Name

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificazioni: [Not_null]

Nome della raccolta. Questo valore rappresenta la raccolta nella console di Configuration Manager e deve essere univoco.

OwnedByThisSite

Tipo di dati:Boolean

Tipo di accesso: lettura/scrittura

Qualificato: nessuno

truese la raccolta è stata originata nel sito locale di Configuration Manager. Il valore predefinito è false.

PowerConfigsCount

Tipo di dati:SInt32

Tipo di accesso: sola lettura

Qualificazione: [leggi]

Conteggio delle configurazioni di risparmio energia.

RefreshSchedule

Tipo di dati: SMS_ScheduleToken matrice

Tipo di accesso: lettura/scrittura

Qualificazioni: [max(15), lazy]

SMS_ScheduleToken oggetti di classe WMI del server che indicano una pianificazione di aggiornamento o aggiornamento per la raccolta. Il sito aggiorna l'appartenenza alla raccolta solo se l'applicazione specifica una pianificazione o chiama il metodo RequestRefresh nella classe SMS_Collection . Affinché l'analizzatore della raccolta possa usare la pianificazione, impostare la RefreshType proprietà su periodico (2).

RefreshType

Tipo di dati:UInt32

Tipo di accesso: lettura/scrittura

Qualificatori: [lazy, enumeration]

Questo valore indica in che modo Configuration Manager aggiorna la raccolta. Il valore predefinito è manuale (1). Valori possibili:

Valore Tipo di aggiornamento
1 Manuale
2 Periodico
4 Aggiornamento costante

Per basare l'aggiornamento sulla pianificazione specificata nella RefreshSchedule, impostare questa proprietà su periodico (2). Se si imposta questa proprietà su manual (1), aggiornare manualmente la raccolta con il metodo RequestRefresh.

ReplicateToSubSites

Questa proprietà non viene implementata.

ServiceWindowsCount

Tipo di dati:SInt32

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

Numero di finestre di manutenzione per questa raccolta.

UseCluster

Tipo di dati:Boolean

Tipo di accesso: sola lettura

Qualificazioni: [leggi]

Specifica che questa raccolta è un gruppo di server.

Osservazioni

I qualificatori della classe per questa classe includono:

  • Protetto

Per altre informazioni sui qualificatori di classe e sui qualificatori di proprietà inclusi nella sezione delle proprietà, vedere Qualificatori di classe e proprietà di Configuration Manager.

Le informazioni sulla raccolta rappresentate da questa classe includono la pianificazione dell'aggiornamento e i membri, rappresentati da oggetti SMS_CM_RES_COLL_CollectionID classe WMI del server . L'applicazione può utilizzare una raccolta per indirizzare le risorse per la distribuzione del software.

Quando si esegue una query su una raccolta dinamica rappresentata da SMS_Collection, assicurarsi che il provider SMS sia caricato o che sia già stato eseguito un altro metodo o query.

L'applicazione deve usare i SMS_Collection metodi per aggiungere, aggiornare o eliminare regole di appartenenza definiti dalla CollectionRules proprietà. Questa proprietà non viene recuperata quando l'applicazione enumera.SMS_Collection Per ottenere le regole di raccolta per una raccolta, l'applicazione deve utilizzare IWbemServices::GetObject o SWbemServices::Get. Per altre informazioni, vedere Qualificatori di contesto di Configuration Manager.

Requisiti

Requisiti di runtime

Per altre informazioni, vedere Requisiti di runtime del server di Configuration Manager.

Requisiti di sviluppo

Per altre informazioni, vedere Requisiti di sviluppo di server per Configuration Manager.

Vedere anche

classe WMI del server SMS_CollectionRule