SMS_Collection 服务器 WMI 类

项目
04/04/2023

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 类

通过

SMS_Collection 服务器 WMI 类

语法

方法

属性

CollectionID

CollectionRules

CollectionType

CollectionVariablesCount

Comment

CurrentStatus

FullEvaluationRunTime

FullEvaluationMemberChanges

FullEvaluationMemberChangeTime

FullEvaluationLastRefreshTime

FullEvaluationNextRefreshTime

HasProvisionedMember

IncludeExcludeCollectionsCount

IncrementalEvaluationRunTime

IncrementalEvaluationMemberChanges

IncrementalEvaluationMemberChangeTime

IncrementalEvaluationLastRefreshTime

IsBuiltIn

IsReferenceCollection

ISVData

ISVDataSize

ISVString

LastChangeTime

LastMemberChangeTime

LastRefreshTime

LimitToCollectionID

LimitToCollectionName

LocalMemberCount

MemberClassName

MemberCount

MonitoringFlags

Name

OwnedByThisSite

PowerConfigsCount

RefreshSchedule

RefreshType

ReplicateToSubSites

ServiceWindowsCount

UseCluster

备注

要求

运行时要求

开发要求

另请参阅

反馈

反馈

其他资源

`CollectionID`

`CollectionRules`

`CollectionType`

`CollectionVariablesCount`

`Comment`

`CurrentStatus`

`FullEvaluationRunTime`

`FullEvaluationMemberChanges`

`FullEvaluationMemberChangeTime`

`FullEvaluationLastRefreshTime`

`FullEvaluationNextRefreshTime`

`HasProvisionedMember`

`IncludeExcludeCollectionsCount`

`IncrementalEvaluationRunTime`

`IncrementalEvaluationMemberChanges`

`IncrementalEvaluationMemberChangeTime`

`IncrementalEvaluationLastRefreshTime`

`IsBuiltIn`

`IsReferenceCollection`

`ISVData`

`ISVDataSize`

`ISVString`

`LastChangeTime`

`LastMemberChangeTime`

`LastRefreshTime`

`LimitToCollectionID`

`LimitToCollectionName`

`LocalMemberCount`

`MemberClassName`

`MemberCount`

`MonitoringFlags`

`Name`

`OwnedByThisSite`

`PowerConfigsCount`

`RefreshSchedule`

`RefreshType`

`ReplicateToSubSites`

`ServiceWindowsCount`

`UseCluster`