Test-FtpFile #

ÜBERSICHT #

Prüft, ob eine Datei auf einem FTP- oder FTPS-Server existiert.

SYNTAX #

Test-FtpFile [-Server] <string> [[-Protocol] <string>] [[-Port] <int>] [-ActiveMode] [-User]
    <string> [[-Password] <securestring>] [[-PlainPassword] <string>] [[-PasswordPath] <string>]
    [[-RemoteFolder] <string>] [-RemoteFile] <string> [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion stellt eine Verbindung zu einem FTP- oder FTPS-Server her und prüft, ob eine bestimmte Datei im angegebenen Remote-Verzeichnis vorhanden ist. Die Authentifizierung kann über SecureString, Klartext oder Passwortdatei erfolgen. Der Rückgabewert ist $true, wenn die Datei existiert, andernfalls $false.

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.

-User #

Type: string

Benutzername zur Anmeldung.

-Password #

Type: securestring

Passwort als SecureString.

-PlainPassword #

Type: string

Passwort im Klartext. Wird intern in SecureString konvertiert.

-PasswordPath #

Type: string

Pfad zu einer Datei, die das Passwort enthält (Text oder SecureString XML via Export-Clixml).

-RemoteFolder #

Type: string

Pfad des Verzeichnisses, in dem die Datei liegt, z. B. /upload.

-RemoteFile #

Type: string

Dateiname, der geprüft werden soll, z. B. data.csv.

AUSGABEN #

bool

Gibt $true zurück, wenn die Datei existiert, sonst $false.

BEISPIELE #

# Prüft, ob 'data.csv' im Verzeichnis '/upload' existiert
Test-FtpFile -Server 'ftp.example.com' -User 'admin' -PlainPassword 'secret' -RemoteFolder '/upload' -RemoteFile 'data.csv'

# Prüft Datei über FTPS und Passwortdatei
Test-FtpFile -Server 'ftp.example.com' -Protocol 'ftps' -User 'cn' -PasswordPath 'C:\Users\cn\.eulandaconnect\pw.xml' -RemoteFolder '/out' -RemoteFile 'log.zip' -Verbose

HINWEISE #

Verwendet FTP-Befehl GetFileSize, um Existenz zu prüfen.
Unterstützt FTP und FTPS (explizit, TLS/SSL).
Kompatibel mit PowerShell 5.1 und 7+.