Get-SftpDir #

ÜBERSICHT #

Listet Dateien oder Verzeichnisse von einem SFTP-Server auf.

SYNTAX #

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

BESCHREIBUNG #

Die Funktion verbindet sich via SFTP mit einem Server und gibt eine sortierte Liste von Dateien oder Verzeichnissen im angegebenen Remote-Verzeichnis zurück. Die Authentifizierung erfolgt über Benutzername und Passwort (klartext oder SecureString) und optional mit Zertifikat. Das Ergebnis ist ein Array von Dateinamen oder Verzeichnisnamen, optional gefiltert durch eine Maske.

Unterstützt Passwort-Auth (secure/plain/file) und Key-Auth (OpenSSH-Key, kein PPK). Wenn -Certificate gesetzt ist, werden Password/PlainPassword/PasswordPath als Key-Passphrase interpretiert. Ohne -Certificate sind diese Werte das Login-Passwort.

PARAMETER #

-Server #

Type: string

Hostname oder IP-Adresse des SFTP-Servers.

-Port #

Type: int
Default: 22

Port des SFTP-Servers (Standard: 22).

-Certificate #

Type: string

Pfad zu einer Zertifikat-/Key-Datei zur Authentifizierung (optional).

-User #

Type: string

Benutzername zur Anmeldung.

-Password #

Type: securestring

Passwort als SecureString, für die Authentifizierung.

-PlainPassword #

Type: string

Klartext-Passwort (ParameterSet ‘plain’), wird intern in einen SecureString konvertiert.

-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.

-DirType #

Type: string
Default: 'file'

Gibt an, ob Dateien (file) oder Verzeichnisse (directory) gelistet werden sollen. Standard ist file.

-Mask #

Type: string
Default: '*'

Optionaler Wildcard-Filter (z.B.. *.log, *backup*), standardmäßig *.

-RemoteFolder #

Type: string
Default: ''

Pfad auf dem SFTP-Server, z.B.. /, /backup, /upload.

AUSGABEN #

string[]

BEISPIELE #

# Gibt alle Verzeichnisse im Root-Ordner `/` zurück.
Get-SftpDir -Server 'sftp.example.com' -User 'admin' -PlainPassword 'secret' -RemoteFolder '/' -DirType 'directory'

# Gibt alle `.log`-Dateien im Verzeichnis `/log` zurück.
Get-SftpDir -Server 'sftp.example.com' -User 'admin' -Password $securePwd -RemoteFolder '/log' -Mask '*.log'

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.