New-SftpFolder #

ÜBERSICHT #

Erstellt ein neues Verzeichnis auf einem SFTP-Server.

SYNTAX #

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

BESCHREIBUNG #

Diese Funktion erstellt rekursiv ein angegebenes Verzeichnis inklusive der notwendigen Unterverzeichnisse auf einem SFTP-Server. Unterstützt werden verschiedene Methoden zur Authentifizierung: Klartext-Passwort, SecureString, Passwort-Datei und Zertifikat.

Falls das angegebene Verzeichnis bereits existiert, wird dies als Fehler angesehen. In diesem Fall wird eine Warnung ausgegeben und $false zurückgeliefert.

PARAMETER #

-Server #

Type: string

Hostname oder IP-Adresse des SFTP-Servers.

-Port #

Type: int
Default: 22

TCP-Port für die SFTP-Verbindung (Standard: 22).

-User #

Type: string

Benutzername zur Anmeldung am SFTP-Server.

-Password #

Type: securestring

Sicheres Passwort als SecureString (ParameterSet ‘secure’).

-PlainPassword #

Type: string

Passwort im Klartext (ParameterSet ‘plain’).

-PasswordPath #

Type: string

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

-RemoteFolder #

Type: string

Der vollständige Pfad des zu erstellenden Verzeichnisses auf dem SFTP-Server. Nicht vorhandene Unterverzeichnisse werden automatisch rekursiv angelegt. Falls der Ordner bereits existiert, wird dies als Fehler behandelt. Es wird eine Warnung ausgegeben und die Rückgabe von $false.

AUSGABEN #

bool

True bei Erfolg, False bei Fehler.

BEISPIELE #

# Erstellt das Verzeichnis '/uploads/daten' auf dem SFTP-Server mit Klartext-Passwort.
New-SftpFolder -Server "sftp.example.com" -User "user1" -PlainPassword "meinPasswort" -RemoteFolder "/uploads/daten"

# Erstellt das Verzeichnis '/uploads/daten' auf dem SFTP-Server mit einem sicheren Passwort.
$securePwd = ConvertTo-SecureString "meinPasswort" -AsPlainText -Force
New-SftpFolder -Server "sftp.example.com" -User "user1" -Password $securePwd -RemoteFolder "/uploads/daten"

# Erstellt das Verzeichnis '/uploads/daten' auf dem SFTP-Server mit zertifikatsbasierter Authentifizierung.
New-SftpFolder -Server "sftp.example.com" -User "user1" -Certificate "C:\Keys\privatekey.pem" -RemoteFolder "/uploads/daten"

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.