tracetronic: RemoteCommand

Bisheriger/interner Bezeichner: REMOTE-COMMAND

Herstellerinformationen

Hersteller	Webseite	Produktname	Version
tracetronic GmbH	https://www.tracetronic.de	RemoteCommand

Kategorien

MDL 🛈	APL 🛈	BAN 🛈	BMA 🛈	SVC 🛈	DGN 🛈	FIU 🛈	EES 🛈	FCT 🛈	DBG 🛈	IMG 🛈	AUDIO 🛈	ENVSIM 🛈	ENVCOM 🛈

Plattform

Betriebssystem	Unterstützung
Windows	✓
Linux

Besonderheiten

REMOTE-COMMAND ermöglicht Systemzugriffe auf dem Host von Tool Server. Über dieses Tool können beispielsweise Dateien vom oder zum Toolhost übertragen oder Anwendungen ausgeführt werden.

Aus Sicherheitsgründen kann REMOTE-COMMAND nur bei gesicherter Kommunikation mit ecu.test Tool Server (SSL-Client-Zertifikat) oder lokal verwendet werden.

Eigenschaften 🛈

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Timeout für Toolzugriffe ❲in Sek.❳		‚600‘		string	Zeit nach der eine Anfrage an das Tool abgebrochen wird.

Jobs 🛈

CallCDll

Ruft eine cdecl-Funktion in einer DLL auf

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
args		[]		object	Argumentliste
dllFilePath				string	Vollständiger Pfad zur DLL
functionName				string	Name der aufzurufenden Funktion

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
CallResult				object	Ergebnis des Funktionsaufrufs

CallWinDll

Ruft eine stdcall-Funktion in einer DLL auf

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
args		[]		object	Argumentliste
dllFilePath				string	Vollständiger Pfad zur DLL
functionName				string	Name der aufzurufenden Funktion

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
CallResult				object	Ergebnis des Funktionsaufrufs

DeleteFile

Löscht eine Datei auf dem Remote-Rechner

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
remotepath				string	Remote-Dateiname mit Pfad

DeleteFolder

Löscht einen Ordner auf dem Remote-Rechner

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
recursive		False	[False, True]	bool	nicht-leere Ordner samt Inhalt löschen
remotepath				string	Remote-Pfad

DownloadDirRecursive

Kopiert ein Unterverzeichnis vom Remote-Rechner

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
localpath				string	Lokaler Ordner
remotepath				string	Remote-Ordner

DownloadFile

Kopiert eine Datei vom Remote-Rechner

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
localpath				string	Lokale Datei
remotepath				string	Remote-Datei

ExecuteCommand

Führt einen Befehl aus

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
args		[]		object	Argumentliste incl. Programmname
creationflags		0		int	creationflags
cwd				string	Ausführen in Verzeichnis
delay		0		int	Wartezeit vor Ergebnisabfrage bei asynchroner Ausführung
encoding		‚utf-8‘		string	Zeichensatz zur Interpretation der gelesenen Zeichenfolge. None liefert nicht interpretierte bytes.
env				object	Alternative Umgebungsvariablen
executeInShell		False	[False, True]	bool	In einer Shell (cmd.exe) ausführen
inputtext				string	An die Standardeingabe zu sendender Text
startupinfo				object	StartupInfo
sync		True	[False, True]	bool	Synchrone Ausführung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
ProcessResult				object	Tupel (Rückgabewert, Inhalt Standardausgabe, Inhalt Standardfehlerausgabe)

HttpGet

Ruft ein Dokument per HTTP oder HTTPs ab

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
url				string	URL

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
httpDocument				string	Inhalt des abgerufenen Dokuments

ListDir

Listet ein Verzeichnis rekursiv auf

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
directory				string	Das aufzulistende Verzeichnis

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
directoryContent				object	Verzeichnisbaum - jeder Eintrag als Tripel (Name, Pfad, isDir)

Ping

Pingt den angegebenen Host an

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
ipAddressOrHostName				string	IP-Adresse oder Hostname

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
pingResult				int	2 wenn Ping erfolgreich

ReadRegistry

Liest einen Wert aus der Registry

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
hKey		18446744071562067970		int	HKEY-Konstante aus win32con
subKey				string	Unterschlüssel
valueName				string	Name des Werts

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
value				object	Wert aus Registry

UploadDirRecursive

Kopiert ein Unterverzeichnis auf den Remote-Rechner

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
localpath				string	Lokaler Ordner
remotepath				string	Remote-Ordner

UploadFile

Kopiert eine Datei auf den Remote-Rechner

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
localpath				string	Lokale Datei
remotepath				string	Remote-Datei

2025-12-05