Get FTP File Age
Zuletzt geändert: 14.03.2026 05:56

Get-FtpFileAge #

ÜBERSICHT #

Ermittelt das Alter einer Datei auf einem FTP- oder FTPS-Server in Sekunden.

SYNTAX #

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

BESCHREIBUNG #

Diese Funktion fragt den Zeitstempel (LastModified) einer Datei auf einem FTP- oder FTPS-Server ab und berechnet daraus die Zeitdifferenz in Sekunden zwischen dem aktuellen Zeitpunkt und dem Änderungsdatum der Datei. Das Ergebnis ist ein Integerwert (TotalSeconds).

Unterstützt sowohl FTP als auch FTPS sowie aktiven oder passiven Modus. Die Authentifizierung kann per SecureString, Klartext oder Passwortdatei erfolgen.

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).

-RemoteFolder #

Type: string

Verzeichnis, in dem sich die Datei befindet (z. B. /upload).

-RemoteFile #

Type: string

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

AUSGABEN #

int

Sekunden seit der letzten Änderung.

BEISPIELE #

# Gibt das Alter einer Datei in Sekunden zurück
Get-FtpFileAge -Server 'ftp.example.com' -User 'admin' -PlainPassword 'secret' -RemoteFolder '/export' -RemoteFile 'report.zip'
# FTPS mit Passwortdatei und aktivem Modus
Get-FtpFileAge -Server 'ftp.example.com' -Protocol 'ftps' -ActiveMode -User 'cn' -PasswordPath 'C:\Users\cn\.eulandaconnect\pw.xml' -RemoteFolder '/data' -RemoteFile 'log.txt' -Verbose

HINWEISE #

  • Gibt 0 zurück, wenn Datei nicht existiert oder ein Fehler auftritt.
  • Unterstützt FTP und FTPS (explizit, TLS/SSL).
  • Kompatibel mit PowerShell 5.1 und 7+.