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プロパティに 1 つの新しいルールを追加します。 -
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
アクセスの種類: 読み取り専用
限定子: [key, read]
このコレクションの一意の自動生成 ID。8 文字で構成されます。
コレクション ID の形式は、コレクションを作成したサイト コードの後に 5 桁の 16 進数のシリアル番号 ( JAX0002C など) が続くものです。 既定のConfiguration Manager コレクションでは、プレフィックス SMS が使用されます (例: SMS00001)。
CollectionRules
データ型: SMS_CollectionRule 配列
アクセスの種類: 読み取り/書き込み
修飾子: [lazy]
コレクションのメンバーシップ条件を定義するサーバー WMI クラス オブジェクトSMS_CollectionRule。
CollectionType
データ型: UInt32
アクセスの種類: 読み取り専用
修飾子: [読み取り、列挙]
コレクションの種類。 コレクションを作成または変更する場合、コレクションの種類は、含まれるコレクション、除外コレクション、および制限付きコレクションすべてで同じである必要があります。 不一致のコレクション型は許可されません。
| 値 | コレクションの型 |
|---|---|
0 |
その他 |
1 |
User |
2 |
デバイス |
CollectionVariablesCount
データ型: SInt32
アクセスの種類: 読み取り専用
修飾子: [読み取り]
コレクション変数の数。
Comment
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
コレクションを文書化する全般的なコメントまたはメモ。
CurrentStatus
データ型: UInt32
アクセスの種類: 読み取り専用
修飾子: [読み取り、列挙]
コレクションの現在の状態。 使用可能な値は次のとおりです。
| 値 | 現在の状態 |
|---|---|
0 |
なし |
1 |
準備完了 |
2 |
Refreshing |
3 |
保存中 |
4 |
Evaluating |
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[]
アクセスの種類: 読み取り/書き込み
修飾子: [large, lazy]
パートナーの拡張のためのデータ空間。
ISVDataSize
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: [lazy]
ISVData のサイズ。
ISVString
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
パートナー拡張機能の文字列。
LastChangeTime
データ型: DateTime
アクセスの種類: 読み取り/書き込み
修飾子: なし
コレクションが何らかの方法で最後に変更された日時。
LastMemberChangeTime
データ型: DateTime
アクセスの種類: 読み取り/書き込み
修飾子: なし
コレクション メンバーシップが最後に変更された日時。
LastRefreshTime
データ型: DateTime
アクセスの種類: 読み取り/書き込み
修飾子: なし
コレクション メンバーシップが最後に更新された日時。
LimitToCollectionID
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
制限コレクションの ID。
LimitToCollectionName
データ型: DateTime
アクセスの種類: 読み取り/書き込み
修飾子: なし
制限コレクションの名前。
LocalMemberCount
データ型: SInt32
アクセスの種類: 読み取り専用
修飾子: [読み取り]
ローカル サイトに表示されるメンバーの数。
MemberClassName
データ型: String
アクセスの種類: 読み取り専用
修飾子: [読み取り]
このコレクションのメンバーを含むクラスの名前。 Configuration Manager はコレクション メンバーを SMS_Collection に格納しません。 このサイトは、 サーバー WMI クラスから派生したメンバー クラス名SMS_CM_RES_COLL_CollectionID動的に生成されます。
MemberCount
データ型: SInt32
アクセスの種類: 読み取り専用
修飾子: [読み取り]
コレクション メンバーの数。
MonitoringFlags
データ型: UInt32
アクセスの種類: 読み取り専用
修飾子: [読み取り]
特定の種類の監視のコレクションを有効にします。
Name
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: [Not_null]
コレクションの名前。 この値は、Configuration Manager コンソール内のコレクションを表し、一意である必要があります。
OwnedByThisSite
データ型: Boolean
アクセスの種類: 読み取り/書き込み
修飾子: なし
trueコレクションがローカル Configuration Manager サイトで発生した場合。 既定値は false です。
PowerConfigsCount
データ型: SInt32
アクセスの種類: 読み取り専用
修飾子: [読み取り]
電源構成の数。
RefreshSchedule
データ型: SMS_ScheduleToken 配列
アクセスの種類: 読み取り/書き込み
Qualifiers: [max(15), lazy]
コレクションSMS_ScheduleToken更新または更新スケジュールを示すサーバー WMI クラス オブジェクト。 アプリケーションがスケジュールを指定するか、SMS_Collection クラスで RequestRefresh メソッドを呼び出す場合にのみ、サイトはコレクション メンバーシップを更新します。 コレクション エバリュエーターがスケジュールを使用するには、 RefreshType プロパティを定期 (2) に設定します。
RefreshType
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: [lazy, enumeration]
この値は、Configuration Manager がコレクションを更新する方法を示します。 既定値は手動 (1) です。 使用可能な値:
| 値 | 更新の種類 |
|---|---|
1 |
Manual |
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 または SWbemServices::Get を使用する必要があります。 詳細については、「Configuration Manager コンテキスト修飾子」を参照してください。
要件
ランタイム要件
詳細については、「Configuration Manager サーバー ランタイムの要件」を参照してください。
開発要件
詳細については、「Configuration Manager サーバー開発の要件」を参照してください。