StartDiscovery : global

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 2 minutes de lecture

    • L’include de script StartDiscovery fournit des méthodes pour démarrer des tâches de découverte.

    Utilisez cet include de script pendant la phase d’analyse de découverte.

    StartDiscovery : addAdditionalIP (état de la chaîne, adresse IP de la chaîne, capteur de chaîne)

    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).

    Tableau 1. Paramètres
    Nom Type Description
    état Chaîne 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 2. Renvoie
    Type Description
    nul

    StartDiscovery : discoverFromSchedule(adresse IP de chaîne, booléen samePhase, capteur de chaîne)

    Gère la découverte des appareils (de base ou avancés) à partir d’une planification.

    Tableau 3. Paramètres
    Nom Type Description
    ip Chaîne Une adresse IP ou une liste d’adresses IP séparées par des virgules.
    samePhase Booléen
    capteur Chaîne Le capteur de découverte
    Tableau 4. Renvoie
    Type Description
    nul

    StartDiscovery : getCancelScript()

    Retourne le script d’annulation.

    Tableau 5. Paramètres
    Nom Type Description
    Aucun
    Tableau 6. Renvoie
    Type Description
    Chaîne Le script d’annulation

    StartDiscovery : scheduleCancelJob()

    Si la planification spécifie une heure d’annulation, si nécessaire, planifie une tâche pour annuler la détection.

    Tableau 7. Paramètres
    Nom Type Description
    Aucun
    Tableau 8. Renvoie
    Type Description
    nul

    L’exemple suivant montre comment utiliser la méthode scheduleCancelJob() pour annuler une tâche de découverte 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(calendrier DiscoverySchedule, chaîne IP)

    Démarre une découverte pour une seule adresse IP à l’aide de la planification spécifiée afin d’obtenir des informations telles que les MID Servers et les comportements.

    Tableau 9. Paramètres
    Nom Type Description
    schedule Calendrier de découverte Instance DiscoverySchedule que le calendrier utilisera.
    ip Chaîne Adresse IP à détecter.

    Format : chaîne au format point
    Tableau 10. Renvoie
    Type Description
    Chaîne Sys_id de l’enregistrement d’état créé.

    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)

    Invoqué par l’include de script de découverte pour lancer une découverte planifiée (ou détecter maintenant).

    Tableau 11. Paramètres
    Nom Type Description
    schedule GlideRecord Instance de discovery_schedule sur laquelle cette découverte est basée.
    tâche GlideRecord L’instance de sys_trigger qui a déclenché cette découverte.
    Tableau 12. Renvoie
    Type Description
    nul