Get-FtpOldestFilename

ÜBERSICHT

Ermittelt den Namen der ältesten Datei auf einem FTP- oder FTPS-Server, optional gefiltert nach Dateimaske.

SYNTAX

Get-FtpOldestFilename [-Server] <string> [[-Protocol] <string>] [[-Port] <int>] [-ActiveMode]
    [-User] <string> [[-Password] <securestring>] [[-PlainPassword] <string>] [[-PasswordPath]
    <string>] [[-Mask] <string>] [[-RemoteFolder] <string>] [<CommonParameters>]

BESCHREIBUNG

Diese Funktion verbindet sich mit einem FTP- oder FTPS-Server und gibt den Namen der ältesten Datei im angegebenen Remote-Verzeichnis zurück. Dabei kann eine Dateimaske (z. B. `*.xml` oder `ORDERS*`) verwendet werden. Unterstützt aktiven oder passiven Modus sowie FTP und FTPS (explizit, TLS/SSL). Die Authentifizierung kann über SecureString, Klartext oder Passwortdatei erfolgen.

Sie ist das Gegenstück zu `Get-FtpNewestFilename` und wird häufig beim sequentiellen Abarbeiten von Warteschlangen (Queues) eingesetzt.

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 XML via `Export-Clixml`).

-Mask

Type: string
Default: '*'

Dateimaske zum Filtern (Standard: `*`).

-RemoteFolder

Type: string
Default: '/'

Pfad auf dem Server, z. B. `/upload` (Standard: `/`).

AUSGABEN

string

Gibt den Dateinamen der ältesten Datei zurück oder `$null`, wenn keine gefunden wurde.

BEISPIELE

# Älteste XML-Datei auf FTP-Server ermitteln
Get-FtpOldestFilename -Server 'ftp.example.com' -User 'admin' -PlainPassword 'secret' -RemoteFolder '/inbound' -Mask '*.xml'

# FTPS mit Passwortdatei und aktivem Modus
Get-FtpOldestFilename -Server 'ftp.example.com' -Protocol 'ftps' -ActiveMode -User 'cn' -PasswordPath 'C:\Users\cn\.eulandaconnect\pw.xml' -RemoteFolder '/queue' -Mask '*.zip' -Verbose

HINWEISE

Unterstützt FTP und FTPS
Kompatibel mit PowerShell 5.1 und 7+
Liefert nur Dateinamen, keine Pfade

Get-FtpOldestFilename