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

Test-SftpFile #

ÜBERSICHT #

Prüft, ob eine Datei auf einem SFTP-Server vorhanden ist.

SYNTAX #

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

BESCHREIBUNG #

Diese Funktion überprüft, ob eine spezifische Datei in einem angegebenen Verzeichnis auf einem SFTP-Server existiert. Unterstützt Klartext- und SecureString-Passwort sowie zertifikatsbasierte Authentifizierung.

Gibt einen booleschen Wert zurück, der angibt, ob die Datei vorhanden ist.

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

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: ""

Verzeichnis auf dem SFTP-Server (Standard: Home-Verzeichnis).

-RemoteFile #

Type: string

Zu prüfender Dateiname.

AUSGABEN #

bool

True, wenn die Datei existiert, sonst False.

BEISPIELE #

# Prüft ob die Datei 'daten.csv' im Stammverzeichnis vorhanden ist.
Test-SftpFile -Server "sftp.example.com" -User "user1" -PlainPassword "meinPasswort" -RemoteFile "daten.csv"

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.