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'

VERWANDTE LINKS

Get-SftpFileAge

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.