장치 컬렉션 가져오기 활동

장치 컬렉션 가져오기 활동은 Microsoft System Center Configuration Manager(SCCM) 호스트에서 사용 가능한 장치 컬렉션 목록을 반환합니다.

장치 컬렉션 가져오기 활동은 Powershell 활동 템플릿을 사용하여 SCCM 서버의 컬렉션에 액세스합니다. 활동은 Powershell 기능이 있는 MID 서버를 사용하고 서버에서 장치 컬렉션을 반환하는 GetDeviceCollections.ps1 이라는 MID 서버 스크립트를 실행하도록 구성됩니다. 이 스크립트는 SCCM 서버의 장치 컬렉션에 대해 특정 속성만 반환되도록 GET 결과를 필터링합니다. 이러한 방식으로 결과를 필터링하면 페이로드의 크기가 제어되고 가장 바람직한 장치 컬렉션 데이터가 제공됩니다. 사용 가능한 컬렉션 목록은 JSON 개체의 배열로 반환됩니다.

워크플로우 편집기에서 이 활동에 접근하려면 사용자 지정 탭을 선택한 후 사용자 지정 활동 > System Center Configuration Manager(SCCM).

주:

장치 컬렉션 가져오기 활동은 전처리 스크립트를 사용하지 않습니다.

입력 변수

표 1. 장치 컬렉션 입력 변수 가져오기

변수	설명
sccm서버	SCCM 서버의 정규화된 도메인 이름(FQDN)입니다.

출력 변수

표 2. 장치 컬렉션 출력 변수 가져오기

변수	설명
deviceCollections	배열에는 deviceCollections 다음 속성이 포함되어 있습니다. id: SCCM 장치 컬렉션의 기본 키입니다. name: SCCM 장치 컬렉션의 이름입니다. collectionType: SCCM 컬렉션의 유형입니다. 이 경우 값은 device입니다. localMemberCount: 로컬 SCCM 사이트에 표시되는 장치 컬렉션 구성원의 수입니다. memberCount: 모든 장치 컬렉션 구성원의 수입니다. deviceCollection: 이 장치 컬렉션에 대해 여기에 나열된 속성 데이터 세트를 포함하는 객체입니다. 후처리 스크립트를 사용하여 이 세트의 추가 데이터를 구문 분석하여 사용합니다.
오류	활동 출력 오류 메시지가 포함된 변수입니다.

조건

표 3. 장치 컬렉션 조건 가져오기

조건	설명
성공	활동이 SCCM 호스트에서 사용할 수 있는 장치 컬렉션 목록을 성공적으로 검색했습니다.
실패	활동이 SCCM 호스트에서 사용할 수 있는 장치 컬렉션 목록을 검색하지 못했습니다.