Send-SftpFile #

ÜBERSICHT #

Lädt eine Datei auf einen entfernten SFTP-Server hoch.

SYNTAX #

Send-SftpFile [-Server] <string> [[-Port] <int>] [[-Certificate] <string>] [-User] <string>
    [[-Password] <securestring>] [[-PlainPassword] <string>] [[-PasswordPath] <string>]
    [[-RemoteFolder] <string>] [[-RemoteFile] <string>] [[-TempExtension] <string>] [[-LocalFolder]
    <string>] [-LocalFile] <string> [<CommonParameters>]

BESCHREIBUNG #

Sendet eine lokale Datei via SFTP an einen Remote-Server. Unterstützt Passwort- oder zertifikatsbasierte Authentifizierung. Existiert das Zielverzeichnis auf dem Server nicht, wird es automatisch rekursiv angelegt.

Wenn sich lokaler und Remote-Dateiname unterscheiden, wird intern ein temporärer Ordner verwendet, da POSH-SSH gleiche Datei-Namen voraussetzt.

Mit -TempExtension läuft die Übertragung ZWEISTUFIG: die Datei geht zuerst unter einem Zwischennamen (Zielname plus Endung, z.B. ‘bestellung.edi.tmp’) auf den Server und wird erst nach vollständiger Übertragung auf den Zielnamen umbenannt. Mehrere Gegenstellen verlangen genau das, weil ihre Abholung sonst eine halb geschriebene Datei aufgreift; das Umbenennen ist auf dem Server ein Vorgang ohne Zwischenzustand. Ohne den Parameter bleibt es beim direkten Upload unter dem Zielnamen (Bestandsverhalten).

PARAMETER #

-Server #

Type: string

Hostname oder IP-Adresse des SFTP-Servers.

-Port #

Type: int
Default: 22

TCP-Port (Standard: 22).

-Certificate #

Type: string

Pfad zur Privatschlüsseldatei (*.pem).

-User #

Type: string

Benutzername am SFTP-Server.

-Password #

Type: securestring

SecureString-Passwort (ParameterSet ‘secure’).

-PlainPassword #

Type: string

Klartext-Passwort (ParameterSet ‘plain’).

-PasswordPath #

Type: string

Pfad zu einer Passwort-Datei (ParameterSet ‘file’).

-LocalFolder #

Type: string

Lokales Verzeichnis der Datei. Standard: aktuelles Verzeichnis.

-LocalFile #

Type: string

Lokaler Dateiname.

-RemoteFolder #

Type: string
Default: ""

Zielverzeichnis auf SFTP-Server. Standard: Benutzer-Home-Verzeichnis.

-RemoteFile #

Type: string

Optionaler Ziel-Dateiname (Standard: wie lokale Datei).

-TempExtension #

Type: string

Endung des Zwischennamens für den zweistufigen Upload (z.B. ‘.tmp’ oder ’tmp’ - der Punkt wird ergänzt). Leer = direkter Upload.

AUSGABEN #

bool

True bei Erfolg, sonst False.

HINWEISE #

Benötigt das Modul POSH-SSH. Installation: Install-Module -Name POSH-SSH -Repository PSGallery
Intern geöffnete SFTP-Sitzungen werden automatisch nach Beendigung dieser Funktion geschlossen.