SMS_Collection classe WMI du serveur

  • Article

La SMS_Collection classe WMI est une classe de serveur du fournisseur SMS dans Configuration Manager. Il représente une collection de ressources associées logiquement par des règles, ainsi que des informations de collection.

La syntaxe suivante est simplifiée à partir du code MOF (Managed Object Format) et inclut toutes les propriétés héritées.

Syntaxe

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;
};

Méthodes

Les méthodes suivantes sont disponibles dans la SMS_Collection classe :

Propriétés

CollectionID

Type de donnéesString

Type d’accès : en lecture seule

Qualificateurs : [key, read]

ID généré automatiquement unique pour cette collection qui contient huit caractères.

Le format de l’ID de collection est le code de site qui a créé la collection suivi d’un numéro de série hexadécimal à cinq chiffres, par exemple, JAX0002C. Les collections Configuration Manager par défaut utilisent le préfixe SMS, par exemple . SMS00001

CollectionRules

Type de données : SMS_CollectionRule tableau

Type d’accès : Lecture/écriture

Qualificateurs : [paresseux]

SMS_CollectionRule des objets de classe WMI du serveur définissant les critères d’appartenance pour la collection.

CollectionType

Type de donnéesUInt32

Type d’accès : en lecture seule

Qualificateurs : [read, énumération]

Type de la collection. Lors de la création ou de la modification de collections, le type de collection doit être le même pour toutes les collections incluses, exclues et limitées. Les types de collection incompatibles ne sont pas autorisés.

Valeur Type de collection
0 Autre
1 Utilisateur
2 Device

CollectionVariablesCount

Type de donnéesSInt32

Type d’accès : en lecture seule

Qualificateurs : [read]

Nombre de variables de collection.

Comment

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : Aucun

Remarque ou commentaire général qui documente la collection.

CurrentStatus

Type de donnéesUInt32

Type d’accès : en lecture seule

Qualificateurs : [read, énumération]

État actuel de la collection. Les valeurs possibles sont les suivantes :

Valeur État actuel
0 Aucun
1 Prêt
2 Actualisation
3 Économie
4 Évaluation
5 En attente d’actualisation
6 Suppression
7 Ajout d’un membre
8 Interrogation

FullEvaluationRunTime

Type de donnéesUint32

Type d’accès : en lecture seule

Qualificateurs : [read]

À compter de la version 2010, l’évaluation complète s’exécute en secondes.

FullEvaluationMemberChanges

Type de donnéesUint32

Type d’accès : en lecture seule

Qualificateurs : [read]

À compter de la version 2010, le nombre de membres passe de l’évaluation complète.

FullEvaluationMemberChangeTime

Type de donnéesDatetime

Type d’accès : en lecture seule

Qualificateurs : [read]

À compter de la version 2010, la dernière fois que l’appartenance est passée de l’évaluation complète.

FullEvaluationLastRefreshTime

Type de donnéesDatetime

Type d’accès : en lecture seule

Qualificateurs : [read]

À compter de la version 2010, l’heure de la dernière actualisation de l’évaluation complète.

FullEvaluationNextRefreshTime

Type de donnéesDatetime

Type d’accès : en lecture seule

Qualificateurs : [read]

À compter de la version 2010, l’évaluation complète de la prochaine actualisation.

HasProvisionedMember

Type de donnéesBoolean

Type d’accès : en lecture seule

Qualificateurs : [read]

true si cette collection a des membres provisionnés.

IncludeExcludeCollectionsCount

Type de donnéesSInt32

Type d’accès : en lecture seule

Qualificateurs : [read]

Nombre de collections incluses et exclues avec celle-ci.

IncrementalEvaluationRunTime

Type de donnéesUint32

Type d’accès : en lecture seule

Qualificateurs : [read]

À compter de la version 2010, l’évaluation incrémentielle s’exécute en secondes.

IncrementalEvaluationMemberChanges

Type de donnéesUint32

Type d’accès : en lecture seule

Qualificateurs : [read]

À compter de la version 2010, le nombre de membres change à partir de l’évaluation incrémentielle.

IncrementalEvaluationMemberChangeTime

Type de donnéesDatetime

Type d’accès : en lecture seule

Qualificateurs : [read]

À compter de la version 2010, la dernière fois que l’appartenance est passée de l’évaluation incrémentielle.

IncrementalEvaluationLastRefreshTime

Type de donnéesDatetime

Type d’accès : en lecture seule

Qualificateurs : [read]

À compter de la version 2010, l’heure de la dernière actualisation de l’évaluation incrémentielle.

IsBuiltIn

Type de donnéesBoolean

Type d’accès : Read-Only

Qualificateurs : [read]

Lorsque cette valeur est true, la collection est intégrée. Par exemple, Tous les systèmes.

IsReferenceCollection

Type de donnéesBoolean

Type d’accès : en lecture seule

Qualificateurs : [read]

Lorsque cette valeur est true, la collection n’est pas limitée par une autre collection.

ISVData

Type de donnéesUInt8[]

Type d’accès : Lecture/écriture

Qualificateurs : [large, paresseux]

Espace de données pour l’extensibilité des partenaires.

ISVDataSize

Type de donnéesUInt32

Type d’accès : Lecture/écriture

Qualificateurs : [paresseux]

Taille ISVData.

