Get-CMCollection

  • 참조
모듈:
ConfigurationManager

디바이스 또는 사용자 컬렉션 개체를 가져옵니다.

Syntax

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을 사용하는 것과 기능적으로 동일합니다.

Type:CollectionType
Accepted values:User, Device
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

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

-DistributionPointGroup

이 컬렉션과 연결된 배포 지점 그룹 개체를 지정합니다. 이 개체를 얻으려면 Get-CMDistributionPointGroup cmdlet을 사용합니다.

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

-DistributionPointGroupId

이 컬렉션과 연결된 배포 지점 그룹의 GUID를 지정합니다. 이 값은 GroupID 속성입니다. 이 속성은 중괄호로 둘러싸인 표준 GUID입니다(예: {537e6303-69eb-4104-bf7b-7baf43ce2352}).

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

-DistributionPointGroupName

이 컬렉션과 연결된 배포 지점 그룹의 이름을 지정합니다.

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

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

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

-Id

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

Type:String
Aliases:CollectionId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

가져올 컬렉션의 이름을 지정합니다.

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

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

IResultObject[]

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_Collection 서버 WMI 클래스를 참조하세요.