New-CMDeviceCollection
디바이스 컬렉션을 만듭니다.
구문
New-CMDeviceCollection
[-Comment <String>]
-LimitingCollectionName <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMDeviceCollection
[-Comment <String>]
-InputObject <IResultObject>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMDeviceCollection
[-Comment <String>]
-LimitingCollectionId <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
이 cmdlet을 사용하여 특정 제한 컬렉션을 기반으로 디바이스 컬렉션을 만듭니다. 제한 컬렉션은 사용자가 만든 디바이스 컬렉션의 구성원이 될 수 있는 디바이스를 결정합니다. 예를 들어 모든 시스템 컬렉션을 제한 컬렉션으로 사용하는 경우 새 컬렉션은 Configuration Manager 계층 구조에 모든 디바이스를 포함할 수 있습니다.
그런 다음 멤버 자격 규칙을 사용하여 컬렉션에 디바이스를 추가할 수 있습니다. 디바이스 컬렉션에 멤버를 추가하려면 다음 멤버 자격 규칙 cmdlet 중 하나를 사용합니다.
- Add-CMDeviceCollectionDirectMembershipRule
- Add-CMDeviceCollectionExcludeMembershipRule
- Add-CMDeviceCollectionIncludeMembershipRule
- Add-CMDeviceCollectionQueryMembershipRule
자세한 내용은 Configuration Manager에서 컬렉션을 만드는 방법을 참조하세요.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.
예제
예제 1: 디바이스 컬렉션 만들기
이 명령은 Windows 11을 실행하는 모든 컴퓨터에 대한 컬렉션을 만듭니다. LimitingCollectionName 매개 변수는 All Systems 컬렉션의 모든 디바이스가 새 컬렉션의 멤버가 될 수 있도록 지정합니다.
New-CMDeviceCollection -Name "Windows 11" -LimitingCollectionName "All Systems"매개 변수
-Comment
이 컬렉션을 설명하고 식별할 선택적 주석을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InputObject
제한 컬렉션에 대한 개체를 지정합니다. 이 개체를 얻으려면 Get-CMCollection 또는 Get-CMDeviceCollection cmdlet을 사용합니다.
| 형식: | IResultObject |
| 별칭: | LimitingCollection |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-LimitingCollectionId
제한 컬렉션의 ID를 지정합니다. 이 값은 CollectionID 속성(예 XYZ00012 : 또는 SMS00001)입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-LimitingCollectionName
제한 컬렉션의 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Name
새 디바이스 컬렉션의 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RefreshSchedule
RefreshType 매개 변수를 또는 Both로 Periodic 설정하는 경우 이 매개 변수를 사용하여 일정을 설정합니다. 사이트에서 컬렉션 멤버 자격의 전체 업데이트를 실행할 때 일정 개체를 지정합니다. 이 개체를 얻으려면 New-CMSchedule cmdlet을 사용합니다.
| 형식: | IResultObject |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RefreshType
컬렉션 멤버 자격을 업데이트하는 방법을 지정합니다.
-
Manual(1): 관리자가 Configuration Manager 콘솔 또는 Invoke-CMCollectionUpdate cmdlet 을 사용하여 멤버 자격 업데이트를 수동으로 트리거합니다. -
Periodic(2): 사이트에서 일정에 따라 전체 업데이트를 수행합니다. 증분 업데이트는 사용하지 않습니다. 형식을 지정하지 않으면 이 값이 기본값입니다. -
Continuous(4): 사이트는 정기적으로 새 리소스를 평가한 다음 새 멤버를 추가합니다. 이 형식을 증분 업데이트라고도 합니다. 일정에 따라 전체 업데이트를 수행하지 않습니다. -
Both(6): 증분 업데이트와 일정에 따라 전체 업데이트를 모두 사용하는 및Continuous의 조합Periodic입니다.
또는 Both를 지정 Periodic 하는 경우 RefreshSchedule 매개 변수를 사용하여 일정을 설정합니다.
참고
None 값(0)은 기능적으로 와 동일합니다Manual.
| 형식: | CollectionRefreshType |
| 허용되는 값: | None, Manual, Periodic, Continuous, Both |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
출력
System.Object