Condividi tramite

classe WMI del server SMS_Collection

  • Articolo

La SMS_Collection classe WMI è una classe server del provider SMS in Configuration Manager. Rappresenta una raccolta di risorse correlate logicamente dalle 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 i SMS_Collection metodi seguenti:

Proprietà

CollectionID

Tipo di dati:String

Tipo di accesso: sola lettura

Qualificatori: [chiave, lettura]

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

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

CollectionRules

Tipo di dati: SMS_CollectionRule matrice

Tipo di accesso: lettura/scrittura

Qualificatori: [lazy]

SMS_CollectionRule oggetti 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 della 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 raccolta 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

Qualificatori: [read]

Numero di variabili di raccolta.

Comment

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificatori: Nessuno

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 Rinfrescante
3 Salvataggio
4 Valutazione
5 In attesa di aggiornamento
6 Eliminazione
7 Membro di accodamento
8 Query

FullEvaluationRunTime

Tipo di dati:Uint32

Tipo di accesso: sola lettura

Qualificatori: [read]

A partire dalla versione 2010, il tempo di esecuzione della valutazione completa in secondi.

FullEvaluationMemberChanges

Tipo di dati:Uint32

Tipo di accesso: sola lettura

Qualificatori: [read]

A partire dalla versione 2010, il numero di modifiche dei membri rispetto alla valutazione completa.

FullEvaluationMemberChangeTime

Tipo di dati:Datetime

Tipo di accesso: sola lettura

Qualificatori: [read]

A partire dalla versione 2010, l'ultima volta che l'appartenenza è cambiata rispetto alla valutazione completa.

FullEvaluationLastRefreshTime

Tipo di dati:Datetime

Tipo di accesso: sola lettura

Qualificatori: [read]

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

FullEvaluationNextRefreshTime

Tipo di dati:Datetime

Tipo di accesso: sola lettura

Qualificatori: [read]

A partire dalla versione 2010, l'ora di aggiornamento successiva della valutazione completa.

HasProvisionedMember

Tipo di dati:Boolean

Tipo di accesso: sola lettura

Qualificatori: [read]

true se questa raccolta dispone di membri di cui è stato effettuato il provisioning.

IncludeExcludeCollectionsCount

Tipo di dati:SInt32

Tipo di accesso: sola lettura

Qualificatori: [read]

Numero di raccolte incluse ed escluse con questa.

IncrementalEvaluationRunTime

Tipo di dati:Uint32

Tipo di accesso: sola lettura

Qualificatori: [read]

A partire dalla versione 2010, il tempo di esecuzione della valutazione incrementale in secondi.

IncrementalEvaluationMemberChanges

Tipo di dati:Uint32

Tipo di accesso: sola lettura

Qualificatori: [read]

A partire dalla versione 2010, il numero di modifiche apportate ai membri dalla valutazione incrementale.

IncrementalEvaluationMemberChangeTime

Tipo di dati:Datetime

Tipo di accesso: sola lettura

Qualificatori: [read]

A partire dalla versione 2010, l'ultima volta che l'appartenenza è cambiata rispetto alla valutazione incrementale.

IncrementalEvaluationLastRefreshTime

Tipo di dati:Datetime

Tipo di accesso: sola lettura

Qualificatori: [read]

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

IsBuiltIn

Tipo di dati:Boolean

Tipo di accesso: Read-Only

Qualificatori: [read]

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

IsReferenceCollection

Tipo di dati:Boolean

Tipo di accesso: sola lettura

Qualificatori: [read]

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]

Spazio dati per l'estendibilità del partner.

ISVDataSize

Tipo di dati:UInt32

Tipo di accesso: lettura/scrittura

Qualificatori: [lazy]

Dimensione ISVData.

ISVString

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificatori: nessuno

Stringa per l'estendibilità del partner.

LastChangeTime

Tipo di dati:DateTime

Tipo di accesso: lettura/scrittura

Qualificatori: Nessuno

Data e ora dell'ultima modifica della raccolta.

LastMemberChangeTime

Tipo di dati:DateTime

Tipo di accesso: lettura/scrittura

Qualificatori: Nessuno

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

LastRefreshTime

Tipo di dati:DateTime

Tipo di accesso: lettura/scrittura

Qualificatori: Nessuno

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

LimitToCollectionID

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificatori: Nessuno

ID della raccolta di limitazione.

LimitToCollectionName

Tipo di dati:DateTime

Tipo di accesso: lettura/scrittura

Qualificatori: Nessuno

Nome della raccolta di limitazione.

LocalMemberCount

Tipo di dati:SInt32

Tipo di accesso: sola lettura

Qualificatori: [read]

Numero di membri visibili nel sito locale.

MemberClassName

Tipo di dati:String

Tipo di accesso: sola lettura

Qualificatori: [read]

Nome della classe che contiene i membri di questa raccolta. Configuration Manager non archivia i membri della raccolta in SMS_Collection. Il sito genera dinamicamente il nome della classe membro e deriva da SMS_CM_RES_COLL_CollectionID classe WMI del server.

MemberCount

Tipo di dati:SInt32

Tipo di accesso: sola lettura

Qualificatori: [read]

Conteggio dei membri della raccolta.

MonitoringFlags

Tipo di dati:UInt32

Tipo di accesso: sola lettura

Qualificatori: [read]

Abilita la raccolta per determinati tipi di monitoraggio.

Name

Tipo di dati:String

Tipo di accesso: lettura/scrittura

Qualificatori: [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

Qualificatore: Nessuno

truese la raccolta ha avuto origine nel sito Configuration Manager locale. Il valore predefinito è false.

PowerConfigsCount

Tipo di dati:SInt32

Tipo di accesso: sola lettura

Qualificatore: [read]

Conteggio delle configurazioni di alimentazione.

RefreshSchedule

Tipo di dati: SMS_ScheduleToken matrice

Tipo di accesso: lettura/scrittura

Qualificatori: [max(15), lazy]

SMS_ScheduleToken oggetti 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 usi la pianificazione, impostare la proprietà su RefreshType periodico (2).

RefreshType

Tipo di dati:UInt32

Tipo di accesso: lettura/scrittura

Qualificatori: [pigro, enumerazione]

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

Valore Tipo di aggiornamento
1 Manuale
2 Periodica
4 Aggiornamento costante

Per basare l'aggiornamento sulla pianificazione specificata in 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

Qualificatori: [read]

Numero di finestre di manutenzione per questa raccolta.

UseCluster

Tipo di dati:Boolean

Tipo di accesso: sola lettura

Qualificatori: [read]

Specifica che questa raccolta è un gruppo di server.

Osservazioni

I qualificatori di classe per questa classe includono:

  • Protetto

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

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

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

L'applicazione deve utilizzare i SMS_Collection metodi per aggiungere, aggiornare o eliminare le regole di appartenenza definite 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 usare IWbemServices::GetObject o SWbemServices::Get. Per altre informazioni, vedere qualificatori di contesto Configuration Manager.

Requisiti

Requisiti di runtime

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

Requisiti di sviluppo

Per altre informazioni, vedere Configuration Manager requisiti di sviluppo del server.

Vedere anche

classe WMI del server SMS_CollectionRule