Test-SftpFolder

EulandaXtools — Funktionsreferenz

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

VERWANDTE LINKS

Get-SftpDir

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

HINWEISE