Send X400 Scp
Zuletzt geändert: 14.03.2026 05:56

Send-X400Scp #

ÜBERSICHT #

Startet den X400-Versand über FileWorks (FW_SI.exe) oder simuliert den Aufruf.

SYNTAX #

Send-X400Scp [-FwToolsPath] <string> [[-User] <string>] [[-Password] <string>] [[-ScpPath]
    <string>] [[-ScpFileName] <string>] [-Simulate] [[-TimeoutSeconds] <int>] [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion startet das FileWorks Script Interface (FW_SI.exe) mit einer vorhandenen SCP-Datei zur Ausführung eines X400-Transports.

Der Versand erfolgt ausschließlich auf Basis einer bereits erzeugten SCP-Datei. Die Funktion erzeugt oder verändert keine SCP-Inhalte und eignet sich daher ideal für Debugging, Wiederholungen und Supportfälle.

Wird der Parameter -Simulate verwendet, erfolgt kein Programmstart. Stattdessen wird eine vollständige, lauffähige Kommandozeile erzeugt und über Write-Verbose ausgegeben, die direkt in einer cmd.exe oder PowerShell kopiert und ausgeführt werden kann.

Falls FW_SI.exe nicht innerhalb des Timeouts beendet wird, wird der Prozess abgebrochen und ein Fehler ausgelöst.

Typischer Anwendungsfall: FileWorks zeigt beibestimmten Fehlern einen modalen Dialog (z. B. Login / Fehlermeldung), während der Server ausgeloggt ist.

Im Simulationsmodus:

  • finden keinerlei Pfadprüfungen statt
  • erfolgen keine Dateisystemzugriffe
  • werden fehlende Laufwerke oder Dateien nicht validiert

Im Produktivmodus:

  • wird geprüft, ob FW_SI.exe existiert
  • wird geprüft, ob die SCP-Datei existiert
  • wird FW_SI.exe mit korrekt gesetztem WorkingDirectory gestartet

Der Speicherort der SCP-Datei wird über zwei getrennte Parameter gesteuert:

  • ScpPath : Verzeichnis der SCP-Datei
  • ScpFileName : Name der SCP-Datei (Standard: EULANDA.scp)

PARAMETER #

-FwToolsPath #

Type: string

Verzeichnis, in dem sich FW_SI.exe befindet. Dieses Verzeichnis wird als WorkingDirectory für den Programmstart verwendet.

-User #

Type: string

Optionaler FileWorks-Benutzername. Wird nur verwendet, wenn ein lokaler FileWorks-Login erforderlich ist. Der Wert wird als /U-Parameter an FW_SI.exe übergeben.

-Password #

Type: string

Optionales Passwort zum FileWorks-Benutzer. Wird nur verwendet, wenn -User gesetzt ist. Der Wert wird als /P-Parameter an FW_SI.exe übergeben.

-ScpPath #

Type: string

Verzeichnis, in dem sich die SCP-Datei befindet. Wird im Simulationsmodus nur für die Kommandozeilenerzeugung verwendet.

-ScpFileName #

Type: string
Default: 'EULANDA.scp'

Name der SCP-Datei. Standardwert ist “EULANDA.scp”.

-Simulate #

Type: switch

Aktiviert den Simulationsmodus. Es wird kein Programm gestartet, sondern lediglich die vollständige Kommandozeile ausgegeben.

-TimeoutSeconds #

Type: int
Default: 30

Maximale Laufzeit von FW_SI.exe in Sekunden. Standard: 30 Sekunden.

AUSGABEN #

None

Die Funktion gibt keinen Rückgabewert zurück.

BEISPIELE #

# X400-Versand nur simulieren und Kommandozeile zum Debuggen anzeigen
Send-X400Scp `
  -FwToolsPath 'C:\FileWorks\Tools' `
  -ScpPath 'C:\EDI\SCP' `
  -Simulate `
  -Verbose

# X400-Versand produktiv ausführen
Send-X400Scp `
  -FwToolsPath 'C:\FileWorks\Tools' `
  -ScpPath 'C:\EDI\SCP'

# X400-Versand mit User und Password
Send-X400Scp `
  -User Mike `
  -Password geheim `
  -FwToolsPath '.\' `
  -ScpPath '.\' `
  -Verbose