SMS_Collection 서버 WMI 클래스

아티클
04/04/2023

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(클라이언트 구성 요청)을 만듭니다.
CreateCCR 메서드: 컬렉션의 컴퓨터에 대한 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 배열

액세스 유형: 읽기/쓰기

한정자: [지연]

컬렉션의 멤버 자격 조건을 정의하는 서버 WMI 클래스 개체를 SMS_CollectionRule.

`CollectionType`

데이터 형식: UInt32

액세스 유형: 읽기 전용

한정자: [읽기, 열거형]

컬렉션의 형식입니다. 컬렉션을 만들거나 수정할 때 컬렉션 형식은 포함, 제외 및 제한된 모든 컬렉션에 대해 동일해야 합니다. 일치하지 않는 컬렉션 형식은 허용되지 않습니다.

값	컬렉션 유형
`0`	기타
`1`	사용자
`2`	디바이스

`CollectionVariablesCount`

데이터 형식: SInt32

액세스 유형: 읽기 전용

한정자: [읽기]

컬렉션 변수의 수입니다.

`Comment`

데이터 형식: String

액세스 유형: 읽기/쓰기

한정자: 없음

일반 주석 또는 참고는 컬렉션을 문서화합니다.

`CurrentStatus`

데이터 형식: UInt32

액세스 유형: 읽기 전용

한정자: [읽기, 열거형]

컬렉션의 현재 상태입니다. 가능한 값은 다음과 같습니다.

값	현재 상태
`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[]

액세스 유형: 읽기/쓰기

한정자: [large, lazy]

파트너 확장성을 위한 데이터 공간입니다.

`ISVDataSize`

데이터 형식: UInt32

액세스 유형: 읽기/쓰기

한정자: [지연]

ISVData 크기입니다.

`ISVString`

데이터 형식: String

액세스 유형: 읽기/쓰기

한정자: 없음

파트너 확장성을 위한 문자열입니다.

`LastChangeTime`

데이터 형식: DateTime

액세스 유형: 읽기/쓰기

한정자: 없음

컬렉션이 마지막으로 변경된 날짜 및 시간입니다.

`LastMemberChangeTime`

데이터 형식: DateTime

액세스 유형: 읽기/쓰기

한정자: 없음

컬렉션 멤버 자격이 마지막으로 변경된 날짜 및 시간입니다.

`LastRefreshTime`

데이터 형식: DateTime

액세스 유형: 읽기/쓰기

한정자: 없음

컬렉션 멤버 자격을 마지막으로 새로 고친 날짜 및 시간입니다.

`LimitToCollectionID`

데이터 형식: String

액세스 유형: 읽기/쓰기

한정자: 없음

제한 컬렉션의 ID입니다.

`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 배열

액세스 유형: 읽기/쓰기

한정자: [max(15), 지연]

SMS_ScheduleToken 서버 WMI 클래스 개체는 컬렉션에 대한 업데이트 또는 새로 고침 일정을 나타냅니다. 이 사이트는 애플리케이션이 일정을 지정하거나 SMS_Collection 클래스에서 RequestRefresh 메서드를 호출하는 경우에만 컬렉션 멤버 자격을 업데이트합니다. 컬렉션 계산기에서 일정을 사용하려면 속성을 주기적()로2 설정합니다RefreshType.

`RefreshType`

데이터 형식: UInt32

액세스 유형: 읽기/쓰기

한정자: [지연, 열거형]

이 값은 Configuration Manager 컬렉션을 새로 고치는 방법을 나타냅니다. 기본값은 수동(1)입니다. 사용 가능한 값:

값	새로 고침 유형
`1`	수동
`2`	정기적인
`4`	상수 업데이트

에 지정된 RefreshSchedule일정에 따라 새로 고침을 기반으로 하려면 이 속성을 주기적(2)로 설정합니다. 이 속성을 수동(1)으로 설정하면 RequestRefresh 메서드를 사용하여 컬렉션을 수동으로 업데이트합니다.

`ReplicateToSubSites`

이 속성은 구현되지 않습니다.

`ServiceWindowsCount`

데이터 형식: SInt32

액세스 유형: 읽기 전용

한정자: [읽기]

이 컬렉션의 유지 관리 기간 수입니다.

`UseCluster`

데이터 형식: Boolean

액세스 유형: 읽기 전용

한정자: [읽기]

이 컬렉션이 서버 그룹임을 지정합니다.

설명

이 클래스의 클래스 한정자는 다음과 같습니다.

보안됨

클래스 한정자와 속성 섹션에 포함된 속성 한정자 모두에 대한 자세한 내용은 클래스 및 속성 한정자 Configuration Manager 참조하세요.

이 클래스가 나타내는 컬렉션 정보에는 새로 고침 일정과 SMS_CM_RES_COLL_CollectionID 서버 WMI 클래스 개체로 표현되는 멤버가 포함됩니다. 애플리케이션은 컬렉션을 사용하여 소프트웨어 배포를 위한 리소스를 대상으로 할 수 있습니다.

로 표시되는 SMS_Collection동적 컬렉션에 대해 쿼리를 실행하는 경우 SMS 공급자가 로드되었거나 다른 메서드 또는 쿼리가 이미 실행되었는지 확인합니다.

애플리케이션을 추가 하는 메서드를 SMS_Collection 사용 해야, 업데이트 또는 속성에 의해 정의 된 CollectionRules 멤버 자격 규칙을 삭제 합니다. 이 속성은 애플리케이션이 를 열거할 때 검색되지 않습니다.SMS_Collection 컬렉션에 대한 컬렉션 규칙을 가져오려면 애플리케이션에서 또는 SWbemServices::Get를 사용해야 IWbemServices::GetObject 합니다. 자세한 내용은 컨텍스트 한정자 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`