StartDiscovery: グローバル

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:5分
  • StartDiscovery スクリプトインクルードは、ディスカバリージョブを開始するメソッドを提供します。

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

    StartDiscovery - addAdditionalIP(文字列ステータス、文字列 ip、文字列センサー)

    IP (またはカンマ区切りの IP のリスト) を既存のディスカバリー (ネットワークディスカバリーで使用される) に追加します。

    表 : 1. パラメーター
    名前 タイプ 説明
    ステータス 文字列 ディスカバリーステータス
    ip 文字列 IP アドレス、または IP アドレスのカンマ区切りリスト。
    センサー 文字列 ディスカバリーセンサー
    表 : 2. 返される内容
    タイプ 説明
    なし

    StartDiscovery - discoverFromSchedule(文字列 ip, ブール値 samePhase, 文字列 sensor)

    スケジュールからデバイス (基本または高度) の検出を処理します。

    表 : 3. パラメーター
    名前 タイプ 説明
    ip 文字列 IP アドレス、または IP アドレスのカンマ区切りリスト。
    samePhase ブーリアン
    センサー 文字列 ディスカバリーセンサー
    表 : 4. 返される内容
    タイプ 説明
    なし

    StartDiscovery:getCancelScript()

    キャンセルスクリプトを返します。

    表 : 5. パラメーター
    名前 タイプ 説明
    なし
    表 : 6. 返される内容
    タイプ 説明
    文字列 キャンセルスクリプト

    StartDiscovery:scheduleCancelJob()

    スケジュールでキャンセル時間が指定されている場合は、必要に応じて、ディスカバリーをキャンセルするジョブをスケジュールします。

    表 : 7. パラメーター
    名前 タイプ 説明
    なし
    表 : 8. 返される内容
    タイプ 説明
    なし

    次の例は、 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)

    指定されたスケジュールを使用して単一 IP のディスカバリーを開始し、MID サーバーや動作などの情報を取得します。

    表 : 9. パラメーター
    名前 タイプ 説明
    schedule ディスカバリースケジュール 使用するスケジュールの DiscoverySchedule インスタンス。
    ip 文字列 検出する IP アドレス。

    形式:ドット形式の文字列

    表 : 10. 返される内容
    タイプ 説明
    文字列 作成されたステータスレコードのSys_id。

    この例では、 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 ジョブ)

    スケジュール済み (または今すぐ検出する) ディスカバリーを開始するためにディスカバリースクリプトインクルードによって呼び出されます。

    表 : 11. パラメーター
    名前 タイプ 説明
    schedule GlideRecord このディスカバリーの基になるdiscovery_scheduleのインスタンス。
    ジョブ GlideRecord このディスカバリーをトリガーしたsys_triggerのインスタンス。
    表 : 12. 返される内容
    タイプ 説明
    なし