ISVString

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : aucun

Chaîne pour l’extensibilité du partenaire.

LastChangeTime

Type de donnéesDateTime

Type d’accès : Lecture/écriture

Qualificateurs : Aucun

Date et heure de la dernière modification de la collection.

LastMemberChangeTime

Type de donnéesDateTime

Type d’accès : Lecture/écriture

Qualificateurs : Aucun

Date et heure de la dernière modification de l’appartenance à la collection.

LastRefreshTime

Type de donnéesDateTime

Type d’accès : Lecture/écriture

Qualificateurs : Aucun

Date et heure de la dernière actualisation de l’appartenance à la collection.

LimitToCollectionID

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : Aucun

ID de la collection de limitation.

LimitToCollectionName

Type de donnéesDateTime

Type d’accès : Lecture/écriture

Qualificateurs : Aucun

Nom de la collection de limitation.

LocalMemberCount

Type de donnéesSInt32

Type d’accès : en lecture seule

Qualificateurs : [read]

Nombre de membres visibles sur le site local.

MemberClassName

Type de donnéesString

Type d’accès : en lecture seule

Qualificateurs : [read]

Nom de la classe qui contient les membres de cette collection. Configuration Manager ne stocke pas les membres de la collection dans SMS_Collection. Le site génère dynamiquement le nom de la classe membre et est dérivé de SMS_CM_RES_COLL_CollectionID classe WMI du serveur.

MemberCount

Type de donnéesSInt32

Type d’accès : en lecture seule

Qualificateurs : [read]

Nombre de membres de la collection.

MonitoringFlags

Type de donnéesUInt32

Type d’accès : en lecture seule

Qualificateurs : [read]

Active la collection pour certains types d’analyse.

Name

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : [Not_null]

Nom de la collection. Cette valeur représente la collection dans la console Configuration Manager et doit être unique.

OwnedByThisSite

Type de donnéesBoolean

Type d’accès : Lecture/écriture

Qualificateur : Aucun

truesi la collection provient du site Configuration Manager local. La valeur par défaut est false.

PowerConfigsCount

Type de donnéesSInt32

Type d’accès : en lecture seule

Qualificateur : [read]

Nombre de configurations d’alimentation.

RefreshSchedule

Type de données : SMS_ScheduleToken tableau

Type d’accès : Lecture/écriture

Qualificateurs : [max(15), paresseux]

SMS_ScheduleToken des objets de classe WMI du serveur indiquant une planification de mise à jour ou d’actualisation pour le regroupement. Le site met uniquement à jour l’appartenance à la collection si votre application spécifie une planification ou appelle la méthode RequestRefresh dans la classe SMS_Collection . Pour que l’évaluateur de collection utilise la planification, définissez la propriété sur RefreshType périodique (2).

RefreshType

Type de donnéesUInt32

Type d’accès : Lecture/écriture

Qualificateurs : [paresseux, énumération]

Cette valeur indique comment Configuration Manager actualise la collection. La valeur par défaut est manuelle (1). Valeurs possibles :

Valeur Type d’actualisation
1 Manual
2 Périodique
4 Mise à jour constante

Pour baser l’actualisation selon la planification spécifiée dans RefreshSchedule, définissez cette propriété sur périodique (2). Si vous définissez cette propriété sur manuelle (1), mettez à jour manuellement la collection avec la méthode RequestRefresh.

ReplicateToSubSites

Cette propriété n’est pas implémentée.

ServiceWindowsCount

Type de donnéesSInt32

Type d’accès : en lecture seule

Qualificateurs : [read]

Nombre de fenêtres de maintenance pour cette collection.

UseCluster

Type de donnéesBoolean

Type d’accès : en lecture seule

Qualificateurs : [read]

Spécifie que ce regroupement est un groupe de serveurs.

Remarques

Les qualificateurs de classe pour cette classe sont les suivants :

  • Sécurisé

Pour plus d’informations sur les qualificateurs de classe et les qualificateurs de propriétés inclus dans la section properties, consultez Configuration Manager qualificateurs de classe et de propriété.

Les informations de collection représentées par cette classe incluent la planification de l’actualisation et les membres, représentés par SMS_CM_RES_COLL_CollectionID objets de classe WMI du serveur . Votre application peut utiliser un regroupement pour cibler des ressources pour la distribution de logiciels.

Lorsque vous exécutez une requête sur une collection dynamique représentée par SMS_Collection, assurez-vous que le fournisseur SMS est chargé ou qu’une autre méthode ou requête a déjà été exécutée.

L’application doit utiliser les SMS_Collection méthodes pour ajouter, mettre à jour ou supprimer des règles d’appartenance définies par la CollectionRules propriété . Cette propriété n’est pas récupérée lorsque votre application énumère SMS_Collection. Pour obtenir les règles de collection d’un regroupement, votre application doit utiliser IWbemServices::GetObject ou SWbemServices::Get. Pour plus d’informations, consultez Configuration Manager qualificateurs de contexte.

Configuration requise

Conditions requises pour le runtime

Pour plus d’informations, consultez Configuration Manager configuration requise pour le runtime du serveur.

Exigences de développement

Pour plus d’informations, consultez Configuration Manager configuration requise pour le développement du serveur.

Voir aussi

SMS_CollectionRule classe WMI du serveur