New-SftpFolder

EulandaXtools — Funktionsreferenz

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"

VERWANDTE LINKS

Get-SftpDir

Get-SftpFileAge

Get-SftpFileDate

Get-SftpFileSize

Get-SftpOldestFilename

Receive-SftpFile

Remove-SftpFile

Remove-SftpFolder

Rename-SftpFileX

Rename-SftpFolder

Send-SftpFile

Test-SftpFile

Test-SftpFingerprint

Test-SftpFolder

Test-SftpPort

HINWEISE