Get-SftpFileAge #

ÜBERSICHT #

Ermittelt das Dateialter einer Datei auf einem SFTP-Server.

SYNTAX #

Get-SftpFileAge [-Server] <string> [[-Port] <int>] [[-Certificate] <string>] [-User] <string>
    [[-Password] <securestring>] [[-PlainPassword] <string>] [[-PasswordPath] <string>]
    [[-RemoteFolder] <string>] [-RemoteFile] <string>

BESCHREIBUNG #

Diese Funktion verbindet sich mit einem angegebenen SFTP-Server und gibt das Dateialter einer spezifischen Datei als Typ TimeSpan zurück. Die Authentifizierung unterstützt sichere Passwörter, Klartextpasswörter und gespeicherte Passwörter aus Dateien. Optional kann ein privater Schlüssel (Zertifikat) zur Authentifizierung angegeben werden.

PARAMETER #

-Server #

Type: string

Der Hostname oder die IP-Adresse des SFTP-Servers.

-Port #

Type: int
Default: 22

Optionaler Port für die Verbindung zum SFTP-Server (Standard: 22).

-Certificate #

Type: string

Optionaler Pfad zu einem privaten Schlüssel (Zertifikat) für eine schlüsselbasierte Authentifizierung.

-User #

Type: string

Benutzername für die Anmeldung am SFTP-Server.

-Password #

Type: securestring

Passwort als SecureString für die Anmeldung (ParameterSet: secure).

-PlainPassword #

Type: string

Passwort in Klartext für die Anmeldung (ParameterSet: plain).

-PasswordPath #

Type: string

Pfad zu einer Datei mit dem Passwort als SecureString oder Klartext (ParameterSet: file).

-RemoteFolder #

Type: string
Default: ""

Der Ordnerpfad auf dem SFTP-Server, in dem sich die Datei befindet. Standard ist ‘/’.

-RemoteFile #

Type: string

Name der Datei auf dem SFTP-Server, deren Alter ermittelt werden soll.

AUSGABEN #

nullable[TimeSpan]

Dateialter als TimeSpan-Objekt, oder $null wenn die Datei nicht gefunden wird oder ein Fehler auftritt.

BEISPIELE #

# Ermittelt das Alter der Datei 'invoice.pdf' im Hauptverzeichnis des SFTP-Servers.
Get-SftpFileAge -Server 'sftp.example.com' -User 'username' -PlainPassword 'myPassword' -RemoteFile 'invoice.pdf'

# Ermittelt das Alter der Datei 'report.csv' im Verzeichnis '/data', wobei das Passwort aus einer sicheren Datei geladen wird.
Get-SftpFileAge -Server 'sftp.example.com' -User 'username' -PasswordPath 'C:\Secure\pwd.xml' -RemoteFolder '/data' -RemoteFile 'report.csv'

HINWEISE #

Benötigt das Modul POSH-SSH. Installation: Install-Module -Name POSH-SSH -Repository PSGallery
Intern geöffnete SFTP-Sitzungen werden automatisch nach Beendigung dieser Funktion geschlossen.