Get-CMCollectionMember

참조

모듈:: ConfigurationManager

장치 또는 사용자 컬렉션의 구성원을 얻습니다.

Syntax

Get-CMCollectionMember
   -CollectionName <String>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMCollectionMember
   -CollectionId <String>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMCollectionMember
   -InputObject <IResultObject>
   [-Name <String>]
   [-ResourceId <Int32>]
   [-SmsId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 컬렉션의 구성원을 얻을 수 있습니다. 컬렉션에는 장치나 사용자가 모두 포함할 수 있지만 둘 다 포함할 수 없습니다. 컬렉션을 쿼리할 때 이 cmdlet은 모든 구성원에 대한 개체를 반환합니다.

자세한 내용은 Configuration Manager의 컬렉션 소개를 참조하세요.

참고

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

예제

예제 1: 파이프라인 연산자를 사용하여 컬렉션의 구성원을 얻다

이 명령은 먼저 Get-CMCollection cmdlet을 사용하여 UserCol1이라는컬렉션 개체를 사용합니다. 그런 다음 파이프라인 연산자를 사용하여 개체를 Get-CMCollectionMember에전달하여 컬렉션의 모든 구성원을 얻습니다. 마지막으로 이 예제에서는 Select-Object cmdlet을 사용하여 구성원 이름만 표시합니다.

Get-CMCollection -Name "UserCol1" | Get-CMCollectionMember | Select-Object Name

예제 2: 이름으로 컬렉션의 구성원을 지정합니다.

이 명령은 DeviceCol1 컬렉션에서 이름이 로 시작되는 구성원을 domain 쿼리합니다. Asterisk( * ) 와일드카드는 여러 문자와 일치합니다. 따라서 결과에는 "domain1" 또는 "domain-controller" 등의 이름이 포함됩니다.

Get-CMCollectionMember -CollectionName "DeviceCol1" -Name "domain*"

예제 3: 컬렉션 세부 정보를 CSV로 내보내기

이 예제에서는 XYZ0004B 장치 컬렉션에서 속성 집합을 쿼리하고 변수 에 $collMem. 두 번째 줄은 해당 데이터를 CSV(콤보로 구분된 값) 형식으로 변환하고 파일로 출력합니다.

$collMem = Get-CMCollectionMember -CollectionId "XYZ0004B" | Select-Object Name,Domain,LastLogonUser,DeviceOS,DeviceOSBuild,MACAddress,SerialNumber
$collMem | ConvertTo-Csv -NoTypeInformation | Out-File -FilePath "C:\output\XYZ0004B.csv"

매개 변수

-CollectionId

쿼리할 컬렉션의 ID를 지정합니다. 예를 들면 "XYZ0004B"와 같습니다.

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

-CollectionName

쿼리할 컬렉션의 이름을 지정합니다.

Type:	String
Position:	Named
Default value:	None
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

쿼리할 컬렉션 개체를 지정합니다. 컬렉션 개체를 얻은 경우 다음 cmdlet 중 하나를 사용합니다.

파이프라인 연산자( )를 사용하여 명령줄의 | Get-CMCollectionMemeber에 컬렉션 개체를 전달할 수도 있습니다.

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

-Name

결과를 필터링하기 위해 컬렉션에 있는 자원의 이름을 지정합니다. 이 필터는 대소문자 구분이 없습니다.

와일드카드 문자를 사용할 수 있습니다.

*: 여러 문자
?: 단일 문자

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

-ResourceId

결과를 필터링하기 위해 리소스 ID를 지정합니다. 예를 들면 16777242와 같습니다. 이 cmdlet은 대상 컬렉션의 해당 리소스에 대한 레코드만 반환합니다.

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

-SmsId

결과를 필터링하기 위해 리소스의 SMSID를 지정합니다. 예를 들면 "GUID:7a186367-7372-4841-889e-ba2e3aad1e85"와 같습니다. 이 필터는 대소문자 구분이 없습니다.