쿼리 AD 활동

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기1분
  • 쿼리 AD 작업은 LDAP 검색 필터를 기반으로 Windows Active Directory에서 항목을 검색하고 결과를 데이터 버스에서 사용할 수 있는 JSON 문자열로 저장합니다.

    워크플로우 편집기에서 이 활동에 접근하려면 사용자 지정 탭을 선택한 후 사용자 지정 활동 > Active Directory > .
    주:
    이 활동은 Geneva 이전 릴리스에서 사용할 수 있는 동일한 이름으로 AD 활동을 대체합니다. 사용되지 않는 활동을 사용하는 워크플로우가 있는 경우 Instanbul로 업그레이드한 후에도 워크플로우가 계속 정상적으로 작동하고 쿼리 결과를 스크래치패드에 계속 저장합니다. 그러나 모든 새 워크플로우는 이 활동의 사용자 지정 버전을 사용해야 합니다. 이 활동은 스크래치패드 대신 데이터버스에 입력 및 출력 변수를 저장하는 를 PowerShell 활동 생성사용하여 작성되었습니다.

    입력 변수

    표 1. 쿼리 AD 입력 변수
    변수 설명
    도메인 컨트롤러 도메인 컨트롤러 머신의 IP 주소입니다.
    속성 반환할 Active Directory 속성의 목록이며 콤마로 구분됩니다. 예를 들어, givenName,SN,title을(를) 선택합니다. 이 필드가 비어 있으면 모든 속성이 반환됩니다.
    검색 필터 검색 매개변수를 정의하는 LDAP 필터 문자열입니다. 유효한 LDAP 필터링 기준을 사용합니다. 예를 들어 입력 레코드와 ServiceNow 일치하는 사용자 계정을 찾으려면 다음을 사용합니다.
    (samaccountname=${workflow.inputs.u_user.user_name})

    출력 변수

    표 2. 쿼리 AD 출력 변수
    변수 설명
    결과 성공 또는 실패.
    errorMessage 에서 executionResult.errorMessages활동 디자이너 구문 분석 소스.
    출력 쿼리 결과입니다.

    조건

    표 3. 쿼리 AD 조건
    조건 설명
    성공 쿼리가 예상대로 완료되었습니다.
    실패 쿼리를 처리하는 동안 오류가 발생했습니다. 워크플로우 로그에서 더 자세한 정보를 확인할 수 있습니다.