WMI-Serverklasse SMS_Collection

Die SMS_Collection WMI-Klasse ist eine SMS-Anbieter-Serverklasse im Configuration Manager. Es stellt eine Sammlung von Ressourcen dar, die zusammen mit Sammlungsinformationen logisch durch Regeln verknüpft sind.

Die folgende Syntax wurde aus 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 diesem SMS_Collection Kurs verfügbar:

• AddMembershipRule-Methode: Fügt der CollectionRules Eigenschaft von SMS_Collectioneine neue Regel hinzu.
• AddMembershipRules-Methode: Fügt der CollectionRules Eigenschaft von SMS_Collection.
• ApproveClients-Methode: Genehmigt angegebene Clientcomputer, um der Website beizutreten.
• BlockClients-Methode: Blockiert angegebene Clientcomputer an der Kommunikation mit der Website.
• ChangeOwnership-Methode: Ändert den Besitz von Computern auf einen Gerätebesitzer.
• ClearDeploymentLocksForCollection-Methode: Löscht Bereitstellungssperren für eine ausgewählte Sammlung.
• ClearDeviceCategory-Methode: Löscht eine Kategorie aus einer Reihe 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 von Client-Editionen 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 Sammlung.
• DeleteMembershipRules-Methode: Löscht mehrere Mitgliedschaftsregeln aus der Sammlung.
• 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: Ab Version 2010 können Sie die Informationen zur Sammlungsbeziehung abrufen, von denen die Eingabesammlung abhängt.
• GetDependenz-Methode: Ab Version 2010 können Sie die Informationen zur Sammlungsbeziehung abrufen, die von der Eingabeauflistung abhängen.
• GetNumResults-Methode: Ruft die Anzahl aller Elemente in einer Auflistung ab, mit Ausnahme von Untersammlungen.
• GenerateCCRByName-Methode: Generiert eine Clientkonfigurationsanforderung anhand des Computernamens.
• GetTotalNumResults-Methode: Ruft die Anzahl aller Elemente in einer Auflistung ab, einschließlich der Unterauflistungen.
• ReassignClientsToSite-Methode: Weist den Client in der Liste den Standort neu zu.
• RequestRefresh-Methode: Löst eine Neubewertung der Sammlungsmitgliedschaft durch die Configuration Manager-Sammlungsauswertungskomponente aus.
• SetDeviceCategory-Methode: Weist einer Gruppe von Geräten eine Kategorie zu.
• SetMemberOrder-Methode: Legt die Reihenfolge der Elemente einer Auflistung fest.
• UpdateVisibilityInEPDashBoard-Methode: Zeigen Sie diese Sammlung im Endpoint Protection-Dashboard an.
• VerifyNoCircularDependencies-Methode: Überprüft, ob keine Zirkelabhängigkeiten gebildet werden, wenn eine Sammlung das übergeordnete Element einer anderen ist.

Eigenschaften

CollectionID

Datentyp: String

Zugriffstyp: Schreibgeschützt

Qualifiers: [key, read]

Die eindeutige, automatisch generierte ID für diese Sammlung, die acht Zeichen enthält.

Das Format der Sammlungs-ID ist der Websitecode, der die Sammlung erstellt hat, JAX0002Cgefolgt von einer fünfstelligen hexadezimalen Seriennummer, z. B. Die standardmäßigen Configuration Manager-Sammlungen verwenden das Präfix SMS, z. BSMS00001. . .

CollectionRules

Datentyp: SMS_CollectionRule Array

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [faul]

SMS_CollectionRule WMI-Klassenobjekte des Servers, die die Mitgliedschaftskriterien für die Sammlung definieren.

CollectionType

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifiers: [read, enumeration]

Der Typ der Sammlung. 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.

CollectionVariablesCount

Datentyp: SInt32

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Count of collection variables.

Comment

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

Allgemeine Bemerkung oder Notiz, die die Sammlung dokumentiert.

CurrentStatus

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifiers: [read, enumeration]

Aktueller Status der Sammlung. Die folgenden Werte sind möglich:

FullEvaluationRunTime

Datentyp: Uint32

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Ab Version 2010 die vollständige Auswertungslaufzeit in Sekunden.

FullEvaluationMemberChanges

Datentyp: Uint32

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Ab Version 2010 ändert sich die Anzahl der Mitglieder gegenüber der vollständigen Auswertung.

FullEvaluationMemberChangeTime

Datentyp: Datetime

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Ab Version 2010, das letzte Mal, als sich die Mitgliedschaft von der vollständigen Bewertung geändert hat.

FullEvaluationLastRefreshTime

Datentyp: Datetime

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Ab Version 2010 wird die vollständige Auswertung zuletzt aktualisiert.

FullEvaluationNextRefreshTime

Datentyp: Datetime

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Ab Version 2010 wird das vollständige Auswertungsdatum beim nächsten Mal aktualisiert.

HasProvisionedMember

Datentyp: Boolean

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

true Wenn für diese Sammlung Mitglieder bereitgestellt wurden.

IncludeExcludeCollectionsCount

Datentyp: SInt32

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Anzahl der Sammlungen, die mit dieser einbezogen oder ausgeschlossen werden.

IncrementalEvaluationRunTime

Datentyp: Uint32

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Ab Version 2010 wird die inkrementelle Auswertung in Sekunden ausgeführt.

IncrementalEvaluationMemberChanges

Datentyp: Uint32

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Ab Version 2010 ändert sich die Anzahl der Mitglieder gegenüber der inkrementellen Auswertung.

IncrementalEvaluationMemberChangeTime

