Send FTP File
Zuletzt geändert: 14.03.2026 05:56

Send-FtpFile #

ÜBERSICHT #

Lädt eine lokale Datei auf einen FTP- oder FTPS-Server hoch.

SYNTAX #

Send-FtpFile [-Server] <string> [[-Protocol] <string>] [[-Port] <int>] [-ActiveMode] [[-ResumeAge]
    <int>] [[-ResumeRetries] <int>] [-User] <string> [[-Password] <securestring>] [[-PlainPassword]
    <string>] [[-PasswordPath] <string>] [-RemoteFolder] <string> [[-RemoteFile] <string>]
    [-LocalFolder] <string> [-LocalFile] <string> [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion verbindet sich mit einem FTP- oder FTPS-Server und überträgt eine lokale Datei in ein angegebenes Remote-Verzeichnis. Wenn die Datei bereits existiert, kann der Upload automatisch fortgesetzt werden (Resume), sofern sie nicht älter als die durch -ResumeAge angegebene Zeit ist.

Authentifizierung kann über SecureString, Klartext oder eine Passwortdatei erfolgen. Unterstützt aktiven oder passiven Modus und optional SSL-Verschlüsselung bei FTPS.

Unterfunktionen wie Test-FtpFile, Remove-FtpFile, Get-FtpFileAge, Get-FtpFileSize und New-FtpFolder sollten die gleichen Passwortparameter (PlainPassword, PasswordPath) unterstützen.

PARAMETER #

-Server #

Type: string

Hostname oder IP-Adresse des FTP-Servers.

-Protocol #

Type: string
Default: 'ftp'

Gibt das Protokoll an (ftp oder ftps). Standard: ftp.

-Port #

Type: int
Default: 21

Portnummer des Servers. Standard: 21.

-ActiveMode #

Type: switch

Wenn gesetzt, wird der aktive FTP-Modus verwendet. Standard ist passiv.

-ResumeAge #

Type: int
Default: 60 * 60 * 3

Maximales Alter (in Sekunden) einer vorhandenen Datei, für die ein Resume erlaubt ist. Standard: 3 Stunden (10800 Sekunden).

-ResumeRetries #

Type: int
Default: 7

Maximale Anzahl der Wiederholungsversuche bei fehlerhaftem Upload. Standard: 7.

-User #

Type: string

Benutzername zur Anmeldung.

-Password #

Type: securestring

Passwort als SecureString.

-PlainPassword #

Type: string

Passwort im Klartext. Wird automatisch in einen SecureString konvertiert.

-PasswordPath #

Type: string

Pfad zu einer Datei, die das Passwort enthält (Text oder Clixml).

-RemoteFolder #

Type: string

Zielverzeichnis auf dem Server, z. B. /upload.

-RemoteFile #

Type: string

Ziel-Dateiname auf dem Server. Wenn nicht angegeben, wird der Name der lokalen Datei verwendet.

-LocalFolder #

Type: string

Lokaler Ordner, in dem sich die zu sendende Datei befindet.

-LocalFile #

Type: string

Name der lokalen Datei, die übertragen werden soll.

AUSGABEN #

None (führt Upload durch)

BEISPIELE #

# Lädt eine Datei per FTP hoch
Send-FtpFile -Server 'ftp.example.com' -User 'admin' -PlainPassword 'secret' -RemoteFolder '/upload' -LocalFolder 'C:\temp' -LocalFile 'data.csv'

# Lädt Datei per FTPS hoch, Passwort aus Datei
Send-FtpFile -Server 'ftp.example.com' -Protocol 'ftps' -User 'cn' -PasswordPath 'C:\Users\cn\.eulandaconnect\pw.xml' -RemoteFolder '/in' -LocalFolder 'C:\files' -LocalFile 'report.zip' -Verbose

HINWEISE #

  • Unterstützt FTP und FTPS
  • Unterstützt Resume-Uploads
  • Erstellt Remote-Verzeichnisse bei Bedarf automatisch
  • Kompatibel mit PowerShell 5.1 und 7+