Get-SftpNewestFilename #

ÜBERSICHT #

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

SYNTAX #

Get-SftpNewestFilename [-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 neuesten 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 neuesten 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-SftpNewestFilename -Server 'example.com' -User 'testuser' -PasswordPath 'sftp'

# Passwort aus verschlüsselter Datei
Get-SftpNewestFilename -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.