SMS_Collection classe WMI du serveur

La SMS_Collection classe WMI est une classe de serveur fournisseur SMS dans le gestionnaire de Configuration Manager. Il représente un ensemble de ressources liées logiquement par des règles avec des informations sur la 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 : Lecture seule

Qualificatifs : [key, read]

ID unique généré automatiquement 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 par défaut du Configuration Manager utilisent le préfixe SMS, par exemple, SMS00001.

CollectionRules

Type de données : SMS_CollectionRule tableau

Type d’accès : Lecture/écriture

Qualificatifs : [paresseux]

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

CollectionType

Type de donnéesUInt32

Type d’accès : Lecture seule

Qualificatifs : [lire, é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 Appareil

CollectionVariablesCount

Type de donnéesSInt32

Type d’accès : Lecture seule

Qualificatifs : [lire]

Nombre de variables de collection.

Comment

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Commentaire général ou note qui documente la collection.

CurrentStatus

Type de donnéesUInt32

Type d’accès : Lecture seule

Qualificatifs : [lire, énumération]

status actuelle de la collection. Les valeurs possibles sont les suivantes :

Valeur État actuel
0 Aucun
1 Prêt
2 Actualisation
3 Enregistrement
4 Évaluation
5 En attente d’actualisation
6 Suppression
7 Membre ajoutant
8 Requête en cours

FullEvaluationRunTime

Type de donnéesUint32

Type d’accès : Lecture seule

Qualificatifs : [lire]

À partir de la version 2010, durée d’exécution de l’évaluation complète en secondes.

FullEvaluationMemberChanges

Type de donnéesUint32

Type d’accès : Lecture seule

Qualificatifs : [lire]

À compter de la version 2010, le nombre de membres change par rapport à l’évaluation complète.

FullEvaluationMemberChangeTime

Type de donnéesDatetime

Type d’accès : Lecture seule

Qualificatifs : [lire]

À partir de la version 2010, la dernière fois que l’appartenance a changé par rapport à l’évaluation complète.

FullEvaluationLastRefreshTime

Type de donnéesDatetime

Type d’accès : Lecture seule

Qualificatifs : [lire]

À partir de la version 2010, l’évaluation complète a été actualisée pour la dernière fois.

FullEvaluationNextRefreshTime

Type de donnéesDatetime

Type d’accès : Lecture seule

Qualificatifs : [lire]

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

HasProvisionedMember

Type de donnéesBoolean

Type d’accès : Lecture seule

Qualificatifs : [lire]

true si cette collection a approvisionné des membres.

IncludeExcludeCollectionsCount

Type de donnéesSInt32

Type d’accès : Lecture seule

Qualificatifs : [lire]

Nombre de collections incluses et exclues de celle-ci.

IncrementalEvaluationRunTime

Type de donnéesUint32

Type d’accès : Lecture seule

Qualificatifs : [lire]

À compter de la version 2010, le temps d’exécution de l’évaluation incrémentielle est en secondes.

IncrementalEvaluationMemberChanges

Type de donnéesUint32

Type d’accès : Lecture seule

Qualificatifs : [lire]

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

IncrementalEvaluationMemberChangeTime

Type de donnéesDatetime

Type d’accès : Lecture seule

Qualificatifs : [lire]

À partir de la version 2010, la dernière fois que l’appartenance a changé à partir de l’évaluation incrémentielle.

IncrementalEvaluationLastRefreshTime

Type de donnéesDatetime

Type d’accès : Lecture seule

Qualificatifs : [lire]

À compter de la version 2010, l’évaluation incrémentielle a été actualisée pour la dernière fois.

IsBuiltIn

Type de donnéesBoolean

Type d’accès : Read-Only

Qualificatifs : [lire]

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 : Lecture seule

Qualificatifs : [lire]

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

Qualificatifs : [large, paresseux]

Un espace de données pour l’extensibilité des partenaires.

ISVDataSize

Type de donnéesUInt32

Type d’accès : Lecture/écriture

Qualificatifs : [paresseux]

Taille ISVData.

ISVString

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificatifs : aucun

Chaîne pour l’extensibilité des partenaires.

LastChangeTime

Type de donnéesDateTime

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

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

LastMemberChangeTime

Type de donnéesDateTime

Type d’accès : Lecture/écriture

Qualificatifs : 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

Qualificatifs : 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

Qualificatifs : Aucun

ID de la collection de limitation.

LimitToCollectionName

Type de donnéesDateTime

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Nom de la collection limitative.

LocalMemberCount

Type de donnéesSInt32

Type d’accès : Lecture seule

Qualificatifs : [lire]

Nombre de membres visibles sur le site local.

MemberClassName

Type de donnéesString

Type d’accès : Lecture seule

Qualificatifs : [lire]

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 classe des membres et est dérivé de SMS_CM_RES_COLL_CollectionID classe WMI du serveur.

MemberCount

Type de donnéesSInt32

Type d’accès : Lecture seule

Qualificatifs : [lire]

Nombre des membres de la collection.

MonitoringFlags

Type de donnéesUInt32

Type d’accès : Lecture seule

Qualificatifs : [lire]

Active la collecte pour certains types de surveillance.

Name

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificatifs : [Not_null]

Nom de la collection. Cette valeur représente le regroupement dans la console du 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 : Lecture seule

Qualificatif : [lire]

Nombre des configurations d’alimentation.

RefreshSchedule

Type de données : SMS_ScheduleToken tableau

Type d’accès : Lecture/écriture

Qualificateurs : [max(15), paresseux]

SMS_ScheduleToken objets de classe WMI serveur indiquant une planification de mise à jour ou d’actualisation pour la collection. Le site met à jour l’adhésion à la collection uniquement 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 RefreshType propriété sur periodic (2).

RefreshType

Type de donnéesUInt32

Type d’accès : Lecture/écriture

Qualificatifs : [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 Manuel
2 Périodique
4 Mise à jour constante

Pour baser l’actualisation sur la planification spécifiée dans RefreshSchedule, définissez cette propriété sur périodique (2). Si vous définissez cette propriété sur manual (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 : Lecture seule

Qualificatifs : [lire]

Nombre de fenêtres de maintenance pour cette collection.

UseCluster

Type de donnéesBoolean

Type d’accès : Lecture seule

Qualificatifs : [lire]

Spécifie que cette collection est un groupe de serveurs.

Remarques

Les qualificatifs de classe pour cette classe sont les suivants :

  • Sécurisé

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

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 serveur . Votre application peut utiliser une collection 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 méthodes pour ajouter, mettre à jour ou supprimer des SMS_Collection 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 collecte d’une collection, votre application doit utiliser IWbemServices::GetObject ou SWbemServices::Get. Pour plus d’informations, voir Qualificateurs de contexte Configuration Manager.

Configuration requise

Configuration requise pour l’exécution

Pour plus d’informations, consultez Configuration requise pour l’exécution du serveur Configuration Manager.

Configuration requise pour le développement

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

Voir aussi

SMS_CollectionRule classe WMI du serveur

  • Last updated on