Get-SftpDirDetailed #

ÜBERSICHT #

Gibt detaillierte Informationen zu Dateien und Verzeichnissen eines SFTP-Servers zurück.

SYNTAX #

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

BESCHREIBUNG #

Die Funktion verbindet sich via SFTP mit einem Server und liefert ein Array von Hashtables, die detaillierte Informationen (Typ, FullName, Name, Datum und Größe) zu Dateien und/oder Verzeichnissen im angegebenen Remote-Verzeichnis enthalten. Die Authentifizierung erfolgt über Benutzername und Passwort (Klartext, SecureString oder aus Datei) und optional mit Zertifikat.

Im Gegensatz zu Get-SftpDir liefert diese Funktion strukturierte Informationen zu jedem Element, sodass nachfolgende Skripte leichter auf Attribute wie Änderungsdatum oder Größe zugreifen können.

Die Rückgabe erfolgt immer als Array, selbst wenn keine Ergebnisse vorhanden sind. Lediglich im Falle eines Fehlers wird $null zurückgeliefert.

AUSGABEN #

hashtable[], void

BEISPIELE #

# Gibt alle Dateien und Verzeichnisse im Root-Ordner `/` detailliert zurück.
Get-SftpDirDetailed -Server 'sftp.example.com' -User 'admin' -PlainPassword 'secret' -RemoteFolder '/'

# Gibt detaillierte Informationen zu allen `.log`-Dateien im Verzeichnis `/logs`.
Get-SftpDirDetailed -Server 'sftp.example.com' -User 'admin' -Password $securePwd -RemoteFolder '/logs' -Mask '*.log' -DirType 'file'

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.