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に 1 つの新しいルールを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
アクセスの種類: 読み取り専用
修飾子: [キー、読み取り]
8 文字を含むこのコレクションの一意の自動生成 ID。
コレクション ID の形式は、コレクションを作成したサイト コードの後に、5 桁の 16 進数のシリアル番号 (例: JAX0002C) です。 既定のConfiguration Manager コレクションでは、プレフィックス SMS (例: SMS00001) が使用されます。
CollectionRules
データ型: SMS_CollectionRule 配列
アクセスの種類: 読み取り/書き込み
修飾子: [lazy]
SMS_CollectionRuleコレクションのメンバーシップ条件を定義するサーバー WMI クラス オブジェクトです。
CollectionType
データ型: UInt32
アクセスの種類: 読み取り専用
修飾子: [読み取り、列挙]
コレクションの型。 コレクションを作成または変更する場合、コレクションの種類は、含まれている、除外される、制限されたコレクションすべてで同じである必要があります。 コレクション型の不一致は許可されません。
| 値 | コレクションの種類 |
|---|---|
0 |
その他 |
1 |
User |
2 |
Device |
CollectionVariablesCount
データ型: SInt32
アクセスの種類: 読み取り専用
修飾子: [read]
コレクション変数の数。
Comment
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
コレクションを文書化する一般的なコメントまたはメモ。
CurrentStatus
データ型: UInt32
アクセスの種類: 読み取り専用
修飾子: [読み取り、列挙]
コレクションの現在の状態。 使用可能な値は次のとおりです。
| 値 | 現在の状態 |
|---|---|
0 |
None |
1 |
準備完了 |
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[]
アクセスの種類: 読み取り/書き込み
修飾子: [large, lazy]
パートナーの機能拡張のためのデータ空間。
ISVDataSize
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: [lazy]
ISVData サイズ。
ISVString
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
パートナーの機能拡張の文字列。
LastChangeTime
データ型: DateTime
アクセスの種類: 読み取り/書き込み
修飾子: なし
コレクションが最後に変更された日時。
LastMemberChangeTime
データ型: DateTime
アクセスの種類: 読み取り/書き込み
修飾子: なし
コレクション メンバーシップが最後に変更された日時。
LastRefreshTime
データ型: DateTime
アクセスの種類: 読み取り/書き込み
修飾子: なし
コレクション メンバーシップが最後に更新された日時。
LimitToCollectionID
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
制限コレクションの ID。
LimitToCollectionName
データ型: DateTime
アクセスの種類: 読み取り/書き込み
修飾子: なし
制限コレクションの名前。
LocalMemberCount
データ型: SInt32
アクセスの種類: 読み取り専用
修飾子: [read]
ローカル サイトに表示されるメンバーの数。
MemberClassName
データ型: String
アクセスの種類: 読み取り専用
修飾子: [read]
このコレクションのメンバーを含むクラスの名前。 Configuration Managerでは、コレクション メンバーはSMS_Collectionに格納されません。 サイトはメンバー クラス名を動的に生成し、 サーバー WMI クラスから派生SMS_CM_RES_COLL_CollectionID。
MemberCount
データ型: SInt32
アクセスの種類: 読み取り専用
修飾子: [read]
コレクション メンバーの数。
MonitoringFlags
データ型: UInt32
アクセスの種類: 読み取り専用
修飾子: [read]
特定の種類の監視のコレクションを有効にします。
Name
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: [Not_null]
コレクションの名前。 この値は、Configuration Manager コンソールのコレクションを表し、一意である必要があります。
OwnedByThisSite
データ型: Boolean
アクセスの種類: 読み取り/書き込み
修飾子: なし
trueコレクションがローカル Configuration Manager サイトで発生した場合。 既定値は false です。
PowerConfigsCount
データ型: SInt32
アクセスの種類: 読み取り専用
修飾子: [read]
電源構成の数。
RefreshSchedule
データ型: SMS_ScheduleToken 配列
アクセスの種類: 読み取り/書き込み
修飾子: [max(15), lazy]
SMS_ScheduleTokenコレクションの更新または更新スケジュールを示すサーバー WMI クラス オブジェクト。 サイトは、アプリケーションでスケジュールを指定するか、SMS_Collection クラスで RequestRefresh メソッドを呼び出す場合にのみ、コレクション メンバーシップを更新します。 コレクション エバリュエーターがスケジュールを使用するには、 プロパティを RefreshType periodic (2) に設定します。
RefreshType
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: [lazy, enum]
この値は、コレクションConfiguration Manager更新する方法を示します。 既定値は手動 (1) です。 使用可能な値:
| 値 | 更新の種類 |
|---|---|
1 |
Manual |
2 |
周期 |
4 |
定数更新 |
で RefreshSchedule指定したスケジュールに基づいて更新を行う場合は、このプロパティを periodic (2) に設定します。 このプロパティを manual (1) に設定した場合は、 RequestRefresh メソッドを使用してコレクションを手動で更新します。
ReplicateToSubSites
このプロパティは実装されていません。
ServiceWindowsCount
データ型: SInt32
アクセスの種類: 読み取り専用
修飾子: [read]
このコレクションのメンテナンス期間の数。
UseCluster
データ型: Boolean
アクセスの種類: 読み取り専用
修飾子: [read]
このコレクションがサーバー グループであることを指定します。
注釈
このクラスのクラス修飾子は次のとおりです。
- セキュリティで保護
クラス修飾子と properties セクションに含まれるプロパティ修飾子の両方の詳細については、「クラス修飾子とプロパティ修飾子Configuration Manager」を参照してください。
このクラスで表されるコレクション情報には、更新スケジュールと、 サーバー WMI クラス オブジェクトによって表されるメンバー SMS_CM_RES_COLL_CollectionID含まれます。 アプリケーションはコレクションを使用して、ソフトウェア配布のリソースをターゲットにすることができます。
で SMS_Collection表される動的コレクションに対してクエリを実行する場合は、SMS プロバイダーが読み込まれていること、または別のメソッドまたはクエリが既に実行されていることを確認します。
アプリケーションでは、 メソッドを SMS_Collection 使用して、 プロパティによって定義されたメンバーシップ 規則を追加、更新、または削除する CollectionRules 必要があります。 このプロパティは、アプリケーションが を列挙 SMS_Collectionするときに取得されません。 コレクションのコレクション規則を取得するには、アプリケーションで または SWbemServices::Getを使用IWbemServices::GetObjectする必要があります。 詳細については、「Configuration Manager コンテキスト修飾子」を参照してください。
要件
ランタイム要件
詳細については、「Configuration Manager サーバーランタイム要件」を参照してください。
開発要件
詳細については、「Configuration Manager サーバー開発要件」を参照してください。
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示