---
sourceDocument: Xanadu 애플리케이션과의 통합 생성
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu 애플리케이션과의 통합 생성

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# 쿼리 AD 활동

# 쿼리 AD 활동 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 1분

Query AD 활동은 LDAP 검색 필터를 기반으로 Windows Active Directory에서 항목을 검색하고 결과를 데이터 버스에서 사용할 수 있는 JSON 문자열로 저장합니다.
워크플로우 편집기에서 이 활동에 액세스하려면 사용자 지정 탭을 선택한 후 사용자 지정 활동Active Directory.  
주:  
이 활동은 Geneva 이전 릴리스에서 사용할 수 있는 동일한 이름의 AD 활동을 대체합니다. 더 이상 사용되지 않는 활동을 사용하는 워크플로우가 있는 경우 워크플로우는 Instanbul로 업그레이드한 후에도 계속 정상적으로 작동하며 쿼리 결과를 스크래치패드에 계속 저장합니다. 그러나 모든 새 워크플로는 이 활동의 사용자 지정 버전을 사용해야 합니다. 이 활동은 스크래치패드 대신 [데이터버스](https://servicenow-prod.fluidtopics.net/REfzyEj7Ghr9zSKpgOSFcw#t_ReuseDataInTheActivityDesigner "워크플로우 편집기의 데이터 탭에는 데이터를 생성하는 현재 워크플로우에 사용되는 모든 사용자 지정 활동이 나열되며, 다른 사용자 지정 활동에서 재사용할 수 있도록 해당 데이터가 표시됩니다.")에 입력 및 출력 변수를 저장하는 를 사용하여 [PowerShell 활동 만들기](https://servicenow-prod.fluidtopics.net/vUhWYYjRiHh7pasyuS0Gww#t_CreateAPowershellActivity "사용자 지정 PowerShell 활동을 생성하고 Microsoft PowerShell을 사용하여 호스트에서 워크플로우로 데이터를 반환합니다.")빌드되었습니다.

## 입력 변수

{#r_QueryAD__table_qjs_44h_dp__entry__2}

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

{#r_QueryAD__table_qjs_44h_dp}

## 출력 변수

{#r_QueryAD__table_o54_yc1_ts__entry__2}

| 변수 | 설명 |
|-|-|
| 결과 | 성공 또는 실패. |
| errorMessage | 에서 executionResult.errorMessages[활동 디자이너 구문 분석 소스](https://servicenow-prod.fluidtopics.net/wpFk5f3z63DSYYFUiJ8p1g#r_ActivityDesignerParsingSources "이 표에는 각 실행 템플릿에서 사용할 수 있는 구문 분석 소스가 나열되어 있습니다."). |
| 출력 | 쿼리 결과입니다. |
[표 2. 쿼리 AD 출력 변수]

{#r_QueryAD__table_o54_yc1_ts}

## 조건

{#r_QueryAD__table_r4q_cd1_ts__entry__2}

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

{#r_QueryAD__table_r4q_cd1_ts}