SMS_Collection 服务器 WMI 类

SMS_Collection WMI 类是 Configuration Manager 中的 SMS 提供程序服务器类。 它表示逻辑上由规则以及集合信息相关的资源的集合。

以下语法在托管对象格式 (MOF) 代码中进行了简化，并包含所有继承的属性。

语法

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

方法

类中 SMS_Collection 提供了以下方法：

• AddMembershipRule 方法：向 的 SMS_Collection属性添加一个新规则CollectionRules。
• AddMembershipRules 方法：向 的 SMS_Collection属性添加多个新规则CollectionRules。
• ApproveClients 方法：批准指定的客户端计算机以加入站点。
• BlockClients 方法：阻止指定的客户端计算机与站点通信。
• ChangeOwnership 方法：将计算机的所有权更改为设备所有者。
• ClearDeploymentLocksForCollection 方法：清除所选集合的部署锁。
• ClearDeviceCategory 方法：从一组设备中清除类别。
• ClearLastNBSAdvForCollection 方法：清除所选集合的最后一个 PXE 部署。
• ClearLastNBSAdvForMachines 方法：清除所选客户端计算机的最后一个 PXE 部署。
• ClientEditions 方法：检索客户端版本的列表。
• CreateCCR 方法： (特定资源的 CCR) 创建客户端配置请求。
• CreateCCR 方法： (集合中的计算机) 生成客户端配置请求。
• DeleteAllMembers 方法：删除集合的所有成员，即资源和发现数据。
• DeleteMembershipRule 方法：从集合中删除成员身份规则。
• DeleteMembershipRules 方法：从集合中删除多个成员身份规则。
• FindResourceSite 方法：从站点数据库中获取计算机的站点代码信息。
• FindMachineSite 方法：从站点数据库中获取资源的站点代码信息。
• GetDependency 方法：从版本 2010 开始，获取输入集合所依赖的集合关系信息。
• GetDependent 方法：从版本 2010 开始，获取依赖于输入集合的集合关系信息。
• GetNumResults 方法：获取集合中所有成员的计数，不包括子集合。
• GenerateCCRByName 方法：按计算机名称生成客户端配置请求。
• GetTotalNumResults 方法：获取集合中所有成员的计数，包括子集合。
• ReassignClientsToSite 方法：为列表中的客户端重新分配站点。
• RequestRefresh 方法：触发Configuration Manager集合评估程序组件对集合成员身份的重新评估。
• SetDeviceCategory 方法：将类别分配给一组设备。
• SetMemberOrder 方法：设置集合成员的顺序。
• UpdateVisibilityInEPDashBoard 方法：在终结点保护仪表板中显示此集合。
• VerifyNoCircularDependencies 方法：验证如果一个集合是另一个集合的父集合，则不会形成循环依赖项。

属性

CollectionID

数据类型String

访问类型：只读

限定符：[key，read]

此集合的唯一自动生成 ID，包含八个字符。

集合 ID 的格式是创建集合的网站代码，后跟一个五位数的十六进制序列号，例如 JAX0002C。 默认Configuration Manager集合使用前缀 SMS，例如 SMS00001。

CollectionRules

数据类型： SMS_CollectionRule array

访问类型：读/写

限定符：[延迟]

SMS_CollectionRule定义集合的成员资格条件的服务器 WMI 类对象。

CollectionType

数据类型UInt32

访问类型：只读

限定符：[read， 枚举]

集合的类型。 创建或修改集合时，所有包含、排除和受限集合的集合类型必须相同。 不允许不匹配的集合类型。

值	集合类型
0	其他
1	User
2	Device

CollectionVariablesCount

数据类型SInt32

访问类型：只读

限定符：[read]

集合变量的计数。

Comment

数据类型String

访问类型：读/写

限定符：无

记录集合的一般注释或注意。

CurrentStatus

数据类型UInt32

访问类型：只读

限定符：[read， 枚举]

集合的当前状态。 可能的值是：

值	当前状态
0	无
1	Ready
2	Refreshing
3	储蓄
4	评价
5	正在等待刷新
6	删除
7	追加成员
8	查询

FullEvaluationRunTime

数据类型Uint32

访问类型：只读

限定符：[read]

从版本 2010 开始，完整评估运行时间（以秒为单位）。

FullEvaluationMemberChanges

数据类型Uint32

访问类型：只读

限定符：[read]

从版本 2010 开始，成员数从完全评估开始更改。

FullEvaluationMemberChangeTime

数据类型Datetime

访问类型：只读

限定符：[read]

从版本 2010 开始，上次成员身份从完全评估中更改的时间。

FullEvaluationLastRefreshTime

数据类型Datetime

访问类型：只读

限定符：[read]

从版本 2010 开始，完整评估上次刷新时间。

FullEvaluationNextRefreshTime

数据类型Datetime

访问类型：只读

限定符：[read]

从版本 2010 开始，完整评估下次刷新时间。

HasProvisionedMember

数据类型Boolean

访问类型：只读

限定符：[read]

true 如果此集合具有预配成员，则为 。

IncludeExcludeCollectionsCount

数据类型SInt32

访问类型：只读

限定符：[read]

随此集合一起包含和排除的集合的计数。

IncrementalEvaluationRunTime

数据类型Uint32

