Receive-FtpFile

EulandaXtools — Funktionsreferenz

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'

VERWANDTE LINKS

Get-FtpDir

Get-FtpFileAge

Get-FtpFileDate

Get-FtpFileSize

Get-FtpNewestFilename

Get-FtpOldestFilename

New-FtpFolder

Remove-FtpFile

Remove-FtpFilesOlderThan

Remove-FtpFolder

Rename-FtpFile

Rename-FtpFolder

Send-FtpFile

Test-FtpFile

Test-FtpFolder

HINWEISE