Pathfinder über die Kommandozeile bedienen
Einige Funktionen von Pathfinder können über die Kommandozeile ausgeführt und so automatisiert werden.
Das umfasst beispielsweise Datenbank-Backups oder automatisierte Updates.
Vorbedingungen
Erstellen Sie zunächst einen API-Schlüssel. Er kann bequem zur Authentifizierung ohne Benutzername und Passwort verwendet werden.
Unterstütze Typen
Name | Beschreibung |
|---|---|
location | Standort |
building | Gebäude |
floor | Etage |
room | Raum |
component | Komponente |
port | Port |
networkpath | Netzweg |
report | Report |
cable | Kabel |
networkmap | Netzwerkplan |
workorder | Arbeitsauftrag |
workorderitem | Arbeitsschritt |
subnet | Subnetz |
Überblick über unterstützte Befehle
Befehl | unterstützte Typen | Beschreibung | Beispiele |
|---|---|---|---|
open | alle | Öffnet das angegebene Objekt in Pathfinder. | pathfinder://open?type=networkpath&id=24 pathfinder://open?type=workorder&id=5 |
search | location, building, floor, room, component, port, networkpath, cable, subnet, workorder | Startet eine Suche nach dem angegebenen Wert. Durch Angabe eines Typs kann die Suche eingegrenzt werden. | pathfinder://search?value='Switch' pathfinder://search?type=component&value='Switch' |
export | location, building, floor, room, component (rack), networkpath, networkmap, workorder, report | Exportiert einen Report oder eine Ansicht. | pathfinder://export?type=workorder&id=4&out='C:\path\to\file' pathfinder://export?type=report&id=2&out='C:\path\to\file' |
import | Importiert die Komponentendefinitionen mit den angegebenen IDs aus dem Onlinekatalog. | pathfinder://import?guid=id1,id2,id3 | |
process/cancel | workorder, workorderitem | Führt einen Arbeitsauftrag oder -schritt aus oder bricht ihn ab. | pathfinder://process?type=workorder&id=4 pathfinder://cancel?type=workorderitem&id=6 |
scan | subnet | Scannt das angegebene Subnetz. | pathfinder://scan?type=subnet&id=11 |
upgrade | Überprüft, ob Updates zur Verfügung stehen, und führt sie gegebenenfalls durch. | pathfinder://upgrade | |
backupdb | Erstellt ein lokales Datenbank-Backup im data-Ordner. Dateibasierte Datenbanken werden nicht unterstützt. | pathfinder://backupdb?out='pathfinder123.db' | |
copydb | Kopiert die Quelldatenbank in die Zieldatenbank. Die Quelle kann nicht dateibasiert sein, wenn sie gerade genutzt wird. | pathfinder://copydb?source=1&destination=2 | |
dbschemaupdate | Führt Datenbank-Updates auf der angegebenen Datenbank aus. | pathfinder://dbschemaupdate?source=0 |
Optionale Parameter
Parameter | Beschreibung | Beispiel |
|---|---|---|
token=<token> | Fügen Sie einen API-Schlüssel für die automatische Anmeldung hinzu. | pathfinder://open?type=location&id=6&token=<token> |
exitWhenDone | Pathfinder wird nach Ausführung des Befehls beendet. | pathfinder://upgrade&exitWhenDone |
Befehle ausführen
Es gibt mehrere Wege, Befehle auszuführen:
durch das Öffnen eines Pathfinder-Links im Browser.
durch das Ausführen nach dem Schema
pathfinder.exe -link=<your action>in der Windows Kommandozeile.durch das Ausführen nach dem Schema
start <your pathfinder-link>in der Windows Powershell.
Beispiel unter Verwendung der Windows Kommandozeile
pathfinder.exe -link="pathfinder://open?type=location&id=6&token=<token>"Beispiel unter Verwendung der PowerShell
start "pathfinder://backupdb?out='pathfinder123.db'&token=<token>"
Start-Sleep -s 30
start "pathfinder://export?type=report&id=2&out='C:\path\to\file'"
Start-Sleep -s 1
start "pathfinder://upgrade&exitWhenDone"
Wir empfehlen zwischen den Befehlen einige Sekunden zu warten, um die korrekte Ausführungsreihenfolge zu gewährleisten. Insbesondere nach dem Start und vor dem Beenden von Pathfinder.
Beispiel für den Import einiger Komponentendefinitionen
POWERSHELL
| 19" Rack 42U, 800x1200 (Server) |
Beispiel für ein Backup der Standarddatenbank
start pathfinder.exe -link="pathfinder://backupdb?out='pathfinder_backup'&token=<my_token>&exitWhenDone"