Get-FtpFileAge

EulandaXtools — Funktionsreferenz

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

VERWANDTE LINKS

Get-FtpDir

Get-FtpFileDate

Get-FtpFileSize

Get-FtpNewestFilename

Get-FtpOldestFilename

New-FtpFolder

Receive-FtpFile

Remove-FtpFile

Remove-FtpFilesOlderThan

Remove-FtpFolder

Rename-FtpFile

Rename-FtpFolder

Send-FtpFile

Test-FtpFile

Test-FtpFolder

HINWEISE