---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://www.servicenow.com/docs/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# StartDiscovery - グローバル

# StartDiscovery - グローバル {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：5分

StartDiscovery スクリプトインクルードは、ディスカバリージョブを開始するためのメソッドを提供します。

このスクリプトインクルードは、ディスカバリースキャンフェーズ中に使用します。

## StartDiscovery - addAdditionalIP(文字列 status, 文字列 ip, 文字列 sensor) {#ariaid-title2}

既存の検出 (ネットワーク検出で使用) に IP (または IP のカンマ区切りリスト) を追加します。
{#r_SDY-addAdditionalIP_S_S_S__table_zdv_1dv_tt__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| status | 文字列 | 検出ステータス |
| ip | 文字列 | IP アドレス、または IP アドレスのカンマ区切りリスト。 |
| sensor | 文字列 | 検出センサー |
[表 : 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, 文字列 sensor) {#ariaid-title3}

スケジュールから、デバイスの検出 (基本または詳細) を処理します。
{#r_SDY-discoverFromSchedule_S_B_S__table_cq1_xdv_tt__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| ip | 文字列 | IP アドレス、または IP アドレスのカンマ区切りリスト。 |
| samePhase | ブーリアン |   |
| sensor | 文字列 | 検出センサー |
[表 : 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}

## StartDiscovery - 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}

## StartDiscovery - 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 schedule, 文字列 ip) {#ariaid-title6}

指定されたスケジュールを使用して単一の IP の検出を開始し、MID Server や動作などの情報を取得します。
{#r_SDY-startFromIP_DS_S__table_elc_1cv_tt__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| schedule | DiscoverySchedule | 使用するスケジュールの 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 schedule, GlideRecord job) {#ariaid-title7}

スケジュールされた (または今すぐ検出の) 検出を開始する検出のスクリプトインクルードによって呼び出されます。
{#r_SDY-startFromSchedule_GR_GR__table_fgm_jbv_tt__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| schedule | GlideRecord | この検出の基になる discovery_schedule のインスタンス。 |
| job | 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}