Receive-FtpFile #

ÜBERSICHT #

Lädt eine Datei von einem FTP- oder FTPS-Server herunter.

SYNTAX #

Receive-FtpFile [-Server] <string> [[-Protocol] <string>] [[-Port] <int>] [-ActiveMode]
    [[-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 lädt eine angegebene Datei aus einem Remote-Verzeichnis herunter. Die Authentifizierung kann über SecureString, Klartext oder eine Passwortdatei erfolgen. Der Download erfolgt binär und erstellt den lokalen Zielordner automatisch, falls dieser nicht existiert.

Der Download wird bei Fehlern bis zu einer festgelegten Anzahl von Wiederholungsversuchen erneut gestartet (-ResumeRetries).

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

Schaltet in den aktiven Modus (Standard ist passiv).

-ResumeRetries #

Type: int
Default: 7

Anzahl der Wiederholungsversuche bei fehlerhaftem Download. Standard: 7.

-User #

Type: string

Benutzername zur Anmeldung.

-Password #

Type: securestring

Passwort als SecureString.

-PlainPassword #

Type: string

Passwort im Klartext. Wird automatisch in SecureString konvertiert.

-PasswordPath #

Type: string

Pfad zu einer Passwortdatei. Unterstützt sowohl Text- als auch XML-SecureString-Dateien (z. B. via Export-Clixml erstellt).

-RemoteFolder #

Type: string

Pfad des Verzeichnisses auf dem Server, z. B. /upload oder /.

-RemoteFile #

Type: string

Dateiname auf dem Server (z. B. report.csv).

-LocalFolder #

Type: string

Lokaler Zielordner, in den die Datei gespeichert werden soll.

-LocalFile #

Type: string

Lokaler Zieldateiname. Wenn nicht angegeben, wird der gleiche Name wie RemoteFile verwendet.

AUSGABEN #

None.

(Erzeugt eine Datei auf dem lokalen Dateisystem.)

BEISPIELE #

# Lädt eine Datei aus /export herunter und speichert sie lokal.
Receive-FtpFile -Server 'ftp.example.com' -User 'admin' -PlainPassword 'secret' -RemoteFolder '/export' -RemoteFile 'data.csv' -LocalFolder 'C:\temp'

# Lädt eine Datei per FTPS mit Passwort aus XML-Datei.
Receive-FtpFile -Server 'ftp.example.com' -Protocol 'ftps' -User 'cn' -PasswordPath 'C:\Users\cn\.eulandaconnect\pw.xml' -RemoteFolder '/out' -RemoteFile 'log.zip' -LocalFolder 'D:\Import'

HINWEISE #

Unterstützt FTP und FTPS (explizit)
Erstellt lokale Zielordner automatisch
Kompatibel mit PowerShell 5.1 und 7+