StartDiscovery : global

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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)

    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
    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 2. Renvoie
    Type Description
    nul

    StartDiscovery : discoverFromSchedule(String ip, Boolean samePhase, String sensor)

    Gère la détection des appareils (qu’ils soient de base ou avancés) à partir d’un calendrier.

    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 (en anglais seulement) Booléen
    capteur Chaîne Le capteur de découverte
    Tableau 4. Renvoie
    Type Description
    nul

    StartDiscovery : getCancelScript()

    Renvoie le script cancel.

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

    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.

    Tableau 9. Paramètres
    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 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 Discovery pour lancer une détection planifiée (ou une détection maintenant).

    Tableau 11. Paramètres
    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 12. Renvoie
    Type Description
    nul