Get-CMCollectionMember
디바이스 또는 사용자 컬렉션의 멤버를 가져옵니다.
구문
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. 별표(*) 와일드카드는 여러 문자와 일치합니다. 따라서 결과에는 "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"와 같습니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CollectionName
쿼리할 컬렉션의 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InputObject
쿼리할 컬렉션 개체를 지정합니다. 컬렉션 개체를 얻으려면 다음 cmdlet 중 하나를 사용합니다.
파이프라인 연산자(|)를 사용하여 명령줄의 Get-CMCollectionMemeber 에 컬렉션 개체를 전달할 수도 있습니다.
| 형식: | IResultObject |
| 별칭: | Collection |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Name
결과를 필터링하려면 컬렉션에 있는 리소스의 이름을 지정합니다. 이 필터는 대/소문자를 구분하지 않습니다.
와일드카드 문자를 사용할 수 있습니다.
-
*: 여러 문자 -
?: 단일 문자
| 형식: | String |
| 별칭: | ResourceName |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | True |
-ResourceId
결과를 필터링하려면 리소스 ID를 지정합니다. 예를 들면 16777242와 같습니다. cmdlet은 대상 컬렉션의 해당 리소스에 대한 레코드만 반환합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SmsId
결과를 필터링하려면 리소스의 SMSID를 지정합니다. 예를 들면 "GUID:7a186367-7372-4841-889e-ba2e3aad1e85"와 같습니다. 이 필터는 대/소문자를 구분하지 않습니다.
와일드카드 문자를 사용할 수 있습니다.
-
*: 여러 문자 -
?: 단일 문자
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | True |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
출력
System.Object