Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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:
-
Metodo AddMembershipRule: aggiunge una nuova regola alla
CollectionRulesproprietà diSMS_Collection. -
Metodo AddMembershipRules: aggiunge nuove regole multiple alla
CollectionRulesproprietà diSMS_Collection. - Metodo ApproveClients: approva i computer client specificati per partecipare al sito.
- Metodo BlockClients: impedisce ai computer client specificati di comunicare con il sito.
- Metodo ChangeOwnership: modifica la proprietà dei computer in un proprietario del dispositivo.
- Metodo ClearDeploymentLocksForCollection: cancella i blocchi di distribuzione per una raccolta selezionata.
- Metodo ClearDeviceCategory: cancella una categoria da un set di dispositivi.
- Metodo ClearLastNBSAdvForCollection: cancella l'ultima distribuzione PXE per una raccolta selezionata.
- Metodo ClearLastNBSAdvForMachines: cancella l'ultima distribuzione PXE per i computer client selezionati.
- Metodo ClientEditions: recupera un elenco di edizioni client.
- Metodo CreateCCR: crea una richiesta di configurazione client (CCR) per una risorsa specifica.
- Metodo CreateCCRs: genera richieste di configurazione client (CCR) per i computer nella raccolta.
- Metodo DeleteAllMembers: elimina tutti i membri, ovvero le risorse e i dati di individuazione, per la raccolta.
- Metodo DeleteMembershipRule: elimina una regola di appartenenza dalla raccolta.
- Metodo DeleteMembershipRules: elimina più regole di appartenenza dalla raccolta.
- Metodo FindResourceSite: ottiene le informazioni sul codice del sito per un computer dal database del sito.
- Metodo FindMachineSite: ottiene le informazioni sul codice del sito per le risorse dal database del sito.
- Metodo GetDependency: a partire dalla versione 2010, ottenere le informazioni sulla relazione di raccolta da cui dipende la raccolta di input.
- Metodo GetDepended: a partire dalla versione 2010, ottenere le informazioni sulla relazione di raccolta che dipendono dalla raccolta di input.
- Metodo GetNumResults: ottiene un conteggio di tutti i membri di una raccolta, escluse le sottoraccolte.
- Metodo GenerateCCRByName: genera una richiesta di configurazione client in base al nome computer.
- Metodo GetTotalNumResults: ottiene un conteggio di tutti i membri di una raccolta, incluse le sottoraccolte.
- Metodo ReassignClientsToSite: riassegna il sito per i client nell'elenco.
- Metodo RequestRefresh: attiva una nuova valutazione dell'appartenenza alla raccolta da parte del componente analizzatore della raccolta di Configuration Manager.
- Metodo SetDeviceCategory: Assegna una categoria a un set di dispositivi.
- Metodo SetMemberOrder: imposta l'ordine dei membri di una raccolta.
- Metodo UpdateVisibilityInEPDashBoard: mostra questa raccolta nel dashboard di Endpoint Protection.
- Metodo VerifyNoCircularDependencies: verifica che non si formino dipendenze circolari se una raccolta è l'elemento padre di un'altra.
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.