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

Rename-SftpFolder #

ÜBERSICHT #

Benennt ein Verzeichnis auf einem SFTP-Server um oder verschiebt es.

SYNTAX #

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

BESCHREIBUNG #

Benennt ein existierendes Verzeichnis auf einem SFTP-Server um oder verschiebt es an einen neuen Pfad.

Folgende Prüfungen erfolgen automatisch:

  • Existenzprüfung des Quellverzeichnisses
  • Prüfung, ob das Zielverzeichnis bereits existiert (Ziel darf noch nicht vorhanden sein)
  • Verzeichnisse dürfen nicht leer sein oder das Root-Verzeichnis (’/’) betreffen.

Die Funktion unterstützt Authentifizierungen per Klartext-Passwort, SecureString, Passwort-Datei oder Zertifikat (Privatschlüssel).

PARAMETER #

-Server #

Type: string

Adresse oder Hostname des SFTP-Servers.

-Port #

Type: int
Default: 22

TCP-Port des SFTP-Servers (Standard: 22).

-Certificate #

Type: string

Optionaler Pfad zur Privatschlüsseldatei für zertifikatsbasierte Authentifizierung.

-User #

Type: string

Benutzername zur Authentifizierung.

-Password #

Type: securestring

Passwort als SecureString (ParameterSet ‘secure’).

-PlainPassword #

Type: string

Passwort im Klartext (ParameterSet ‘plain’).

-PasswordPath #

Type: string

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

-RemoteFolder #

Type: string
Default: ""

Quellverzeichnis auf dem SFTP-Server, das umbenannt oder verschoben werden soll.

-NewFolder #

Type: string

Zielverzeichnisname oder neuer Name. Darf noch nicht existieren.

AUSGABEN #

bool

True bei erfolgreicher Ausführung, andernfalls False.

BEISPIELE #

# Verzeichnis '/alt' nach '/neu' umbenennen
Rename-SftpFolder -Server "sftp.example.com" -User "user1" -PlainPassword "meinPasswort" `
  -RemoteFolder "/alt" -NewFolder "/neu"

# Verzeichnis '/daten' in Unterverzeichnis '/archiv/daten2025' verschieben
$secPwd = ConvertTo-SecureString "meinPasswort" -AsPlainText -Force
Rename-SftpFolder -Server "sftp.example.com" -User "user1" -Password $secPwd `
  -RemoteFolder "/daten" -NewFolder "/archiv/daten2025"

# Verzeichnis im Homeverzeichnis umbenennen (kein Slash erforderlich)
Rename-SftpFolder -Server "sftp.example.com" -User "user1" -Certificate "C:\key.pem" `
  -RemoteFolder "alteDaten" -NewFolder "neueDaten"

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.