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 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:
- Metodo AddMembershipRule: aggiunge una nuova regola alla
CollectionRulesproprietà diSMS_Collection. - Metodo AddMembershipRules: aggiunge più nuove regole alla
CollectionRulesproprietà diSMS_Collection. - Metodo ApproveClients: approva i computer client specificati per l'aggiunta 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 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 GetDependent: 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 del 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 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 vengano formate 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]
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
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per