访问类型：只读

限定符：[read]

从版本 2010 开始，增量评估运行时间（以秒为单位）。

IncrementalEvaluationMemberChanges

数据类型Uint32

访问类型：只读

限定符：[read]

从版本 2010 开始，增量计算中成员数的变化。

IncrementalEvaluationMemberChangeTime

数据类型Datetime

访问类型：只读

限定符：[read]

从版本 2010 开始，上次成员身份从增量评估更改的时间。

IncrementalEvaluationLastRefreshTime

数据类型Datetime

访问类型：只读

限定符：[read]

从版本 2010 开始，增量评估上次刷新时间。

IsBuiltIn

数据类型Boolean

访问类型：Read-Only

限定符：[read]

当此值为 true时，将内置集合。 例如， “所有系统”。

IsReferenceCollection

数据类型Boolean

访问类型：只读

限定符：[read]

当此值为 true时，该集合不受另一个集合的限制。

ISVData

数据类型UInt8[]

访问类型：读/写

限定符：[大型、延迟]

用于合作伙伴扩展性的数据空间。

ISVDataSize

数据类型UInt32

访问类型：读/写

限定符：[延迟]

ISVData 大小。

ISVString

数据类型String

访问类型：读/写

限定符：无

合作伙伴扩展性的字符串。

LastChangeTime

数据类型DateTime

访问类型：读/写

限定符：无

上次以任何方式更改集合的日期和时间。

LastMemberChangeTime

数据类型DateTime

访问类型：读/写

限定符：无

上次更改集合成员身份的日期和时间。

LastRefreshTime

数据类型DateTime

访问类型：读/写

限定符：无

上次刷新集合成员身份的日期和时间。

LimitToCollectionID

数据类型String

访问类型：读/写

限定符：无

限制集合的 ID。

LimitToCollectionName

数据类型DateTime

访问类型：读/写

限定符：无

限制集合的名称。

LocalMemberCount

数据类型SInt32

访问类型：只读

限定符：[read]

本地站点上可见的成员计数。

MemberClassName

数据类型String

访问类型：只读

限定符：[read]

包含此集合成员的类的名称。 Configuration Manager不会在 SMS_Collection 中存储集合成员。 站点动态生成成员类名称，派生自 SMS_CM_RES_COLL_CollectionID服务器 WMI 类。

MemberCount

数据类型SInt32

访问类型：只读

限定符：[read]

集合成员的计数。

MonitoringFlags

数据类型UInt32

访问类型：只读

限定符：[read]

为某些类型的监视启用集合。

Name

数据类型String

访问类型：读/写

限定符：[Not_null]

集合的名称。 此值表示Configuration Manager控制台中的集合，应是唯一的。

OwnedByThisSite

数据类型Boolean

访问类型：读/写

限定符：无

true如果集合源自本地Configuration Manager站点，则为 。 默认值为 false。

PowerConfigsCount

数据类型SInt32

访问类型：只读

限定符：[read]

电源配置的计数。

RefreshSchedule

数据类型： SMS_ScheduleToken array

访问类型：读/写

限定符：[最大 (15) ，延迟]

SMS_ScheduleToken服务器 WMI 类 对象，指示集合的更新或刷新计划。 仅当应用程序在 SMS_Collection 类中指定计划或调用 RequestRefresh 方法时，网站才会更新集合成员身份。 若要使集合计算器使用计划，请将 RefreshType 属性设置为定期 (2) 。

RefreshType

数据类型UInt32

访问类型：读/写

限定符：[延迟，枚举]

此值指示Configuration Manager如何刷新集合。 默认值为手动 (1) 。 可能的值：

值	刷新类型
1	手动
2	周期
4	常量更新

若要根据 中指定的 RefreshSchedule计划进行刷新，请将此属性设置为定期 (2) 。 如果将此属性设置为手动 (1) ，请使用 RequestRefresh 方法手动更新集合。

ReplicateToSubSites

此属性未实现。

ServiceWindowsCount

数据类型SInt32

访问类型：只读

限定符：[read]

此集合的维护时段计数。

UseCluster

数据类型Boolean

访问类型：只读

限定符：[read]

指定此集合是服务器组。

备注

此类的类限定符包括：

• 安全

有关属性部分中包含的类限定符和属性限定符的详细信息，请参阅 Configuration Manager 类和属性限定符。

此类表示的集合信息包括刷新计划和成员，由 SMS_CM_RES_COLL_CollectionID服务器 WMI 类 对象表示。 应用程序可以使用集合来面向软件分发的资源。

针对 表示 SMS_Collection的动态集合运行查询时，请确保已加载 SMS 提供程序，或者其他方法或查询已运行。

应用程序应使用 SMS_Collection 方法添加、更新或删除 属性 CollectionRules 定义的成员身份规则。 当应用程序枚举 SMS_Collection时，不会检索此属性。 若要获取集合的集合规则，应用程序必须使用 IWbemServices::GetObject 或 SWbemServices::Get。 有关详细信息，请参阅Configuration Manager上下文限定符。

要求

运行时要求

有关详细信息，请参阅Configuration Manager服务器运行时要求。

开发要求

有关详细信息，请参阅Configuration Manager服务器开发要求。

另请参阅

SMS_CollectionRule 服务器 WMI 类