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