Test-FtpFolder #

ÜBERSICHT #

Prüft, ob ein Verzeichnis auf einem FTP- oder FTPS-Server existiert.

SYNTAX #

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

BESCHREIBUNG #

Diese Funktion stellt eine Verbindung zu einem FTP- oder FTPS-Server her und überprüft, ob ein bestimmtes Remote-Verzeichnis existiert. Unterstützt Klartext-, SecureString- oder dateibasierte Passwörter und kann sowohl im passiven als auch im aktiven Modus betrieben werden.

Bei erfolgreicher Abfrage gibt die Funktion $true zurück, 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 Clixml via Export-Clixml).

-RemoteFolder #

Type: string

Pfad des zu prüfenden Verzeichnisses auf dem Server, z. B. /upload oder /data/in.

AUSGABEN #

bool

Gibt $true zurück, wenn das Verzeichnis existiert, sonst $false.

BEISPIELE #

# Prüft, ob das Verzeichnis '/in' auf einem FTP-Server existiert
Test-FtpFolder -Server 'ftp.example.com' -User 'admin' -PlainPassword 'secret' -RemoteFolder '/in'

# FTPS-Variante mit Passwortdatei
Test-FtpFolder -Server 'ftp.example.com' -Protocol 'ftps' -User 'cn' -PasswordPath 'C:\Users\cn\.eulandaconnect\pw.xml' -RemoteFolder '/export' -Verbose

HINWEISE #

Unterstützt FTP und FTPS
Verwendet HEAD-ähnliche Anfrage per PrintWorkingDirectory/ListDirectory
Kompatibel mit PowerShell 5.1 und 7+