SMS_Collection 伺服器 WMI 類別

SMS_Collection WMI 類別是 Configuration Manager 中的 SMS 提供者伺服器類別。它代表由規則以及集合資訊在邏輯上相關的資源集合。

下列語法是從 MOF) 程式碼 (Managed Object Format 簡化而來，並包含所有繼承的屬性。

語法

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) 。
CreateCCRs 方法：產生集合中電腦的用戶端設定要求 (CCR) 。
DeleteAllMembers 方法：刪除集合的所有成員，也就是資源和探索資料。
DeleteMembershipRule 方法：從集合中刪除成員資格規則。
DeleteMembershipRules 方法：從集合中刪除多個成員資格規則。
FindResourceSite 方法：從網站資料庫取得電腦的網站程式碼資訊。
FindMachineSite 方法：從網站資料庫取得資源的網站程式碼資訊。
GetDependency 方法：從版本 2010 開始，取得輸入集合所依存的集合關聯性資訊。
GetDependent 方法：從版本 2010 開始，取得集合關聯性資訊，這取決於輸入集合。
GetNumResults 方法：取得集合中所有成員的計數，子集合除外。
GenerateCCRByName 方法：依電腦名稱產生用戶端設定要求。
GetTotalNumResults 方法：取得集合中所有成員的計數，包括子集合。
ReassignClientsToSite 方法：為清單中的用戶端重新指派網站。
RequestRefresh 方法：觸發 Configuration Manager 集合評估工具元件對集合成員資格的重新評估。
SetDeviceCategory 方法：將類別指派給一組裝置。
SetMemberOrder 方法：設定集合成員的順序。
UpdateVisibilityInEPDashBoard 方法：在端點保護儀表板中顯示此集合。
VerifyNoCircularDependencies 方法：如果一個集合是另一個集合的父項，則驗證不會形成任何循環相依性。

屬性

`CollectionID`

資料類型：String

存取類型：唯讀

限定詞：[按鍵，讀取]

此集合自動產生的唯一識別碼，包含八個字元。

集合識別碼的格式是建立集合的網站代碼後面接著五位數的十六進位序號，例如 JAX0002C。預設的 Configuration Manager 集合使用前綴 SMS，例如 SMS00001。

`CollectionRules`

資料類型： SMS_CollectionRule 陣列

存取類型：讀取/寫入

限定詞：[lazy]

SMS_CollectionRule伺服器 WMI 類別物件，定義集合的成員資格準則。

`CollectionType`

資料類型：UInt32

存取類型：唯讀

限定詞：[read， enumeration]

集合的類型。建立或修改集合時，所有包含、排除和有限集合的集合類型必須相同。不允許不相符的集合類型。

值	集合類型
`0`	其他
`1`	使用者
`2`	裝置

`CollectionVariablesCount`

資料類型：SInt32

存取類型：唯讀

限定詞：[閱讀]

集合變數計數。

`Comment`

資料類型：String

存取類型：讀取/寫入

限定詞：無

記錄集合的一般註解或附註。

`CurrentStatus`

資料類型：UInt32

存取類型：唯讀

限定詞：[read， enumeration]

集合的目前狀態。可能的值為：

值	目前狀態
`0`	無
`1`	就緒
`2`	重新整理
`3`	儲存中
`4`	評估
`5`	等待重新整理
`6`	刪除
`7`	新增成員
`8`	查詢

`FullEvaluationRunTime`

資料類型：Uint32

存取類型：唯讀

限定詞：[閱讀]

從 2010 版開始，完整評估執行時間以秒為單位。

`FullEvaluationMemberChanges`

資料類型：Uint32

存取類型：唯讀

限定詞：[閱讀]

從 2010 版開始，成員數目會與完整評估不同。

`FullEvaluationMemberChangeTime`

資料類型：Datetime

存取類型：唯讀

限定詞：[閱讀]

從 2010 版開始，上次成員資格從完整評估變更。

`FullEvaluationLastRefreshTime`

資料類型：Datetime

存取類型：唯讀

限定詞：[閱讀]

從 2010 版開始，完整評估值為上次重新整理時間。

`FullEvaluationNextRefreshTime`

資料類型：Datetime

存取類型：唯讀

限定詞：[閱讀]

從 2010 版開始，完整評估值的下一次重新整理時間。

`HasProvisionedMember`

資料類型：Boolean

存取類型：唯讀

限定詞：[閱讀]

true 此集合是否已佈建成員。

`IncludeExcludeCollectionsCount`

資料類型：SInt32

存取類型：唯讀

限定詞：[閱讀]

隨此集合包含和排除的集合計數。

`IncrementalEvaluationRunTime`

資料類型：Uint32

存取類型：唯讀

限定詞：[閱讀]

從 2010 版開始，累加式評估執行時間以秒為單位。

`IncrementalEvaluationMemberChanges`

資料類型：Uint32

存取類型：唯讀

限定詞：[閱讀]

從 2010 版開始，成員數目會從累加式評估變更。

`IncrementalEvaluationMemberChangeTime`

資料類型：Datetime

存取類型：唯讀

限定詞：[閱讀]

從 2010 版開始，上次成員資格從累加式評估變更。

`IncrementalEvaluationLastRefreshTime`

資料類型：Datetime

存取類型：唯讀

限定詞：[閱讀]

從 2010 版開始，累加式評估上次重新整理時間。

