---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 디스커버리 시작 - 전역

# 디스커버리 시작 - 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 4분

StartDiscovery 스크립트 포함은 검색 작업을 시작하는 메서드를 제공합니다.

검색 검사 단계에서 이 스크립트 포함을 사용합니다.

## 검색 시작 - addAdditionalIP(문자열 상태, 문자열 ip, 문자열 센서) {#ariaid-title2}

기존 검색(네트워크 검색에서 사용됨)에 IP(또는 쉼표로 구분된 IP 목록)를 추가합니다.
{#r_SDY-addAdditionalIP_S_S_S__table_zdv_1dv_tt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 상태 | 문자열 | 디스커버리 상태 |
| ip | 문자열 | IP 주소 또는 쉼표로 구분된 IP 주소 목록입니다. |
| 센서 | 문자열 | 검색 센서 |
[표 1. 매개변수]

{#r_SDY-addAdditionalIP_S_S_S__table_zdv_1dv_tt} {#r_SDY-addAdditionalIP_S_S_S__table_a2v_1dv_tt__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 2. 반환]

{#r_SDY-addAdditionalIP_S_S_S__table_a2v_1dv_tt}

## StartDiscovery - discoverFromSchedule(문자열 ip, 부울 samePhase, 문자열 센서) {#ariaid-title3}

일정에서 장치 검색(기본 또는 고급)을 처리합니다.
{#r_SDY-discoverFromSchedule_S_B_S__table_cq1_xdv_tt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| ip | 문자열 | IP 주소 또는 쉼표로 구분된 IP 주소 목록입니다. |
| 동일 단계 | 부울 |   |
| 센서 | 문자열 | 검색 센서 |
[표 3. 매개변수]

{#r_SDY-discoverFromSchedule_S_B_S__table_cq1_xdv_tt} {#r_SDY-discoverFromSchedule_S_B_S__table_dq1_xdv_tt__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 4. 반환]

{#r_SDY-discoverFromSchedule_S_B_S__table_dq1_xdv_tt}

## 검색 시작 - getCancelScript() {#ariaid-title4}

취소 스크립트를 반환합니다.
{#r_SDY-getCancelScript__table_idb_t2v_tt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 5. 매개변수]

{#r_SDY-getCancelScript__table_idb_t2v_tt} {#r_SDY-getCancelScript__table_jdb_t2v_tt__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 취소 스크립트 |
[표 6. 반환]

{#r_SDY-getCancelScript__table_jdb_t2v_tt}

## 검색 시작 - scheduleCancelJob() {#ariaid-title5}

일정에 취소 시간이 지정된 경우 필요한 경우 검색을 취소하는 작업을 예약합니다.
{#r_SDY-scheduleCancelJob__table_smg_l2v_tt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 7. 매개변수]

{#r_SDY-scheduleCancelJob__table_smg_l2v_tt} {#r_SDY-scheduleCancelJob__table_tmg_l2v_tt__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 8. 반환]

{#r_SDY-scheduleCancelJob__table_tmg_l2v_tt}  
다음 예제는 scheduleCancelJob() 메서드를 사용하여 현재 검색 작업을 취소하는 방법을 보여줍니다.

    var discoveryScheduleGR = new GlideRecord('discovery_schedule'); // Create a discovery schedule Gliderecord
    discoveryScheduleGR.get('name', 'Disco'); // Put the discovery schedule job name

    var discoverySchedule = new DiscoverySchedule(discoveryScheduleGR); 
    var discoveryStatusSysId = new StartDiscovery().startFromIP(discoverySchedule, '172.167.31.231'); // Initiate discovery
    gs.info(discoveryStatusSysId); // Display the sys_id of the discovery status record

    discoveryStatusSysId.scheduleCancelJob(); // Schedule a cancel job, located in the sys_trigger table

출력:

    Operation	Table		Row Count
    insert		discovery_result	1
    update		discovery_status	1
    insert		sys_trigger	     1
    insert		discovery_status	1
    *** Script: Fired started event for: undefined Disco
    *** Script: Scheduling Discovery DIS0010023 for cancellation at 2022-02-13 16:42:44
    *** Script: 1828b05f1b6d811070cb96c6b04bcb53

## StartDiscovery - startFromIP(DiscoverySchedule 일정, 문자열 ip) {#ariaid-title6}

지정된 일정을 사용하여 단일 IP에 대한 검색을 시작하고 MID 서버 및 동작과 같은 정보를 가져옵니다.
{#r_SDY-startFromIP_DS_S__table_elc_1cv_tt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 일정 | 디스커버리 일정 | 사용할 일정에 대한 DiscoverySchedule 인스턴스입니다. |
| ip | 문자열 | 검색할 IP 주소입니다. 형식: 점 형식의 문자열 |
[표 9. 매개변수]

{#r_SDY-startFromIP_DS_S__table_elc_1cv_tt} {#r_SDY-startFromIP_DS_S__table_flc_1cv_tt__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 생성된 상태 기록의 Sys_id입니다. |
[표 10. 반환]

{#r_SDY-startFromIP_DS_S__table_flc_1cv_tt}  
이 예제에서는 startFromIP() 메서드를 사용하여 검색 정보가 포함된 레코드를 가져옵니다.

    // Get a discovery schedule gliderecord
    var discoveryScheduleGR = new GlideRecord('discovery_schedule'); 
    discoveryScheduleGR.get('name', 'Discover Management Range 172.x.x.x');

    // Create a DiscoverySchedule object to get information such as MID servers and behaviors
    var discoverySchedule = new DiscoverySchedule(discoveryScheduleGR); 
    var discoveryStatusSysId = new StartDiscovery().startFromIP(discoverySchedule, '172.1.1.10');
     
    // Sys_id of the genterated status record
    gs.info(discoveryStatusSysId);

출력:

    9d3c1197c611228701cd1d94bc32d76d

## StartDiscovery - startFromSchedule(GlideRecord 일정, GlideRecord 작업) {#ariaid-title7}

예약된(또는 지금 검색) 검색을 시작하기 위해 검색 스크립트 포함에 의해 호출됩니다.
{#r_SDY-startFromSchedule_GR_GR__table_fgm_jbv_tt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 일정 | GlideRecord | 이 검색의 기반이 되는 discovery_schedule의 인스턴스입니다. |
| 작업 | GlideRecord | 이 검색을 트리거한 sys_trigger의 인스턴스입니다. |
[표 11. 매개변수]

{#r_SDY-startFromSchedule_GR_GR__table_fgm_jbv_tt} {#r_SDY-startFromSchedule_GR_GR__table_ggm_jbv_tt__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 12. 반환]

{#r_SDY-startFromSchedule_GR_GR__table_ggm_jbv_tt}