---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# StartDiscovery -- Global

# StartDiscovery -- Global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Die StartDiscovery-Skripteinbindung stellt Methoden zum Starten von Discovery-Aufträgen bereit.

Verwenden Sie diese Skripteinbindung während der Discovery-Scanphase.

## StartDiscovery -- addAdditionalIP(String status, String ip, String sensor) {#ariaid-title2}

Fügt einer vorhandenen Erkennung eine IP (oder eine durch Kommas getrennte Liste von IPs) hinzu (wird von der Netzwerkerkennung verwendet).
{#r_SDY-addAdditionalIP_S_S_S__table_zdv_1dv_tt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Status | Zeichenfolge | Der Discovery-Status |
| ip | Zeichenfolge | Eine IP-Adresse oder eine durch Kommas getrennte Liste von IP-Adressen. |
| sensor | Zeichenfolge | Der Discovery-Sensor |
[Tabelle : 1. Parameter]

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

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 2. Ergebnisse]

{#r_SDY-addAdditionalIP_S_S_S__table_a2v_1dv_tt}

## StartDiscovery -- discoverFromSchedule(String ip, Boolean samePhase, String sensor) {#ariaid-title3}

Ermöglicht die Erkennung von Geräten (Basisgeräte oder erweiterte Geräte) anhand eines Zeitplans.
{#r_SDY-discoverFromSchedule_S_B_S__table_cq1_xdv_tt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ip | Zeichenfolge | Eine IP-Adresse oder eine durch Kommas getrennte Liste von IP-Adressen. |
| samePhase | Boolean |   |
| sensor | Zeichenfolge | Der Discovery-Sensor |
[Tabelle : 3. Parameter]

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

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 4. Ergebnisse]

{#r_SDY-discoverFromSchedule_S_B_S__table_dq1_xdv_tt}

## StartDiscovery -- getCancelScript() {#ariaid-title4}

Gibt das Abbruch-Skript zurück.
{#r_SDY-getCancelScript__table_idb_t2v_tt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 5. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Das Abbruch-Skript |
[Tabelle : 6. Ergebnisse]

{#r_SDY-getCancelScript__table_jdb_t2v_tt}

## StartDiscovery -- scheduleCancelJob() {#ariaid-title5}

Wenn im Zeitplan eine Abbruchzeit angegeben ist, plant ggf. einen Auftrag zum Abbrechen der Discovery.
{#r_SDY-scheduleCancelJob__table_smg_l2v_tt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 7. Parameter]

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

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 8. Ergebnisse]

{#r_SDY-scheduleCancelJob__table_tmg_l2v_tt}  
Das folgende Beispiel zeigt, wie Sie mit der scheduleCancelJob()- Methode einen aktuellen Discovery-Auftrag abbrechen.

    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

Ausgabe:

    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, String ip) {#ariaid-title6}

Startet eine Erkennung für eine einzelne IP mit dem angegebenen Zeitplan, um Informationen wie MID-Server und Verhalten abzurufen.
{#r_SDY-startFromIP_DS_S__table_elc_1cv_tt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| schedule | DiscoverySchedule | DiscoverySchedule-Instanz für den zu verwendenden Zeitplan. |
| ip | Zeichenfolge | Zu erkennende IP-Adresse. Format: punktformatierte Zeichenfolge |
[Tabelle : 9. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Sys_id des erstellten Statusdatensatzes. |
[Tabelle : 10. Ergebnisse]

{#r_SDY-startFromIP_DS_S__table_flc_1cv_tt}  
In diesem Beispiel wird die Methode startFromIP() verwendet, um den Datensatz abzurufen, der die Erkennungsinformationen enthält.

    // 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);

Ausgabe:

    9d3c1197c611228701cd1d94bc32d76d

## StartDiscovery -- startFromSchedule(GlideRecord schedule, GlideRecord job) {#ariaid-title7}

Wird von der Discovery-Skripteinbindung aufgerufen, um eine geplante (oder sofortige) Erkennung zu starten.
{#r_SDY-startFromSchedule_GR_GR__table_fgm_jbv_tt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| schedule | GlideRecord | Die Instanz von discovery_schedule, auf der diese Erkennung basiert. |
| job | GlideRecord | Die Instanz von sys_trigger, die diese Erkennung ausgelöst hat. |
[Tabelle : 11. Parameter]

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

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 12. Ergebnisse]

{#r_SDY-startFromSchedule_GR_GR__table_ggm_jbv_tt}