New-CMDeviceCollection

참조

모듈:: ConfigurationManager

디바이스 컬렉션을 생성합니다.

Syntax

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을 사용하여 특정 제한 컬렉션을 기반으로 장치 컬렉션을 만들 수 있습니다. 제한 컬렉션에 따라 만드는 장치 컬렉션의 구성원이 될 수 있는 장치가 결정됩니다. 예를 들어 All Systems 컬렉션을 제한 컬렉션으로 사용하면 새 컬렉션에 Configuration Manager 계층 구조의 모든 디바이스가 포함할 수 있습니다.

그런 다음 구성원 자격 규칙을 사용하여 컬렉션에 장치를 추가할 수 있습니다. 장치 컬렉션에 구성원을 추가하려면 다음 멤버 자격 규칙 cmdlet 중 하나를 사용합니다.

자세한 내용은 Configuration Manager에서 컬렉션을 만드는 방법을 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\> ). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 장치 컬렉션 만들기

이 명령은 에서 실행되는 모든 컴퓨터에 대한 컬렉션을 Windows 11. LimitingCollectionName 매개 변수는 All Systems 컬렉션의 모든 장치가 새 컬렉션의 구성원이 될 수 있습니다.

New-CMDeviceCollection -Name "Windows 11" -LimitingCollectionName "All Systems"

매개 변수

-Comment

선택적 설명을 지정하여 이 컬렉션을 설명하고 식별합니다.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

제한 컬렉션에 대한 개체를 지정합니다. 이 개체를 얻거나 Get-CMCollection 또는 Get-CMDeviceCollection cmdlet을 사용합니다.

Type:	IResultObject
Aliases:	LimitingCollection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-LimitingCollectionId

제한 컬렉션의 ID를 지정합니다. 이 값은 CollectionID 속성(예: 또는 XYZ00012 SMS00001 )입니다.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LimitingCollectionName

제한 컬렉션의 이름을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

새 장치 컬렉션의 이름을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RefreshSchedule

RefreshType 매개 변수를 또는 로 설정하는 경우 이 매개 변수를 Periodic Both 사용하여 일정을 설정할 수 있습니다. 사이트에서 컬렉션 멤버 자격의 전체 업데이트를 실행하는 경우의 일정 개체를 지정합니다. 이 개체를 얻습니다. New-CMSchedule cmdlet을 사용합니다.

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RefreshType

컬렉션 구성원을 업데이트하는 방법을 지정합니다.

Manual (1): 관리자는 Configuration Manager 콘솔 또는 Invoke-CMCollectionUpdate cmdlet을 통해 멤버 자격 업데이트를 수동으로 트리거합니다.
Periodic (2): 사이트가 일정에 따라 전체 업데이트를 실행합니다. 증분 업데이트를 사용하지 않습니다. 형식을 지정하지 않으면 이 값이 기본값입니다.
Continuous (4): 사이트에서 새 리소스를 주기적으로 평가한 다음 새 구성원을 추가합니다. 이 유형을 증분 업데이트라고도 합니다. 일정에 따라 전체 업데이트를 하지 않습니다.
Both (6): 증분 업데이트와 일정에 대한 전체 업데이트가 모두 있는 및 의 Periodic Continuous 조합입니다.

또는 를 지정하는 경우 Periodic Both RefreshSchedule 매개 변수를 사용하여 일정을 설정할 수 있습니다.

참고

None값(0)은 과 기능적으로 Manual 동일합니다.

Type:	CollectionRefreshType
Accepted values:	None, Manual, Periodic, Continuous, Both
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. 이 cmdlet은 실행되지 않습니다.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object