`IsBuiltIn`

資料類型：Boolean

存取類型：Read-Only

限定詞：[閱讀]

當此值為 true時，即會內建該集合。例如， 所有系統。

`IsReferenceCollection`

資料類型：Boolean

存取類型：唯讀

限定詞：[閱讀]

當此值為 true時，集合不會受限於其他集合。

`ISVData`

資料類型：UInt8[]

存取類型：讀取/寫入

限定詞：[大、懶人]

合作夥伴擴充性的資料空間。

`ISVDataSize`

資料類型：UInt32

存取類型：讀取/寫入

限定詞：[lazy]

ISVData 大小。

`ISVString`

資料類型：String

存取類型：讀取/寫入

限定詞：無

合作夥伴擴充性的字串。

`LastChangeTime`

資料類型：DateTime

存取類型：讀取/寫入

限定詞：無

上次以任何方式變更集合的日期和時間。

`LastMemberChangeTime`

資料類型：DateTime

存取類型：讀取/寫入

限定詞：無

集合成員資格上次變更的日期和時間。

`LastRefreshTime`

資料類型：DateTime

存取類型：讀取/寫入

限定詞：無

上次重新整理集合成員資格的日期和時間。

`LimitToCollectionID`

資料類型：String

存取類型：讀取/寫入

限定詞：無

限制集合的識別碼。

`LimitToCollectionName`

資料類型：DateTime

存取類型：讀取/寫入

限定詞：無

限制集合的名稱。

`LocalMemberCount`

資料類型：SInt32

存取類型：唯讀

限定詞：[閱讀]

在本機網站上可見的成員計數。

`MemberClassName`

資料類型：String

存取類型：唯讀

限定詞：[閱讀]

包含此集合成員的類別名稱。 Configuration Manager不會在 SMS_Collection 中儲存集合成員。網站會動態產生成員類別名稱，並衍生自 SMS_CM_RES_COLL_CollectionID伺服器 WMI 類別。

`MemberCount`

資料類型：SInt32

存取類型：唯讀

限定詞：[閱讀]

集合成員的計數。

`MonitoringFlags`

資料類型：UInt32

存取類型：唯讀

限定詞：[閱讀]

啟用特定類型監視的集合。

`Name`

資料類型：String

存取類型：讀取/寫入

限定詞：[Not_null]

集合的名稱。此值代表 Configuration Manager 主控台中的集合，且應該是唯一的。

`OwnedByThisSite`

資料類型：Boolean

存取類型：讀取/寫入

限定詞：無

true如果集合源自本機 Configuration Manager 站台。預設值為 false。

`PowerConfigsCount`

資料類型：SInt32

存取類型：唯讀

限定詞：[閱讀]

電源設定的計數。

`RefreshSchedule`

資料類型： SMS_ScheduleToken 陣列

存取類型：讀取/寫入

限定詞：[最大 (15) ，延遲]

SMS_ScheduleToken伺服器 WMI 類別物件，指出集合的更新或重新整理排程。只有在應用程式指定排程或呼叫 SMS_Collection 類別中的 RequestRefresh 方法時，網站才會更新集合成員資格。若要讓集合評估工具使用排程，請將屬性設定 RefreshType 為定期 (2) 。

`RefreshType`

資料類型：UInt32

存取類型：讀取/寫入

限定詞：[lazy， enumeration]

此值表示 Configuration Manager 如何重新整理集合。預設值為手動 (1) 。可能的值：

值	重新整理類型
`1`	手動
`2`	定期
`4`	持續更新

若要根據中 RefreshSchedule指定的排程重新整理，請將此屬性設為定期 (2) 。如果您將此屬性設為手動 (1) ，請使用 RequestRefresh 方法手動更新集合。

`ReplicateToSubSites`

不會實作此屬性。

`ServiceWindowsCount`

資料類型：SInt32

存取類型：唯讀

限定詞：[閱讀]

此集合的維護視窗計數。

`UseCluster`

資料類型：Boolean

存取類型：唯讀

限定詞：[閱讀]

指定此集合為伺服器群組。

註解

此類別的類別限定詞包括：

安全的

如需屬性區段中包含的類別限定詞和屬性限定詞的詳細資訊，請參閱 Configuration Manager 類別和屬性限定詞。

此類別代表的集合資訊包括重新整理排程和成員，由伺服器 WMI 類別物件代表SMS_CM_RES_COLL_CollectionID。您的應用程式可以使用集合來針對軟體發佈的資源。

當您對以代表 SMS_Collection的動態集合執行查詢時，請確定已載入 SMS 提供者，或已執行其他方法或查詢。

應用程式應該使用 SMS_Collection 方法來新增、更新或刪除屬性所定義的 CollectionRules 成員資格規則。當您的應用程式列舉 SMS_Collection時，不會擷取此屬性。若要取得集合的集合規則，您的應用程式必須使用 IWbemServices::GetObject OR SWbemServices::Get。如需詳細資訊，請參閱 Configuration Manager 內容限定詞。

需求

執行階段需求

如需詳細資訊，請參閱 Configuration Manager 伺服器執行階段需求。

開發需求

如需詳細資訊，請參閱 Configuration Manager 伺服器開發需求。

另請參閱

SMS_CollectionRule 伺服器 WMI 類別

意見反應

此頁面對您有幫助嗎？

上次更新時間： 2026-08-19

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`