장치 컬렉션 활동 가져오기

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

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

워크플로우 편집기에서 이 활동에 액세스하려면 사용자 지정 탭을 선택한 다음 사용자 지정 활동 > 시스템 센터 구성 관리자(SCCM).

주:

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

입력 변수

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

변수	설명
sccm서버	SCCM 서버의 FQDN(전체 주소 도메인 이름)입니다.

출력 변수

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

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

조건

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

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