WMI-Serverklasse SMS_Collection
Die SMS_Collection
WMI-Klasse ist eine SMS-Anbieter-Serverklasse in Configuration Manager. Es stellt eine Sammlung von Ressourcen dar, die logisch durch Regeln zusammen mit Sammlungsinformationen verknüpft sind.
Die folgende Syntax wird vom MOF-Code (Managed Object Format) vereinfacht und enthält alle geerbten Eigenschaften.
Syntax
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;
};
Methoden
Die folgenden Methoden sind in der SMS_Collection
-Klasse verfügbar:
-
AddMembershipRule-Methode: Fügt der
CollectionRules
-Eigenschaft vonSMS_Collection
eine neue Regel hinzu. -
AddMembershipRules-Methode: Fügt der
CollectionRules
-Eigenschaft vonSMS_Collection
mehrere neue Regeln hinzu. - ApproveClients-Methode: Genehmigt angegebene Clientcomputer für den Beitritt zum Standort.
- BlockClients-Methode: Blockiert die Kommunikation angegebener Clientcomputer mit dem Standort.
- ChangeOwnership-Methode: Ändert den Besitz von Computern in einen Gerätebesitzer.
- ClearDeploymentLocksForCollection-Methode: Löscht Bereitstellungssperren für eine ausgewählte Sammlung.
- ClearDeviceCategory-Methode: Löscht eine Kategorie aus einer Gruppe von Geräten.
- ClearLastNBSAdvForCollection-Methode: Löscht die letzte PXE-Bereitstellung für eine ausgewählte Sammlung.
- ClearLastNBSAdvForMachines-Methode: Löscht die letzte PXE-Bereitstellung für ausgewählte Clientcomputer.
- ClientEditions-Methode: Ruft eine Liste der Clienteditionen ab.
- CreateCCR-Methode: Erstellt eine Clientkonfigurationsanforderung (CCR) für eine bestimmte Ressource.
- CreateCCRs-Methode: Generiert Clientkonfigurationsanforderungen (CCRs) für die Computer in der Sammlung.
- DeleteAllMembers-Methode: Löscht alle Member, d. h. Ressourcen und Ermittlungsdaten, für die Sammlung.
- DeleteMembershipRule-Methode: Löscht eine Mitgliedschaftsregel aus der Auflistung.
- DeleteMembershipRules-Methode: Löscht Mehrere Mitgliedschaftsregeln aus der Auflistung.
- FindResourceSite-Methode: Ruft Standortcodeinformationen für einen Computer aus der Standortdatenbank ab.
- FindMachineSite-Methode: Ruft Standortcodeinformationen für Ressourcen aus der Standortdatenbank ab.
- GetDependency-Methode: Rufen Sie ab Version 2010 die Informationen zur Sammlungsbeziehung ab, von denen die Eingabesammlung abhängt.
- GetDependent-Methode: Ab Version 2010 rufen Sie die Informationen zur Sammlungsbeziehung ab, die von der Eingabesammlung abhängig sind.
- GetNumResults-Methode: Ruft die Anzahl aller Elemente in einer Auflistung mit Ausnahme von Untersammlungen ab.
- GenerateCCRByName-Methode: Generiert eine Clientkonfigurationsanforderung nach Computername.
- GetTotalNumResults-Methode: Ruft die Anzahl aller Elemente in einer Auflistung ab, einschließlich Untersammlungen.
- ReassignClientsToSite-Methode: Die Website wird für die Clients in der Liste neu zugewiesen.
- RequestRefresh-Methode: Löst eine erneute Auswertung der Sammlungsmitgliedschaft durch die komponente Configuration Manager Sammlungsauswertung aus.
- SetDeviceCategory-Methode: Weist einer Gruppe von Geräten eine Kategorie zu.
- SetMemberOrder-Methode: Legt die Reihenfolge der Elemente einer Auflistung fest.
- UpdateVisibilityInEPDashBoard-Methode: Zeigt diese Sammlung im Endpoint Protection-Dashboard an.
- VerifyNoCircularDependencies-Methode: Überprüft, ob keine zirkulären Abhängigkeiten gebildet werden, wenn eine Sammlung das übergeordnete Element einer anderen ist.
Eigenschaften
CollectionID
Datentyp: String
Zugriffstyp: Schreibgeschützt
Qualifizierer: [key, read]
Die eindeutige automatisch generierte ID für diese Auflistung, die acht Zeichen enthält.
Das Format der Sammlungs-ID ist der Websitecode, der die Auflistung erstellt hat, gefolgt von einer fünfstelligen hexadezimalen Seriennummer, JAX0002C
z. B. . Die Standard-Configuration Manager Sammlungen verwenden das Präfix SMS, SMS00001
z. B. .
CollectionRules
Datentyp: SMS_CollectionRule
Array
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [lazy]
SMS_CollectionRule WMI-Serverklassenobjekte, die die Mitgliedschaftskriterien für die Auflistung definieren.
CollectionType
Datentyp: UInt32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen, Aufzählung]
Der Typ der Auflistung. Beim Erstellen oder Ändern von Sammlungen muss der Sammlungstyp für alle eingeschlossenen, ausgeschlossenen und eingeschränkten Sammlungen identisch sein. Nicht übereinstimmende Sammlungstypen sind nicht zulässig.
Wert | Sammlungstyp |
---|---|
0 |
Andere |
1 |
Benutzer |
2 |
Gerät |
CollectionVariablesCount
Datentyp: SInt32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Anzahl der Sammlungsvariablen.
Comment
Datentyp: String
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Keine
Allgemeiner Kommentar oder Hinweis, der die Sammlung dokumentiert.
CurrentStatus
Datentyp: UInt32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen, Aufzählung]
Aktuelle status der Auflistung. Die folgenden Werte sind möglich:
Wert | Aktueller Status |
---|---|
0 |
Keine |
1 |
Bereit |
2 |
Aktualisieren |
3 |
Ersparnis |
4 |
Auswertend |
5 |
Warten auf Aktualisierung |
6 |
Löschen |
7 |
Anfügendes Element |
8 |
Befragend |
FullEvaluationRunTime
Datentyp: Uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Ab Version 2010 die vollständige Auswertungsausführungszeit in Sekunden.
FullEvaluationMemberChanges
Datentyp: Uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Ab Version 2010 ändert sich die Anzahl der Mitglieder gegenüber der vollständigen Auswertung.
FullEvaluationMemberChangeTime
Datentyp: Datetime
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Ab Version 2010 wurde die Mitgliedschaft zuletzt von der vollständigen Auswertung geändert.
FullEvaluationLastRefreshTime
Datentyp: Datetime
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Ab Version 2010 die letzte Aktualisierungszeit der vollständigen Auswertung.
FullEvaluationNextRefreshTime
Datentyp: Datetime
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Ab Version 2010 die nächste Aktualisierung der vollständigen Auswertung.
HasProvisionedMember
Datentyp: Boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
true
, wenn diese Sammlung über bereitgestellte Member verfügt.
IncludeExcludeCollectionsCount
Datentyp: SInt32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Anzahl der Sammlungen, die mit dieser Auflistung eingeschlossen und ausgeschlossen werden.
IncrementalEvaluationRunTime
Datentyp: Uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Ab Version 2010 beträgt die Ausführungszeit der inkrementellen Auswertung in Sekunden.
IncrementalEvaluationMemberChanges
Datentyp: Uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Ab Version 2010 ändert sich die Anzahl der Member bei der inkrementellen Auswertung.
IncrementalEvaluationMemberChangeTime
Datentyp: Datetime
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Ab Version 2010 wurde die Mitgliedschaft zuletzt von der inkrementellen Auswertung geändert.
IncrementalEvaluationLastRefreshTime
Datentyp: Datetime
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Ab Version 2010 die inkrementelle Auswertung der letzten Aktualisierung.
IsBuiltIn
Datentyp: Boolean
Zugriffstyp: Read-Only
Qualifizierer: [lesen]
Wenn dieser Wert ist true
, ist die Auflistung integriert. Beispiel: Alle Systeme.
IsReferenceCollection
Datentyp: Boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Wenn dieser Wert ist true
, wird die Auflistung nicht durch eine andere Auflistung beschränkt.
ISVData
Datentyp: UInt8[]
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [groß, lazy]
Ein Datenbereich für die Partnererweiterbarkeit.
ISVDataSize
Datentyp: UInt32
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [lazy]
Die ISVData-Größe.
ISVString
Datentyp: String
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: keine
Eine Zeichenfolge für die Partnererweiterbarkeit.
LastChangeTime
Datentyp: DateTime
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Keine
Datum und Uhrzeit der letzten Änderung der Sammlung in irgendeiner Weise.
LastMemberChangeTime
Datentyp: DateTime
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Keine
Datum und Uhrzeit der letzten Änderung der Sammlungsmitgliedschaft.
LastRefreshTime
Datentyp: DateTime
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Keine
Datum und Uhrzeit der letzten Aktualisierung der Sammlungsmitgliedschaft.
LimitToCollectionID
Datentyp: String
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Keine
Die ID der einschränkenden Sammlung.
LimitToCollectionName
Datentyp: DateTime
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Keine
Der Name der einschränkenden Auflistung.
LocalMemberCount
Datentyp: SInt32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Anzahl der am lokalen Standort sichtbaren Mitglieder.
MemberClassName
Datentyp: String
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Der Name der Klasse, die die Member dieser Auflistung enthält. Configuration Manager speichert keine Sammlungsmitglieder in SMS_Collection. Der Standort generiert dynamisch den Memberklassennamen und wird von SMS_CM_RES_COLL_CollectionID WMI-Serverklasse abgeleitet.
MemberCount
Datentyp: SInt32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Die Anzahl der Sammlungsmitglieder.
MonitoringFlags
Datentyp: UInt32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Aktiviert die Sammlung für bestimmte Arten der Überwachung.
Name
Datentyp: String
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [Not_null]
Der Name der Auflistung. Dieser Wert stellt die Auflistung in der Configuration Manager-Konsole dar und sollte eindeutig sein.
OwnedByThisSite
Datentyp: Boolean
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Keine
true
, wenn die Sammlung auf der lokalen Configuration Manager-Website stammt. Der Standardwert ist false
.
PowerConfigsCount
Datentyp: SInt32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Eine Anzahl der Energiekonfigurationen.
RefreshSchedule
Datentyp: SMS_ScheduleToken
Array
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [max(15), lazy]
SMS_ScheduleToken WMI-Serverklassenobjekte , die einen Aktualisierungs- oder Aktualisierungszeitplan für die Sammlung angeben. Die Website aktualisiert die Sammlungsmitgliedschaft nur, wenn Ihre Anwendung einen Zeitplan angibt oder die RequestRefresh-Methode in der SMS_Collection-Klasse aufruft. Damit die Sammlungsauswertung den Zeitplan verwendet, legen Sie die RefreshType
-Eigenschaft auf periodisch (2
) fest.
RefreshType
Datentyp: UInt32
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [lazy, Enumeration]
Dieser Wert gibt an, wie Configuration Manager die Auflistung aktualisiert. Der Standardwert ist manuell (1
). Mögliche Werte:
Wert | Aktualisierungstyp |
---|---|
1 |
Manuell |
2 |
Periodisch |
4 |
Konstante Aktualisierung |
Um die Aktualisierung auf dem in RefreshSchedule
angegebenen Zeitplan zu basieren, legen Sie diese Eigenschaft auf periodisch (2
) fest. Wenn Sie diese Eigenschaft auf manuell (1
) festlegen, aktualisieren Sie die Sammlung manuell mit der RequestRefresh-Methode.
ReplicateToSubSites
Diese Eigenschaft ist nicht implementiert.
ServiceWindowsCount
Datentyp: SInt32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Anzahl der Wartungsfenster für diese Sammlung.
UseCluster
Datentyp: Boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Gibt an, dass es sich bei dieser Sammlung um eine Servergruppe handelt.
Hinweise
Klassenqualifizierer für diese Klasse sind:
- Gesichert
Weitere Informationen sowohl zu den Klassenqualifizierern als auch zu den Eigenschaftenqualifizierern, die im Abschnitt eigenschaften enthalten sind, finden Sie unter Configuration Manager Klassen- und Eigenschaftenqualifizierer.
Die von dieser Klasse dargestellten Sammlungsinformationen umfassen den Aktualisierungszeitplan und die Member, die durch SMS_CM_RES_COLL_CollectionID WMI-Serverklassenobjekte dargestellt werden. Ihre Anwendung kann eine Sammlung verwenden, um Ressourcen für die Softwareverteilung zu verwenden.
Wenn Sie eine Abfrage für eine dynamische Sammlung ausführen, die durch dargestellt wird SMS_Collection
, stellen Sie sicher, dass der SMS-Anbieter geladen ist oder dass bereits eine andere Methode oder Abfrage ausgeführt wurde.
Die Anwendung sollte die SMS_Collection
Methoden zum Hinzufügen, Aktualisieren oder Löschen von Mitgliedschaftsregeln verwenden, die von der CollectionRules
-Eigenschaft definiert sind. Diese Eigenschaft wird nicht abgerufen, wenn Ihre Anwendung aufzählt SMS_Collection
. Um die Sammlungsregeln für eine Sammlung abzurufen, muss Ihre Anwendung oder SWbemServices::Get
verwendenIWbemServices::GetObject
. Weitere Informationen finden Sie unter Configuration Manager Kontextqualifizierern.
Anforderungen
Laufzeitanforderungen
Weitere Informationen finden Sie unter Configuration Manager Serverruntimeanforderungen.
Entwicklungsanforderungen
Weitere Informationen finden Sie unter Configuration Manager Serverentwicklungsanforderungen.