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'

VERWANDTE LINKS

Get-SftpDir

Get-SftpFileDate

Get-SftpFileSize

Get-SftpOldestFilename

New-SftpFolder

Receive-SftpFile

Remove-SftpFile

Remove-SftpFolder

Rename-SftpFileX

Rename-SftpFolder

Send-SftpFile

Test-SftpFile

Test-SftpFingerprint

Test-SftpFolder

Test-SftpPort

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.