Test Sftp Folder
Zuletzt geändert: 14.03.2026 05:56

Test-SftpFolder #

ÜBERSICHT #

Prüft, ob ein Verzeichnis auf einem SFTP-Server existiert.

SYNTAX #

Test-SftpFolder [-Server] <string> [[-Port] <int>] [[-Certificate] <string>] [-User] <string>
    [[-Password] <securestring>] [[-PlainPassword] <string>] [[-PasswordPath] <string>]
    [[-RemoteFolder] <string>] [<CommonParameters>]

BESCHREIBUNG #

Überprüft, ob ein bestimmtes Verzeichnis auf einem SFTP-Server vorhanden ist. Unterstützt Authentifizierung per Passwort (Klartext oder SecureString) oder mittels privater Schlüsseldatei (Zertifikat).

PARAMETER #

-Server #

Type: string

Adresse oder Hostname des SFTP-Servers.

-Port #

Type: int
Default: 22

TCP-Port zur SFTP-Verbindung (Standard: 22).

-Certificate #

Type: string

Optionaler Pfad zur privaten Schlüsseldatei (*.pem).

-User #

Type: string

Benutzername am SFTP-Server.

-Password #

Type: securestring

SecureString-Passwort (ParameterSet ‘secure’).

-PlainPassword #

Type: string

Klartext-Passwort (ParameterSet ‘plain’).

-PasswordPath #

Type: string

Pfad zu einer Passwort-Datei (ParameterSet ‘file’).

-RemoteFolder #

Type: string
Default: ""

Das zu prüfende Verzeichnis auf dem SFTP-Server.

AUSGABEN #

bool

Gibt $true zurück, wenn das Verzeichnis existiert, sonst $false.

BEISPIELE #

# Prüft, ob das Verzeichnis '/upload' vorhanden ist.
Test-SftpFolder -Server "sftp.example.com" -User "user1" -PlainPassword "meinPasswort" -RemoteFolder "/upload"

# Prüft mit SecureString, ob das Verzeichnis '/daten' existiert.
$secPwd = ConvertTo-SecureString "meinPasswort" -AsPlainText -Force
Test-SftpFolder -Server "sftp.example.com" -User "user1" -Password $secPwd -RemoteFolder "/daten"

# Prüft mit Zertifikat, ob das Home-Verzeichnis des Benutzers existiert.
Test-SftpFolder -Server "sftp.example.com" -User "user1" -Certificate "C:\Keys\key.pem" -RemoteFolder ""

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.