---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# StartDiscovery : global

# StartDiscovery : global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

L'include de script StartDiscovery fournit des méthodes pour démarrer les tâches de détection.

Utilisez cet include de script pendant la phase d'analyse de détection.

## StartDiscovery : addAdditionalIP(état de la chaîne, chaîne ip, capteur de chaîne) {#ariaid-title2}

Ajoute une adresse IP (ou une liste d'adresses IP séparées par des virgules) à une découverte existante (utilisée par la découverte de réseaux).
{#r_SDY-addAdditionalIP_S_S_S__table_zdv_1dv_tt__entry__3}

| Nom | Type | Description |
|-|-|-|
| statut | Chaîne | Le statut de découverte |
| ip | Chaîne | Une adresse IP ou une liste d'adresses IP séparées par des virgules. |
| capteur | Chaîne | Le capteur de découverte |
[Tableau 1. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 2. Renvoie]

{#r_SDY-addAdditionalIP_S_S_S__table_a2v_1dv_tt}

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

Gère la détection des appareils (qu'ils soient de base ou avancés) à partir d'un calendrier.
{#r_SDY-discoverFromSchedule_S_B_S__table_cq1_xdv_tt__entry__3}

| Nom | Type | Description |
|-|-|-|
| ip | Chaîne | Une adresse IP ou une liste d'adresses IP séparées par des virgules. |
| samePhase (en anglais seulement) | Booléen |   |
| capteur | Chaîne | Le capteur de découverte |
[Tableau 3. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 4. Renvoie]

{#r_SDY-discoverFromSchedule_S_B_S__table_dq1_xdv_tt}

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

Renvoie le script cancel.
{#r_SDY-getCancelScript__table_idb_t2v_tt__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 5. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Le script d'annulation |
[Tableau 6. Renvoie]

{#r_SDY-getCancelScript__table_jdb_t2v_tt}

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

Si la planification spécifie une heure d'annulation, si nécessaire, planifie une tâche pour annuler la détection.
{#r_SDY-scheduleCancelJob__table_smg_l2v_tt__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 7. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 8. Renvoie]

{#r_SDY-scheduleCancelJob__table_tmg_l2v_tt}  
L'exemple suivant montre comment utiliser la méthode scheduleCancelJob() pour annuler une tâche de détection en cours.

    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

Sortie :

    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}

Démarre une détection pour une seule adresse IP à l'aide du calendrier spécifié pour obtenir des informations telles que les MID Servers et les comportements.
{#r_SDY-startFromIP_DS_S__table_elc_1cv_tt__entry__3}

| Nom | Type | Description |
|-|-|-|
| schedule | Calendrier de découverte | Instance DiscoverySchedule du calendrier à utiliser. |
| ip | Chaîne | Adresse IP à détecter. Format : chaîne formatée par points |
[Tableau 9. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Sys_id de l'enregistrement d'état créé. |
[Tableau 10. Renvoie]

{#r_SDY-startFromIP_DS_S__table_flc_1cv_tt}  
Cet exemple utilise la méthode startFromIP() pour obtenir l'enregistrement qui contient les informations de détection.

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

Sortie :

    9d3c1197c611228701cd1d94bc32d76d

## StartDiscovery : startFromSchedule (calendrier GlideRecord, tâche GlideRecord) {#ariaid-title7}

Invoqué par l'include de script Discovery pour lancer une détection planifiée (ou une détection maintenant).
{#r_SDY-startFromSchedule_GR_GR__table_fgm_jbv_tt__entry__3}

| Nom | Type | Description |
|-|-|-|
| schedule | GlideRecord | L'instance de discovery_schedule sur laquelle cette détection est basée. |
| tâche | GlideRecord | L'instance de sys_trigger qui a déclenché cette découverte. |
[Tableau 11. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 12. Renvoie]

{#r_SDY-startFromSchedule_GR_GR__table_ggm_jbv_tt}