사용자 컬렉션 활동 가져오기

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 1분

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

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

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

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

    입력 변수

    표 1. 사용자 컬렉션 입력 변수 가져오기
    변수 설명
    sccm서버 SCCM 서버의 FQDN(전체 주소 도메인 이름)입니다.

    출력 변수

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

    조건

    표 3. 사용자 컬렉션 조건 가져오기
    조건 설명
    성공 활동을 통해 SCCM 호스트에서 사용 가능한 사용자 컬렉션 목록을 검색했습니다.
    장애 활동에서 SCCM 호스트에서 사용 가능한 사용자 컬렉션 목록을 검색하지 못했습니다.