SMS_Collection 伺服器 WMI 類別

發行項
04/04/2023

SMS_CollectionWMI 類別是 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 方法：將一個新的規則新增至 CollectionRules 的 SMS_Collection 屬性。
AddMembershipRules 方法：將多個新規則新增至 CollectionRules 的 SMS_Collection 屬性。
ApproveClients 方法：核准指定的用戶端電腦加入月臺。
BlockClients 方法：封鎖指定的用戶端電腦與月臺通訊。
ChangeOwnership 方法：將電腦的擁有權變更為裝置擁有者。
ClearDeploymentLocksForCollection 方法：清除所選集合的部署鎖定。
ClearDeviceCategory 方法：從一組裝置清除類別。
ClearLastNBSAdvForCollection 方法：清除所選集合的最後一個 PXE 部署。
ClearLastNBSAdvForMachines 方法：清除所選取用戶端電腦的最後一個 PXE 部署。
ClientEditions 方法：擷取用戶端版本清單。
CreateCCR 方法： (特定資源的 CCR) 建立用戶端設定要求。
CreateCCRs 方法：針對集合中的電腦 () 產生用戶端設定要求。
DeleteAllMembers 方法：刪除集合的所有成員，也就是資源和探索資料。
DeleteMembershipRule 方法：從集合中刪除成員資格規則。
DeleteMembershipRules 方法：從集合中刪除多個成員資格規則。
FindResourceSite 方法：從月臺資料庫取得電腦的月臺碼資訊。
FindMachineSite 方法：從月臺資料庫取得資源的月臺碼資訊。
GetDependency 方法：從 2010 版開始，取得輸入集合相依的集合關聯性資訊。
GetDependent 方法：從 2010 版開始，取得相依于輸入集合的集合關聯性資訊。
GetNumResults 方法：取得集合中所有成員的計數，但不包括子集合。
GenerateCCRByName 方法：依電腦名稱稱產生用戶端設定要求。
GetTotalNumResults 方法：取得集合中所有成員的計數，包括子集合。
ReassignClientsToSite 方法：重新指派清單中用戶端的網站。
RequestRefresh 方法：觸發Configuration Manager集合評估工具元件重新評估集合成員資格。
SetDeviceCategory 方法：將類別指派給一組裝置。
SetMemberOrder 方法：設定集合成員的順序。
UpdateVisibilityInEPDashBoard 方法：在 Endpoint Protection 儀表板中顯示此集合。
VerifyNoCircularDependencies 方法：確認如果某個集合是另一個集合的父系，則不會形成任何迴圈相依性。

屬性

`CollectionID`

資料類型：String

存取類型：唯讀

限定詞：[金鑰，讀取]

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

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

`CollectionRules`

資料類型： SMS_CollectionRule 陣列

存取類型：讀取/寫入

限定詞：[延遲]

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

`CollectionType`

資料類型：UInt32

存取類型：唯讀

限定詞：[讀取、列舉]

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

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

`CollectionVariablesCount`

資料類型：SInt32

存取類型：唯讀

限定詞：[read]

集合變數的計數。

`Comment`

資料類型：String

存取類型：讀取/寫入

限定詞：無

記錄集合的一般批註或注意事項。

`CurrentStatus`

資料類型：UInt32

存取類型：唯讀

限定詞：[讀取、列舉]

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

值	目前狀態
`0`	無
`1`	就緒
`2`	重新整理
`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

存取類型：讀取/寫入

限定詞：無

限制集合的識別碼。

`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 陣列

存取類型：讀取/寫入

限定詞：[最大 (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類別和屬性限定詞。

這個類別所表示的集合資訊包括重新整理排程和成員，由伺服器 WMI 類別物件SMS_CM_RES_COLL_CollectionID 表示。您的應用程式可以使用集合，將軟體發佈的目標資源設為目標。

當您針對所 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`