New-CMCollection
장치 또는 사용자 컬렉션을 만들 수 있습니다.
Syntax
New-CMCollection
-CollectionType <CollectionType>
[-Comment <String>]
-LimitingCollectionName <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMCollection
-CollectionType <CollectionType>
[-Comment <String>]
-InputObject <IResultObject>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMCollection
-CollectionType <CollectionType>
[-Comment <String>]
-LimitingCollectionId <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
이 cmdlet을 사용하여 장치 또는 사용자 컬렉션을 만들 수 있습니다.
제한 컬렉션에 따라 만드는 컬렉션의 구성원이 될 수 있는 자원이 결정됩니다. 예를 들어 All Systems 컬렉션을 제한 컬렉션으로 사용하는 경우 디바이스 컬렉션이기 때문에 새 장치 컬렉션은 Configuration Manager 계층 구조의 모든 장치를 포함할 수 있습니다.
만드는 컬렉션 유형의 범위를 지정하기 위해 New-CMDeviceCollection 또는 New-CMUserCollection cmdlet을 사용할 수도 있습니다.
컬렉션을 만든 후 구성원 자격 규칙을 사용하여 컬렉션에 리소스를 추가합니다. 컬렉션에 구성원을 추가하기 위해 cmdlet 중 하나를 사용하여 구성원 자격 규칙을 추가합니다. 예를 들면 다음과 같습니다.
자세한 내용은 Configuration Manager에서 컬렉션을 만드는 방법을 참조하세요.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>
). 자세한 내용은 시작을 참조하세요.
예제
예제 1: 사용자 컬렉션 만들기
이 명령은 All Users 컬렉션을 제한 컬렉션으로 설정하는 testUser라는 사용자 컬렉션을 만듭니다.
New-CMCollection -CollectionType User -LimitingCollectionName "All Users" -Name "testUser"
예제 2: 파이프라인을 통해 제한 컬렉션 설정
이 명령은 먼저 Get-CMCollection을 사용하여 All Users 컬렉션 개체를 사용합니다. 그런 다음 파이프라인 연산자를 사용하여 개체를 New-CMCollection cmdlet에 전달하여 testUser 컬렉션을 만듭니다. 새 testUser 컬렉션의 제한 컬렉션은 All Users 컬렉션입니다.
Get-CMCollection -Name "All Users" | New-CMCollection -Name "testUser" -CollectionType "User"
매개 변수
-CollectionType
만들 컬렉션 유형을 지정합니다. 이 매개 변수는 New-CMDeviceCollection 또는 New-CMUserCollection cmdlet을 사용하는 경우와 기능적으로 동일합니다.
Type: | CollectionType |
Accepted values: | User, Device |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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 |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과결합할 수 있습니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하며 예기치 않은 동작이 발생할 수 있습니다(권장하지 않음). DisableWildcardHandling과결합할 수 없습니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
제한 컬렉션에 대한 개체를 지정합니다. 이 개체를 얻습니다. Get-CMCollection, Get-CMDeviceCollection또는 Get-CMUserCollection 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 |
Aliases: | LimitToCollectionId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LimitingCollectionName
제한 컬렉션의 이름을 지정합니다.
Type: | String |
Aliases: | LimitToCollectionName |
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 |
-VariablePriority
장치 컬렉션 변수의 우선 순위에 대해 1-9의 정수 값을 지정합니다. 1
는 가장 낮은 우선 9
순위로, 가장 높은 우선 순위입니다.
디바이스 컬렉션에 변수를 만들하려면 New-CMDeviceCollectionVariable cmdlet을 사용합니다.
Type: | Int32 |
Aliases: | DeviceCollectionVariablePrecedence |
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
출력
IResultObject
참고
이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_Collection 서버 WMI 클래스를 참조하세요.