Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.