StartDiscovery – Global

Die StartDiscovery- API stellt Methoden zum Starten von Erkennungsaufträgen bereit.

Verwenden Sie diese API während der Discovery-Scan-Phase.

StartDiscovery – addAdditionalIP(String status, String ip, String sensor)

Fügt einer vorhandenen Erkennung eine IP (oder eine durch Kommas getrennte Liste von IPs) hinzu (wird von der Netzwerkerkennung verwendet).

Tabelle : 1. Parameter

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 : 2. Ergebnisse

Typ	Beschreibung
void

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

Ermöglicht die Erkennung von Geräten (Basisgeräte oder erweiterte Geräte) anhand eines Zeitplans.

Tabelle : 3. Parameter

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 : 4. Ergebnisse

Typ	Beschreibung
void

StartDiscovery – getCancelScript()

Gibt das Abbruch-Skript zurück.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 6. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Das Abbruch-Skript

StartDiscovery – scheduleCancelJob()

Wenn der Zeitplan eine Abbruchzeit angibt, plant ggf. eine Aufgabe, um die Erkennung abzubrechen.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 8. Ergebnisse

Typ	Beschreibung
void

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)

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

Tabelle : 9. Parameter

Name	Typ	Beschreibung
schedule	DiscoverySchedule	DiscoverySchedule-Instanz für den zu verwendenden Zeitplan.
ip	Zeichenfolge	Zu erkennende IP-Adresse. Format: mit Punkten formatierte Zeichenfolge

Tabelle : 10. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Sys_id des erstellten Statusdatensatzes.

In diesem Beispiel wird die startFromIP()- Methode 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)

Wird von der Discovery-Skripteinbindung aufgerufen, um eine geplante (oder sofortige) Erkennung zu starten.

Tabelle : 11. Parameter

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 : 12. Ergebnisse

Typ	Beschreibung
void