---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Discovery starten -- Global

# Discovery starten -- Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

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

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

## StartDiscovery -- addAdditionalIP (Zeichenfolgenstatus, Zeichenfolgen-ip, Zeichenfolgensensor) {#ariaid-title2}

Fügt einer vorhandenen Discovery eine IP (oder eine kommagetrennte Liste von IPs) hinzu (wird von der Netzwerk-Discovery 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 kommagetrennte 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 |
|-|-|
| Ungültig |   |
[Tabelle : 2. Rückgaben]

{#r_SDY-addAdditionalIP_S_S_S__table_a2v_1dv_tt}

## StartDiscovery -- discoverFromSchedule (Zeichenfolgen-ip, boolesche samePhase, Zeichenfolgensensor) {#ariaid-title3}

Verarbeitet die Discovery von Geräten (ob Standard oder erweitert) aus einem Zeitplan.
{#r_SDY-discoverFromSchedule_S_B_S__table_cq1_xdv_tt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ip | Zeichenfolge | Eine IP-Adresse oder eine kommagetrennte 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 |
|-|-|
| Ungültig |   |
[Tabelle : 4. Rückgaben]

{#r_SDY-discoverFromSchedule_S_B_S__table_dq1_xdv_tt}

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

Gibt das Abbruchskript 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 Abbruchskript |
[Tabelle : 6. Rückgaben]

{#r_SDY-getCancelScript__table_jdb_t2v_tt}

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

Wenn der Zeitplan eine Abbruchzeit angibt, plant er bei Bedarf einen Auftrag, um die Discovery abzubrechen.
{#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 |
|-|-|
| Ungültig |   |
[Tabelle : 8. Rückgaben]

{#r_SDY-scheduleCancelJob__table_tmg_l2v_tt}  
Das folgende Beispiel zeigt, wie verwendet wird ScheduleCancelJob() Methode zum Abbrechen eines aktuellen Discovery-Auftrags.

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

Startet eine Discovery für eine einzelne IP anhand des angegebenen Zeitplans, um Informationen wie MID-Server und Verhalten abzurufen.
{#r_SDY-startFromIP_DS_S__table_elc_1cv_tt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Zeitplan | DiscoverySchedule | DiscoverySchedule-Instanz für den zu verwendenden Zeitplan. |
| ip | Zeichenfolge | Zu erkennende IP-Adresse. Format: Dotformatierte 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. Rückgaben]

{#r_SDY-startFromIP_DS_S__table_flc_1cv_tt}  
In diesem Beispiel wird verwendet StartFromIP() Methode zum Abrufen des Datensatzes, 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-Zeitplan, GlideRecord-Auftrag) {#ariaid-title7}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Zeitplan | GlideRecord | Die Instanz von Discovery_schedule, auf der diese Discovery basiert. |
| job | GlideRecord | Die Instanz von sys_Trigger, die diese Discovery 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 |
|-|-|
| Ungültig |   |
[Tabelle : 12. Rückgaben]

{#r_SDY-startFromSchedule_GR_GR__table_ggm_jbv_tt}