Datentyp: Datetime

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Ab Version 2010 änderte sich die Mitgliedschaft zuletzt von der inkrementellen Auswertung.

IncrementalEvaluationLastRefreshTime

Datentyp: Datetime

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Ab Version 2010 die inkrementelle Auswertung letzte Aktualisierungszeit.

IsBuiltIn

Datentyp: Boolean

Zugriffsart: Read-Only

Qualifikanten: [lesen]

Wenn dieser Wert ist true, ist die Sammlung integriert. Beispiel: Alle Systeme.

IsReferenceCollection

Datentyp: Boolean

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Wenn dieser Wert ist true, wird die Sammlung nicht durch eine andere Sammlung eingeschränkt.

ISVData

Datentyp: UInt8[]

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [groß, faul]

Ein Datenraum für die Erweiterbarkeit durch Partner.

ISVDataSize

Datentyp: UInt32

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [faul]

Die ISVData-Größe.

ISVString

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifikanten: keine

Eine Zeichenfolge für die Partnererweiterbarkeit.

LastChangeTime

Datentyp: DateTime

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

Datum und Uhrzeit, zu dem die Sammlung zuletzt in irgendeiner Weise geändert wurde.

LastMemberChangeTime

Datentyp: DateTime

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

Datum und Uhrzeit, zu dem die Sammlungsmitgliedschaft zuletzt geändert wurde.

LastRefreshTime

Datentyp: DateTime

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

Datum und Uhrzeit, wann die Sammlungsmitgliedschaft zuletzt aktualisiert wurde.

LimitToCollectionID

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

Die ID der einschränkenden Sammlung.

LimitToCollectionName

Datentyp: DateTime

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

Der Name der einschränkenden Sammlung.

LocalMemberCount

Datentyp: SInt32

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Anzahl der Mitglieder, die auf der lokalen Website sichtbar sind.

MemberClassName

Datentyp: String

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Der Name der Klasse, die die Member dieser Auflistung enthält. Configuration Manager speichert keine Sammlungsmitglieder in SMS_Collection. Die Site generiert dynamisch den Namen der Memberklasse und wird von SMS_CM_RES_COLL_CollectionID WMI-Klasse des Servers abgeleitet.

MemberCount

Datentyp: SInt32

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Die Anzahl der Sammlungsmitglieder.

MonitoringFlags

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Aktiviert die Erfassung für bestimmte Arten der Überwachung.

Name

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [Not_null]

Der Name der Sammlung. Dieser Wert stellt die Auflistung in der Configuration Manager-Konsole dar und sollte eindeutig sein.

OwnedByThisSite

Datentyp: Boolean

Zugriffstyp: Lesen/Schreiben

Qualifier: Keine

trueob die Sammlung vom lokalen Standort des Configuration Manager stammt. Der Standardwert ist false.

PowerConfigsCount

Datentyp: SInt32

Zugriffstyp: Schreibgeschützt

Qualifier: [lesen]

Eine Anzahl der Energiekonfigurationen.

RefreshSchedule

Datentyp: SMS_ScheduleToken Array

Zugriffstyp: Lesen/Schreiben

Qualifier: [max(15), faul]

SMS_ScheduleToken WMI-Klassenobjekte des Servers , 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 verwenden kann, legen Sie die RefreshType Eigenschaft auf periodisch (2) fest.

RefreshType

Datentyp: UInt32

Zugriffstyp: Lesen/Schreiben

Qualifiers: [lazy, enumeration]

Dieser Wert gibt an, wie Configuration Manager die Sammlung aktualisiert. Der Standardwert ist manual (1). Mögliche Werte:

Damit die Aktualisierung auf dem in angegebenen RefreshScheduleZeitplan basiert, legen Sie diese Eigenschaft auf periodisch (2) fest. Wenn Sie diese Eigenschaft auf manual (1) festlegen, aktualisieren Sie die Auflistung manuell mit der RequestRefresh-Methode.

ReplicateToSubSites

Diese Eigenschaft ist nicht implementiert.

ServiceWindowsCount

Datentyp: SInt32

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Anzahl der Wartungsfenster für diese Sammlung.

UseCluster

Datentyp: Boolean

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Gibt an, dass es sich bei dieser Auflistung um eine Servergruppe handelt.

Hinweise

Zu den Klassenqualifikationen für diese Klasse gehören:

• Gesichert

Weitere Informationen zu den Klassen- und Eigenschaftsbezeichnern, die im Abschnitt "Eigenschaften" enthalten sind, finden Sie unter Klassen- und Eigenschaftskennzeichner im Configuration Manager.

Zu den von dieser Klasse dargestellten Sammlungsinformationen gehören der Aktualisierungszeitplan und die Elemente, dargestellt durch SMS_CM_RES_COLL_CollectionID WMI-Klassenobjekte des Servers . Ihre Anwendung kann eine Sammlung verwenden, um Ressourcen für die Softwareverteilung als Ziel 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 von der CollectionRules Eigenschaft definierten Methoden zum Hinzufügen, Aktualisieren oder Löschen von Mitgliedschaftsregeln verwenden. 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::GetverwendenIWbemServices::GetObject. Weitere Informationen finden Sie unter Kontextbegrenzungszeichen für Configuration Manager.

Anforderungen

Laufzeitanforderungen

Weitere Informationen finden Sie unter Anforderungen an die Configuration Manager-Serverlaufzeit.

Entwicklungsanforderungen

Weitere Informationen finden Sie unter Anforderungen für die Serverentwicklung in Configuration Manager.

Siehe auch

WMI-Serverklasse SMS_CollectionRule