Invoke-SftpUpload

ÜBERSICHT

Lädt Dateien über SFTP für einen definierten Partner hoch und führt lokale Nachbearbeitungen aus.

SYNTAX

Invoke-SftpUpload [-Partner] <hashtable> [[-TechnicalEmails] <string>] [-PartnerName] <string>
    [-DataPath] <string> [[-LogFile] <string>]

BESCHREIBUNG

Die Funktion 'Invoke-SftpUpload' führt einen SFTP-Upload durch, basierend auf den Angaben eines Partnerobjekts. Es werden alle passenden Dateien aus einem lokalen Verzeichnis gemäß definierter Dateimaske ausgewählt, hochgeladen und optional anschließend gelöscht, verschoben oder umbenannt (postLocalAction). Der Upload erfolgt entweder durch direkte Übergabe des Partnerobjekts oder über den Namen in einer JSON-Datenbank. Die Funktion protokolliert alle Aktionen, zählt Erfolge/Fehler, und gibt ein strukturiertes Ergebnis zurück.

PARAMETER

-Partner

Type: hashtable

Ein Hashtable mit allen Verbindungs- und Konfigurationsdaten des Partners (Pflicht bei ParameterSet 'ByPartner').

-TechnicalEmails

Type: string
Default: $null

Optionale Empfänger für technische Fehlermeldungen (z. B. bei Uploadfehlern).

-PartnerName

Type: string

Der Name des Partners, dessen Konfiguration aus der JSON-Datenbank geladen wird (Pflicht bei ParameterSet 'ByName').

-DataPath

Type: string

Pfad zur JSON-Datenbank, aus der Partnerinformationen gelesen werden (Pflicht bei ParameterSet 'ByName').

-LogFile

Type: string
Default: $null

Optionaler Pfad zu einer Logdatei, in die Fehlermeldungen zusätzlich geschrieben werden sollen.

AUSGABEN

Ein [pscustomobject] mit folgenden Eigenschaften:

• PartnerName - Success (bool) - Total (Anzahl gefundener Dateien) - Succeeded (Anzahl erfolgreicher Uploads) - Failed (Anzahl Fehler) - Skipped (Anzahl übersprungener Dateien) - Errors (Liste von Fehlermeldungen) - TransferedFiles (Liste erfolgreich hochgeladener Dateinamen)

BEISPIELE

# Upload via Partnerobjekt
$partner = @{ partnerName = 'KundeX'; connection = @{ sftp = @{ server = 'host'; user = 'xyz' } }; localFolders = @{ uploadPath = 'C:\Daten' } }
Invoke-SftpUpload -Partner $partner

# Upload per Partnername (aus JSON-Datenbank)
Invoke-SftpUpload -PartnerName 'KundeX' -DataPath 'C:\Config\partner.json'