Get-SftpOldestFilename

ÜBERSICHT

Ermittelt den Namen der ältesten Datei auf einem SFTP-Server, optional gefiltert nach Dateimaske. Unterstützt Passwörter als Klartext, SecureString oder aus einer Datei.

SYNTAX

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

BESCHREIBUNG

Diese Funktion verbindet sich mit einem SFTP-Server und gibt den Namen der ältesten Datei im angegebenen Remote-Ordner zurück. Dabei kann eine Dateimaske zur Einschränkung der Ergebnisse angegeben werden. Die Verbindung erfolgt über das Modul `POSH-SSH`. Die Authentifizierung ist mit SecureString-Passwort, Klartext-Passwort oder aus einer Datei möglich. Die Passwortdatei darf entweder Klartext enthalten oder ein mit `ConvertFrom-SecureString` erstelltes, verschlüsseltes Passwort im XML-Format.

PARAMETER

-Server

Type: string

Hostname oder IP-Adresse des SFTP-Servers.

-Port

Type: int
Default: 22

Portnummer des SFTP-Servers; Standard ist Port 22.

-Certificate

Type: string

Optionaler Pfad zu einer Zertifikatdatei zur Authentifizierung.

-User

Type: string

Benutzername für den Zugriff auf den SFTP-Server.

-Password

Type: securestring

Passwort als SecureString, für die Authentifizierung.

-PlainPassword

Type: string

Klartext-Passwort, wird intern in SecureString umgewandelt.

-PasswordPath

Type: string

Pfad zu einer Datei, die das Passwort enthält (Klartext oder verschlüsselt im XML-Format). Wird kein Pfad angegeben, sucht das Skript automatisch unter `C:\Users\cn\.eulandaconnect`.

-Mask

Type: string
Default: '*'

Optionale Dateimaske zum Filtern der Dateien (Standard: '*').

-RemoteFolder

Type: string
Default: ""

Pfad zum Remote-Ordner auf dem SFTP-Server (Standard: '/').

AUSGABEN

string, void

Der Dateiname der ältesten Datei, die auf dem SFTP-Server gefunden wurde. Wird keine Datei gefunden, oder gibt es einen Fehler, wird $null geliefert. Über `-ErrorAction SilentlyContinue` kann eine Exception-Ausgabe unterdrückt werden.

BEISPIELE

# Passwort aus Klartext-Datei
Get-SftpOldestFilename -Server 'example.com' -User 'testuser' -PasswordPath 'sftp'

# Passwort aus verschlüsselter Datei
Get-SftpOldestFilename -Server 'example.com' -User 'testuser' -PasswordPath 'C:\Secrets\plainPassword.xml'

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.

Get-SftpOldestFilename