Get-CMCollection
디바이스 또는 사용자 컬렉션 개체를 가져옵니다.
구문
Get-CMCollection
[-CollectionType <CollectionType>]
[-Name <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]Get-CMCollection
[-CollectionType <CollectionType>]
-DistributionPointGroup <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]Get-CMCollection
[-CollectionType <CollectionType>]
-DistributionPointGroupId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]Get-CMCollection
[-CollectionType <CollectionType>]
-DistributionPointGroupName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]Get-CMCollection
[-CollectionType <CollectionType>]
-Id <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]Description
이 cmdlet을 사용하여 디바이스 또는 사용자 컬렉션 개체를 가져옵니다.
컬렉션은 리소스를 관리 가능한 단위로 구성하는 데 도움이 됩니다. 클라이언트 관리 요구 사항에 맞게 컬렉션을 만들고 한 번에 여러 리소스에 대한 작업을 수행할 수 있습니다. 대부분의 관리 작업은 하나 이상의 컬렉션을 사용하거나 사용해야 합니다.
가져오는 컬렉션 형식의 범위를 지정하려면 Get-CMDeviceCollection 또는 Get-CMUserCollection cmdlet을 사용합니다.
이름, ID 또는 개체별로 컬렉션을 지정하지 않으면 이 cmdlet은 모든 컬렉션을 반환합니다.
자세한 내용은 Configuration Manager의 컬렉션 소개를 참조하세요.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.
예제
예제 1: 이름으로 컬렉션 가져오기
이 명령은 testUser라는 컬렉션을 가져옵니다.
Get-CMCollection -Name "testUser"예제 2: 배포 지점 그룹에 대한 컬렉션 가져오기
이 명령은 dpg1 이라는 배포 지점 그룹 개체를 가져오고 파이프라인 연산자를 사용하여 배포 지점 그룹과 연결된 컬렉션을 가져오는 Get-CMCollection에 개체를 전달합니다.
Get-CMDistributionPointGroup -Name "dpg1" | Get-CMCollection이러한 컬렉션에 콘텐츠를 배포하면 사이트가 이 배포 지점 그룹의 모든 현재 멤버에게 자동으로 배포됩니다. 자세한 내용은 배포 지점 그룹 관리를 참조하세요.
매개 변수
-CollectionType
가져올 컬렉션 유형을 필터링합니다. 이 매개 변수는 Get-CMDeviceCollection 또는 Get-CMUserCollection cmdlet을 사용하는 것과 기능적으로 동일합니다.
| 형식: | CollectionType |
| 허용되는 값: | User, Device |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DistributionPointGroup
이 컬렉션과 연결된 배포 지점 그룹 개체를 지정합니다. 이 개체를 얻으려면 Get-CMDistributionPointGroup cmdlet을 사용합니다.
| 형식: | IResultObject |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-DistributionPointGroupId
이 컬렉션과 연결된 배포 지점 그룹의 GUID를 지정합니다. 이 값은 GroupID 속성입니다. 이 속성은 중괄호로 둘러싸인 표준 GUID입니다(예: {537e6303-69eb-4104-bf7b-7baf43ce2352}).
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DistributionPointGroupName
이 컬렉션과 연결된 배포 지점 그룹의 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Id
가져올 컬렉션의 ID를 지정합니다. 이 값은 CollectionID 속성(예 XYZ00012 : 또는 SMS00001)입니다.
| 형식: | String |
| 별칭: | CollectionId |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Name
가져올 컬렉션의 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | True |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
출력
IResultObject[]
IResultObject
참고
이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_Collection 서버 WMI 클래스를 참조하세요.